feat(exporter): Prisma ORM exporter 추가 (PR #151 이어받음)

.changepacks/changepack_log_vKVGmtRxkfW3nE7rIhMcz.json

@@ -0,0 +1 @@
+{"changes":{"crates/vespertide-naming/Cargo.toml":"Minor","crates/vespertide-exporter/Cargo.toml":"Minor","crates/vespertide-cli/Cargo.toml":"Minor"},"note":"Prisma ORM exporter 추가","date":"2026-07-09T14:25:30.6412773Z"}

AGENTS.md

@@ -18,7 +18,7 @@ vespertide/
 │   ├── vespertide-planner/   # Schema diffing, baseline reconstruction, validation
 │   ├── vespertide-query/     # SQL generation (Postgres/MySQL/SQLite)
 │   ├── vespertide-cli/       # CLI commands: init, diff, sql, revision, export
-│   ├── vespertide-exporter/  # ORM codegen: SeaORM, SQLAlchemy, SQLModel
+│   ├── vespertide-exporter/  # ORM codegen: SeaORM, SQLAlchemy, SQLModel, JPA, Prisma
 │   ├── vespertide-loader/    # Filesystem loading of models/migrations
 │   ├── vespertide-config/    # vespertide.json configuration
 │   ├── vespertide-lsp/       # Language server: 13 LSP capabilities + HS-7~11 caching
@@ -47,7 +47,7 @@ vespertide/
 | Schema diffing | `vespertide-planner/src/diff/` | topological sort for FK deps |
 | SQL generation | `vespertide-query/src/sql/` | One file per action type |
 | CLI commands | `vespertide-cli/src/commands/` | `cmd_*` functions |
-| ORM export | `vespertide-exporter/src/{seaorm,sqlalchemy,sqlmodel,jpa}/` | Backend-specific generators |
+| ORM export | `vespertide-exporter/src/{seaorm,sqlalchemy,sqlmodel,jpa,prisma}/` | Backend-specific generators |
 | Compile-time macro | `vespertide-macro/src/lib.rs` | `vespertide_migration!` proc macro |
 | **LSP RingCache (HS-7~11)** | `vespertide-lsp/src/cache.rs` | Generic ring-buffer LRU shared across symbols/diagnostics/drift/semantic-token caches |
 | **LSP drift cache** | `vespertide-lsp/src/drift/cache.rs` | HS-10 drift cache implementation |
@@ -169,7 +169,7 @@ See `docs/clippy-allow-audit.md` for the full audit history.
 | `QueryError::Other(...)` in new code | Emits deprecation warning. Use `SchemaError` / `InvalidColumnType` / `BackendError` / `UnsupportedAction` |
 | Exhaustive struct literal for `MigrationOptions` / `VespertideConfig` | `#[non_exhaustive]` — use `..Default::default()` |
 | Comparing newtype with `String::eq(&name.to_string(), "user")` | `TableName: PartialEq<&str>` — use `name == "user"` directly |
-| Per-ORM exporter snapshot test (single ORM) | Use the 4-ORM `orm_cases!` macro; snapshots must cross-compare all ORMs |
+| Per-ORM exporter snapshot test (single ORM) | Use the 5-ORM `orm_cases!` macro; snapshots must cross-compare all ORMs |
 
 ## COMMANDS
 
@@ -368,12 +368,14 @@ fn create_table_snapshot(#[case] backend: DatabaseBackend) {
 }
 ```
 
-This is the same pattern used by `vespertide-query` (3 backends, 357 snapshots) and `vespertide-exporter` (4 ORMs via `Orm` enum, 232 cross-ORM snapshots). When adding a new backend / ORM / format, the change is **one `#[case::name(Value)]` line**.
+This is the same pattern used by `vespertide-query` (3 backends, 357 snapshots) and `vespertide-exporter` (5 ORMs via `Orm` enum, 335 cross-ORM snapshots). When adding a new backend / ORM / format, the change is **one `#[case::name(Value)]` line**.
 
 ### Exporter snapshots MUST cover ALL ORMs (no per-ORM snapshots)
-Every `vespertide-exporter` snapshot test MUST be written through the shared `orm_cases!` rstest macro in `crates/vespertide-exporter/src/tests/mod.rs`, which renders each fixture for **all four ORMs** (`Orm::SeaOrm`, `Orm::SqlAlchemy`, `Orm::SqlModel`, `Orm::Jpa`). A new export scenario = ONE fixture + ONE `orm_cases!(...)` line, producing exactly four snapshots (one per ORM) in the single shared `crates/vespertide-exporter/src/tests/snapshots/` directory.
+Every `vespertide-exporter` snapshot test MUST be written through the shared `orm_cases!` rstest macro in `crates/vespertide-exporter/src/tests/mod.rs`, which renders each fixture for **all five ORMs** (`Orm::SeaOrm`, `Orm::SqlAlchemy`, `Orm::SqlModel`, `Orm::Jpa`, `Orm::Prisma`). A new export scenario = ONE fixture + ONE `orm_cases!(...)` line, producing exactly five snapshots (one per ORM) in the single shared `crates/vespertide-exporter/src/tests/snapshots/` directory.
 
-FORBIDDEN: per-ORM `#[test]` snapshot functions inside `src/seaorm/`, `src/sqlalchemy/`, `src/sqlmodel/`, `src/jpa/`, or any `snapshots/` directory other than `src/tests/snapshots/`. A scenario snapshotted for only one ORM is a defect — ORM output must always be cross-compared across all four. When adding a new ORM the change is a single `#[case::<orm>(Orm::<Variant>)]` line in the macro, never a new per-ORM test.
+FORBIDDEN: per-ORM `#[test]` snapshot functions inside `src/seaorm/`, `src/sqlalchemy/`, `src/sqlmodel/`, `src/jpa/`, `src/prisma/`, or any `snapshots/` directory other than `src/tests/snapshots/`. A scenario snapshotted for only one ORM is a defect — ORM output must always be cross-compared across all five. When adding a new ORM the change is a single `#[case::<orm>(Orm::<Variant>)]` line in the macro, never a new per-ORM test.
+
+Exception: an entry point that exists in only one backend (e.g. Prisma's single-file `render_schema`, which deduplicates enums globally) is not a cross-ORM scenario, so its snapshot tests live as inline tests of that module — with the snapshot files still written to the shared `src/tests/snapshots/` via `with_settings!(snapshot_path => ...)`.
 
 ### `#[cfg(test)]` test-oracle pattern
 When a function exists solely as an oracle for a regression test (e.g. comparing

README.md

@@ -16,7 +16,7 @@ Declarative database schema management. Define your schemas in JSON, and Vespert
 - **Enum Types**: Native string enums and integer enums (no migration needed for new values)
 - **Zero-Runtime Migrations**: Compile-time macro generates database-specific SQL
 - **JSON Schema Validation**: Ships with JSON Schemas for IDE autocompletion and validation
-- **ORM Export**: Export schemas to SeaORM, SQLAlchemy, SQLModel
+- **ORM Export**: Export schemas to SeaORM, SQLAlchemy, SQLModel, JPA, Prisma
 - **Language Server**: First-class editor support via the bundled `vespertide-lsp` — see [LSP Features](#lsp-features) below
 
 ## What's new in 0.2.0

crates/vespertide-cli/Cargo.toml

@@ -30,6 +30,7 @@ dot-writer = "0.1.4"
 vespertide-config = { workspace = true, features = ["cli", "schema"] }
 vespertide-core = { workspace = true, features = ["schema"] }
 vespertide-loader = { workspace = true }
+vespertide-naming = { workspace = true }
 vespertide-planner = { workspace = true }
 vespertide-query = { workspace = true }
 vespertide-exporter = { workspace = true }

crates/vespertide-cli/src/commands/erd/dot.rs

@@ -1,9 +1,8 @@
 use dot_writer::{Attributes, DotWriter, RankDirection, Shape};
 use vespertide_core::{ColumnDef, TableDef};
+use vespertide_naming::{IdentifierStart, sanitize_identifier};
 
-use super::{
-    ForeignKeyRelation, collect_foreign_key_relations, column_markers, sanitize_identifier,
-};
+use super::{ForeignKeyRelation, collect_foreign_key_relations, column_markers};
 
 pub fn render_dot(tables: &[TableDef]) -> String {
     DotWriter::write_string(|writer| {
@@ -25,16 +24,19 @@ pub fn render_dot(tables: &[TableDef]) -> String {
         }
 
         for table in tables {
-            let mut node = digraph.node_named(sanitize_identifier(&table.name));
+            let mut node = digraph.node_named(sanitize_identifier(
+                &table.name,
+                IdentifierStart::Underscore,
+            ));
             node.set_shape(Shape::Record);
             node.set_label(&record_label(table));
         }
 
         for relation in collect_foreign_key_relations(tables) {
             let mut edge_attributes = digraph
                 .edge(
-                    sanitize_identifier(&relation.child_table),
-                    sanitize_identifier(&relation.parent_table),
+                    sanitize_identifier(&relation.child_table, IdentifierStart::Underscore),
+                    sanitize_identifier(&relation.parent_table, IdentifierStart::Underscore),
                 )
                 .attributes();
             edge_attributes.set_label(&relationship_label(&relation));

crates/vespertide-cli/src/commands/erd/mermaid.rs

@@ -1,18 +1,23 @@
 use std::fmt::Write as _;
 
 use vespertide_core::{ColumnType, ComplexColumnType, EnumValues, SimpleColumnType, TableDef};
+use vespertide_naming::{IdentifierStart, sanitize_identifier};
 
 use super::{
     Cardinality, ForeignKeyRelation, collect_foreign_key_relations, is_foreign_key_column,
-    is_primary_key_column, sanitize_identifier,
+    is_primary_key_column,
 };
 
 pub fn render_mermaid(tables: &[TableDef]) -> String {
     let mut output = String::from("erDiagram\n");
 
     for table in tables {
-        writeln!(output, "  {} {{", sanitize_identifier(&table.name))
-            .expect("write Mermaid table header");
+        writeln!(
+            output,
+            "  {} {{",
+            sanitize_identifier(&table.name, IdentifierStart::Underscore)
+        )
+        .expect("write Mermaid table header");
 
         for column in &table.columns {
             let primary_key = if is_primary_key_column(table, &column.name) {
@@ -30,7 +35,7 @@ pub fn render_mermaid(tables: &[TableDef]) -> String {
                 output,
                 "    {} {}{}{}",
                 column_type_to_mermaid(&column.r#type),
-                sanitize_identifier(&column.name),
+                sanitize_identifier(&column.name, IdentifierStart::Underscore),
                 primary_key,
                 foreign_key
             )
@@ -45,9 +50,9 @@ pub fn render_mermaid(tables: &[TableDef]) -> String {
         writeln!(
             output,
             "  {} {} {} : \"{}\"",
-            sanitize_identifier(left_table),
+            sanitize_identifier(left_table, IdentifierStart::Underscore),
             connector,
-            sanitize_identifier(right_table),
+            sanitize_identifier(right_table, IdentifierStart::Underscore),
             escape_mermaid_label(&relation.child_columns.join(", "))
         )
         .expect("write Mermaid relationship");

crates/vespertide-cli/src/commands/erd/mod.rs

@@ -262,27 +262,6 @@ pub(super) fn column_markers(table: &TableDef, column: &ColumnDef) -> String {
     }
 }
 
-pub(super) fn sanitize_identifier(input: &str) -> String {
-    let mut identifier = String::new();
-
-    for (index, ch) in input.chars().enumerate() {
-        if ch == '_' || ch.is_ascii_alphanumeric() {
-            if index == 0 && ch.is_ascii_digit() {
-                identifier.push('_');
-            }
-            identifier.push(ch);
-        } else {
-            identifier.push('_');
-        }
-    }
-
-    if identifier.is_empty() {
-        "_".to_string()
-    } else {
-        identifier
-    }
-}
-
 fn inline_foreign_key_relation(
     table: &TableDef,
     column: &ColumnDef,

crates/vespertide-cli/src/commands/erd/tests/mod.rs

@@ -539,28 +539,6 @@ fn svg_cardinality_labels(schema: &[TableDef]) -> String {
         .join("\n")
 }
 
-// === sanitize_identifier edge cases ===
-
-#[test]
-fn sanitize_identifier_digit_first_prefixes_underscore() {
-    assert_eq!(sanitize_identifier("9lives"), "_9lives");
-}
-
-#[test]
-fn sanitize_identifier_empty_returns_underscore() {
-    assert_eq!(sanitize_identifier(""), "_");
-}
-
-#[test]
-fn sanitize_identifier_non_ascii_becomes_underscore() {
-    assert_eq!(sanitize_identifier("a b-c.d"), "a_b_c_d");
-}
-
-#[test]
-fn sanitize_identifier_preserves_underscores_and_alphanumerics() {
-    assert_eq!(sanitize_identifier("table_99_ok"), "table_99_ok");
-}
-
 // === parallel FK edges between same (child, parent) pair ===
 
 #[test]
@@ -664,6 +642,24 @@ fn malformed_inline_fk_reference_is_ignored() {
     assert!(collect_foreign_key_relations(&[users, bad]).is_empty());
 }
 
+#[test]
+fn table_level_fk_to_missing_table_is_ignored() {
+    let mut orphan = table(
+        "orphan",
+        vec![primary_key("id", integer()), column("ghost_id", integer())],
+    );
+    orphan.constraints.push(TableConstraint::ForeignKey {
+        name: Some("fk_orphan_ghost".into()),
+        columns: vec!["ghost_id".into()],
+        ref_table: "ghost".into(),
+        ref_columns: vec!["id".into()],
+        on_delete: None,
+        on_update: None,
+        orphan_strategy: Default::default(),
+    });
+    assert!(collect_foreign_key_relations(&[orphan]).is_empty());
+}
+
 #[test]
 fn inline_unique_group_variants_drive_one_to_one_detection() {
     let users = normalize(&table("users", vec![primary_key("id", integer())]));