Update AI content. (#93) (#104)

Author: zantvoort

docs/ai.md

@@ -65,6 +65,8 @@ For each selected tool, Storm installs two types of AI context:
 | storm-query-java | Java QueryBuilder queries |
 | storm-sql-kotlin | Kotlin SQL Templates |
 | storm-sql-java | Java SQL Templates |
+| storm-json-kotlin / storm-json-java | JSON columns and JSON aggregation |
+| storm-serialization-kotlin / storm-serialization-java | Entity serialization for REST APIs (Ref handling) |
 | storm-migration | Write Flyway/Liquibase migration SQL |
 
 ### 3. Database connection (optional)
@@ -352,4 +354,4 @@ The verify-then-trust pattern closes that gap:
 3. **The AI runs the test.** If it passes, the code is correct by construction, verified by the same validation logic that Storm uses internally. If it fails, the error messages tell the AI exactly what to fix.
 4. **The test stays or goes.** Keep it as a regression test, or let the AI remove it once verified. Either way, the verification happened.
 
-No other ORM framework offers this combination: an AI-friendly data model that produces stable code, a schema-aware MCP server that gives the AI structural knowledge without exposing data, and built-in test tooling that lets the AI verify its own work through the framework rather than around it.
+This is the combination that makes it work: an AI-friendly data model that produces stable code, a schema-aware MCP server that gives the AI structural knowledge without exposing data, and built-in test tooling that lets the AI verify its own work through the framework rather than around it.

website/static/skills/index-java.json

@@ -6,6 +6,8 @@
     "storm-repository-java",
     "storm-query-java",
     "storm-sql-java",
+    "storm-json-java",
+    "storm-serialization-java",
     "storm-migration"
   ],
   "schemaSkills": [

website/static/skills/index-kotlin.json

@@ -6,6 +6,8 @@
     "storm-repository-kotlin",
     "storm-query-kotlin",
     "storm-sql-kotlin",
+    "storm-json-kotlin",
+    "storm-serialization-kotlin",
     "storm-migration"
   ],
   "schemaSkills": [

website/static/skills/storm-entity-from-schema.md

@@ -31,6 +31,8 @@ Generation/update rules:
 SQL type mapping (Kotlin): INTEGER->Int, BIGINT->Long, VARCHAR/TEXT->String, BOOLEAN->Boolean, DECIMAL->BigDecimal, DATE->LocalDate, TIMESTAMP->Instant, UUID->UUID
 SQL type mapping (Java): INTEGER->Integer(PK)/int, BIGINT->Long(PK)/long, VARCHAR/TEXT->String, BOOLEAN->Boolean/boolean, DECIMAL->BigDecimal, DATE->LocalDate, TIMESTAMP->Instant, UUID->UUID
 
+JSON column recognition: columns typed as JSONB (PostgreSQL), JSON (MySQL, MariaDB, Oracle), NVARCHAR(MAX) with JSON content (MS SQL Server), or CLOB with JSON content (H2) should be mapped with `@Json`. Ask the user what the JSON structure represents so you can choose the correct field type (e.g., `Map<String, String>`, a custom data class, or `List<T>`).
+
 After changes: review types, rebuild for metamodel regeneration.
 
 When appropriate, suggest a Flyway/Liquibase migration if the schema change originated from the code side rather than the database side.

website/static/skills/storm-migration.md

@@ -18,13 +18,24 @@ PK generation mapping:
 | SEQUENCE | CREATE SEQUENCE | N/A | CREATE SEQUENCE |
 | NONE | No generation | No generation | No generation |
 
+JSON column types per dialect:
+| Database | Column Type |
+|----------|-------------|
+| PostgreSQL | `JSONB` |
+| MySQL | `JSON` |
+| MariaDB | `JSON` |
+| Oracle | `JSON` |
+| MS SQL Server | `NVARCHAR(MAX)` |
+| H2 | `CLOB` |
+
 Tips:
 - FK constraints matching @FK annotations
 - UNIQUE constraints for @UK fields
 - Indexes on FK columns and frequent queries
 - NOT NULL matching entity nullability
 - Enums as strings: VARCHAR. Ordinal: INTEGER.
 - @Version: INTEGER or TIMESTAMP
+- `@Json` fields: use the correct JSON column type for the target database (see table above)
 
 After writing a migration, rebuild the project for metamodel regeneration.
 

website/static/skills/storm-rules.md

@@ -16,6 +16,8 @@ Available Storm skills:
 - /storm-repository-kotlin or /storm-repository-java - Write repositories
 - /storm-query-kotlin or /storm-query-java - Write queries with the QueryBuilder
 - /storm-sql-kotlin or /storm-sql-java - Write SQL Templates
+- /storm-json-kotlin or /storm-json-java - JSON columns and JSON aggregation
+- /storm-serialization-kotlin or /storm-serialization-java - Entity serialization for REST APIs
 - /storm-migration - Write Flyway/Liquibase migration SQL
 
 When the user asks about Storm topics, suggest the relevant skill if they need detailed guidance.