maestro-bundle 1.3.1 → 1.4.0

package/templates/bundle-jhipster-monorepo/skills/jhipster-entities/SKILL.md

@@ -1,49 +1,49 @@
 ---
 name: jhipster-entities
-description: Criar e gerenciar entidades JHipster com JDL, relationships, enums, validações e geração de código. Use quando precisar criar entidades, definir modelo de dados, ou gerar código com JHipster.
+description: Create and manage JHipster entities with JDL, relationships, enums, validations, and code generation. Use when creating entities, defining data models, generating CRUD, or writing JDL files.
+version: 1.0.0
+author: Maestro
 ---
 
 # JHipster Entities
 
-## Fluxo
+Create and manage JHipster entities using JDL (JHipster Domain Language) with relationships, validations, and DDD enrichment.
 
-```
-1. Definir entidade no JDL
-2. Rodar jhipster import-jdl
-3. Enriquecer entidade gerada com comportamento DDD
-4. Ajustar Liquibase changeset se necessário
-5. Criar/ajustar testes
-```
+## When to Use
+- When creating new entities or data models
+- When defining relationships between entities
+- When generating CRUD code from JDL
+- When enriching generated entities with business behavior (DDD)
+- When updating existing entity definitions
 
-## JDL — Sintaxe
+## Available Operations
+1. Define entities in JDL with types and validations
+2. Define relationships (OneToMany, ManyToMany, OneToOne)
+3. Generate code with `jhipster import-jdl`
+4. Enrich generated entities with domain behavior
+5. Create/update enums
 
-```jdl
-entity NomeDaEntidade {
-    campo TipoDoCampo validacao
-}
-```
+## Multi-Step Workflow
+
+### Step 1: Define Entity in JDL
+Create or edit the JDL file with entity definitions.
 
-### Tipos disponíveis
-| Tipo JDL | Java | DB |
+Available types:
+| JDL Type | Java Type | DB Column |
 |---|---|---|
 | String | String | varchar(255) |
 | Integer | Integer | integer |
 | Long | Long | bigint |
-| Float | Float | float |
-| Double | Double | double |
 | BigDecimal | BigDecimal | decimal |
 | Boolean | Boolean | boolean |
 | LocalDate | LocalDate | date |
 | Instant | Instant | timestamp |
 | ZonedDateTime | ZonedDateTime | timestamp |
-| Duration | Duration | bigint |
 | UUID | UUID | uuid |
-| Blob | byte[] | blob |
-| AnyBlob | byte[] | blob |
-| ImageBlob | byte[] | blob |
+| Blob/AnyBlob/ImageBlob | byte[] | blob |
 | TextBlob | String | clob |
 
-### Validações
+Example with validations:
 ```jdl
 entity Product {
     name String required minlength(3) maxlength(100)
@@ -54,7 +54,7 @@ entity Product {
 }
 ```
 
-### Relationships
+### Step 2: Define Relationships
 ```jdl
 relationship OneToMany {
     Department{employees} to Employee{department(name) required}
@@ -69,7 +69,7 @@ relationship OneToOne {
 }
 ```
 
-### Enums
+### Step 3: Define Enums
 ```jdl
 enum Status {
     ACTIVE("Ativo"),
@@ -78,26 +78,31 @@ enum Status {
 }
 ```
 
-## Gerar código
+### Step 4: Generate Code
 
 ```bash
-# Gerar a partir do JDL
+# Generate from JDL (recommended)
 jhipster import-jdl jhipster-jdl.jdl
 
-# Gerar entidade individual
+# Generate individual entity interactively
 jhipster entity Demand
-```
 
-## Enriquecer com DDD
+# Verify generated files
+ls src/main/java/com/myapp/domain/
+ls src/main/java/com/myapp/web/rest/
+ls src/main/java/com/myapp/repository/
+ls src/main/resources/config/liquibase/changelog/
+```
 
-Após gerar, adicionar comportamento à entidade:
+### Step 5: Enrich with DDD Behavior
+After generation, add rich domain behavior to the entity:
 
 ```java
 @Entity
 @Table(name = "demand")
 public class Demand implements Serializable {
 
-    // Campos gerados pelo JHipster (manter)
+    // Generated fields (keep as-is)
     @Id
     @GeneratedValue(strategy = GenerationType.SEQUENCE)
     private Long id;
@@ -113,10 +118,10 @@ public class Demand implements Serializable {
     @OneToMany(mappedBy = "demand", cascade = CascadeType.ALL, orphanRemoval = true)
     private List<Task> tasks = new ArrayList<>();
 
-    // ADICIONAR — comportamento rico
+    // ADD -- rich behavior
     public void addTask(Task task) {
         if (this.tasks.size() >= 20) {
-            throw new BusinessException("Máximo 20 tasks por demanda");
+            throw new BusinessException("Maximo 20 tasks por demanda");
         }
         this.tasks.add(task);
         task.setDemand(this);
@@ -133,9 +138,57 @@ public class Demand implements Serializable {
 
     public void complete() {
         if (!isCompletable()) {
-            throw new BusinessException("Nem todas as tasks foram concluídas");
+            throw new BusinessException("Nem todas as tasks foram concluidas");
         }
         this.status = DemandStatus.COMPLETED;
     }
 }
 ```
+
+### Step 6: Adjust Liquibase and Tests
+
+```bash
+# Verify generated changelog
+cat src/main/resources/config/liquibase/changelog/*_added_entity_*.xml
+
+# Run tests to verify generation
+./mvnw test -Dtest="*DemandResourceIT"
+
+# Run the app to verify
+./mvnw spring-boot:run
+```
+
+## Resources
+- `references/jdl-types.md` - Complete JDL type reference and validation options
+
+## Examples
+### Example 1: Create a New Entity
+User asks: "Create a Product entity with name, price, and SKU"
+Response approach:
+1. Write JDL definition with proper types and validations
+2. Run `jhipster import-jdl jhipster-jdl.jdl`
+3. Verify generated files in domain/, repository/, web/rest/
+4. Add any domain behavior needed
+5. Run `./mvnw test` to verify
+
+### Example 2: Add Relationship Between Entities
+User asks: "A Department has many Employees"
+Response approach:
+1. Add `relationship OneToMany { Department{employees} to Employee{department required} }` to JDL
+2. Regenerate with `jhipster import-jdl jhipster-jdl.jdl`
+3. Check generated foreign keys in Liquibase changelog
+4. Run `./mvnw test`
+
+### Example 3: Enrich Entity with Business Rules
+User asks: "Add a rule that a demand cannot have more than 20 tasks"
+Response approach:
+1. Open the Demand entity class
+2. Add `addTask()` method with the invariant check
+3. Add corresponding unit test
+4. Run `./mvnw test`
+
+## Notes
+- Always run `jhipster import-jdl` to regenerate after JDL changes
+- Mark custom code clearly to preserve during regeneration
+- Liquibase changelogs are auto-generated -- review before running
+- Use `references/jdl-types.md` for the complete type reference

package/templates/bundle-jhipster-monorepo/skills/jhipster-entities/references/jdl-types.md

@@ -0,0 +1,56 @@
+# JDL Types Reference
+
+## Field Types
+| JDL Type | Java | DB | Notes |
+|---|---|---|---|
+| String | String | varchar(255) | Default max 255 |
+| Integer | Integer | integer | 32-bit |
+| Long | Long | bigint | 64-bit |
+| Float | Float | float | Single precision |
+| Double | Double | double | Double precision |
+| BigDecimal | BigDecimal | decimal | Exact precision |
+| Boolean | Boolean | boolean | |
+| LocalDate | LocalDate | date | Date only |
+| Instant | Instant | timestamp | UTC timestamp |
+| ZonedDateTime | ZonedDateTime | timestamp | With timezone |
+| Duration | Duration | bigint | Duration in nanos |
+| UUID | UUID | uuid | Unique identifier |
+| Blob | byte[] | blob | Binary data |
+| AnyBlob | byte[] | blob | Any binary |
+| ImageBlob | byte[] | blob | Image with content type |
+| TextBlob | String | clob | Large text |
+
+## Validations
+| Validation | Applies to | Example |
+|---|---|---|
+| `required` | All | `name String required` |
+| `minlength(n)` | String | `name String minlength(3)` |
+| `maxlength(n)` | String | `name String maxlength(100)` |
+| `min(n)` | Numeric | `price BigDecimal min(0)` |
+| `max(n)` | Numeric | `quantity Integer max(1000)` |
+| `pattern(regex)` | String | `sku String pattern(/^[A-Z]{3}-[0-9]{4}$/)` |
+| `unique` | All | `email String unique` |
+
+## Relationship Types
+```jdl
+relationship OneToMany {
+    Owner{children} to Child{owner(displayField) required}
+}
+relationship ManyToMany {
+    A{bs} to B{as}
+}
+relationship OneToOne {
+    A{b} to B with jpaDerivedIdentifier
+}
+relationship ManyToOne {
+    Child{parent(name)} to Parent
+}
+```
+
+## Enum Definition
+```jdl
+enum Status {
+    ACTIVE("Active"),
+    INACTIVE("Inactive")
+}
+```

package/templates/bundle-jhipster-monorepo/skills/jhipster-liquibase/SKILL.md

@@ -1,28 +1,55 @@
 ---
 name: jhipster-liquibase
-description: Gerenciar migrations de banco com Liquibase no JHipster. Use quando precisar criar tabelas, alterar schema, adicionar colunas, ou criar índices.
+description: Manage database migrations with Liquibase in JHipster. Use when creating tables, altering schema, adding columns, creating indexes, or managing database changesets.
+version: 1.0.0
+author: Maestro
 ---
 
-# Liquibase no JHipster
+# JHipster Liquibase
 
-## Estrutura
+Manage database schema migrations using Liquibase in JHipster projects, including creating tables, adding columns, indexes, and foreign keys.
+
+## When to Use
+- When creating new database tables
+- When adding or modifying columns
+- When creating indexes or foreign keys
+- When reviewing or fixing auto-generated changesets
+- When rolling back database changes
+
+## Available Operations
+1. Create a new table changeset
+2. Add columns to existing tables
+3. Create indexes and foreign keys
+4. Preview SQL before execution
+5. Rollback changesets
+
+## Multi-Step Workflow
+
+### Step 1: Understand the Structure
 
 ```
 src/main/resources/config/liquibase/
-├── master.xml                    # Arquivo principal (lista todos os changelogs)
-├── changelog/
-│   ├── 00000000000000_initial_schema.xml
-│   ├── 20260327100000_added_entity_Demand.xml
-│   ├── 20260327100100_added_entity_Task.xml
-│   └── 20260327120000_added_column_priority.xml
-└── data/
-    ├── authority.csv             # Dados iniciais
-    └── user.csv
+  master.xml                    # Main file (lists all changelogs)
+  changelog/
+    00000000000000_initial_schema.xml
+    20260327100000_added_entity_Demand.xml
+    20260327100100_added_entity_Task.xml
+  data/
+    authority.csv               # Initial data
+    user.csv
+```
+
+```bash
+# View existing changelogs
+ls src/main/resources/config/liquibase/changelog/
+
+# View master.xml includes
+cat src/main/resources/config/liquibase/master.xml
 ```
 
-## Criar changeset
+### Step 2: Create a Changeset
 
-### Nova tabela
+**New table:**
 ```xml
 <changeSet id="20260327-1" author="dev">
     <createTable tableName="demand">
@@ -50,7 +77,7 @@ src/main/resources/config/liquibase/
 </changeSet>
 ```
 
-### Adicionar coluna
+**Add column:**
 ```xml
 <changeSet id="20260327-2" author="dev">
     <addColumn tableName="demand">
@@ -61,7 +88,7 @@ src/main/resources/config/liquibase/
 </changeSet>
 ```
 
-### Foreign key
+**Foreign key:**
 ```xml
 <changeSet id="20260327-3" author="dev">
     <addForeignKeyConstraint
@@ -73,11 +100,9 @@ src/main/resources/config/liquibase/
 </changeSet>
 ```
 
-## Regras
+### Step 3: Add Rollback
 
-- IDs de changeset: `YYYYMMDD-N` (data + sequencial)
-- Nunca modificar changeset já executado em produção
-- Sempre adicionar rollback:
+Always include rollback instructions:
 ```xml
 <changeSet id="20260327-1" author="dev">
     <addColumn tableName="demand">
@@ -88,8 +113,83 @@ src/main/resources/config/liquibase/
     </rollback>
 </changeSet>
 ```
-- Testar migration com `./mvnw liquibase:updateSQL` antes de rodar
-- Registrar no `master.xml`:
+
+### Step 4: Register in master.xml
+
 ```xml
-<include file="config/liquibase/changelog/20260327120000_added_column_priority.xml" relativeToChangelogFile="false"/>
+<include file="config/liquibase/changelog/20260327120000_added_column_priority.xml"
+         relativeToChangelogFile="false"/>
+```
+
+### Step 5: Preview and Apply
+
+```bash
+# Preview SQL without executing
+./mvnw liquibase:updateSQL
+
+# Apply migrations
+./mvnw liquibase:update
+
+# Check migration status
+./mvnw liquibase:status
+
+# Rollback last changeset
+./mvnw liquibase:rollbackCount -Dliquibase.rollbackCount=1
+
+# Run the application (auto-applies pending migrations)
+./mvnw spring-boot:run
+
+# Verify database state
+./mvnw liquibase:status
 ```
+
+### Step 6: Verify
+
+```bash
+# Run integration tests that validate schema
+./mvnw test -Dtest="*RepositoryIT,*ResourceIT"
+
+# Check for migration issues
+./mvnw liquibase:validate
+```
+
+## Resources
+- `references/liquibase-operations.md` - Complete reference of Liquibase XML operations
+
+## Examples
+### Example 1: Create a New Entity Table
+User asks: "Create a products table with name, price, and SKU"
+Response approach:
+1. Create changelog file `YYYYMMDD_added_entity_Product.xml`
+2. Define `createTable` with columns and constraints
+3. Add index on frequently queried columns
+4. Add rollback with `dropTable`
+5. Register in `master.xml`
+6. Run `./mvnw liquibase:updateSQL` to preview
+7. Run `./mvnw spring-boot:run` to apply
+
+### Example 2: Add Column to Existing Table
+User asks: "Add a priority column to the demand table"
+Response approach:
+1. Create changelog file `YYYYMMDD_added_column_priority.xml`
+2. Use `addColumn` with type and constraints
+3. Add rollback with `dropColumn`
+4. Register in `master.xml`
+5. Preview with `./mvnw liquibase:updateSQL`
+6. Apply by running the app
+
+### Example 3: Fix a Migration Issue
+User asks: "The migration is failing on startup"
+Response approach:
+1. Check error in application logs
+2. Run `./mvnw liquibase:status` to see pending changesets
+3. Run `./mvnw liquibase:validate` to check for issues
+4. If needed, rollback with `./mvnw liquibase:rollbackCount`
+5. Fix the changeset and reapply
+
+## Notes
+- Changeset IDs follow format: `YYYYMMDD-N` (date + sequential number)
+- NEVER modify a changeset already executed in production
+- Always add rollback instructions to changesets
+- Preview SQL with `./mvnw liquibase:updateSQL` before applying
+- JHipster auto-generates changesets from JDL -- review before running

package/templates/bundle-jhipster-monorepo/skills/jhipster-liquibase/references/liquibase-operations.md

@@ -0,0 +1,95 @@
+# Liquibase Operations Reference
+
+## Table Operations
+```xml
+<!-- Create table -->
+<createTable tableName="name">
+    <column name="id" type="bigint" autoIncrement="true">
+        <constraints primaryKey="true" nullable="false"/>
+    </column>
+    <column name="field" type="varchar(255)">
+        <constraints nullable="false"/>
+    </column>
+</createTable>
+
+<!-- Drop table -->
+<dropTable tableName="name"/>
+```
+
+## Column Operations
+```xml
+<!-- Add column -->
+<addColumn tableName="name">
+    <column name="new_col" type="varchar(100)">
+        <constraints nullable="false"/>
+    </column>
+</addColumn>
+
+<!-- Drop column -->
+<dropColumn tableName="name" columnName="col"/>
+
+<!-- Modify column type -->
+<modifyDataType tableName="name" columnName="col" newDataType="varchar(500)"/>
+
+<!-- Rename column -->
+<renameColumn tableName="name" oldColumnName="old" newColumnName="new" columnDataType="varchar(255)"/>
+
+<!-- Add default value -->
+<addDefaultValue tableName="name" columnName="col" defaultValue="ACTIVE"/>
+```
+
+## Constraint Operations
+```xml
+<!-- Add NOT NULL -->
+<addNotNullConstraint tableName="name" columnName="col" columnDataType="varchar(255)"/>
+
+<!-- Add UNIQUE -->
+<addUniqueConstraint tableName="name" columnNames="col1,col2" constraintName="ux_name_cols"/>
+
+<!-- Add Foreign Key -->
+<addForeignKeyConstraint
+    baseTableName="child" baseColumnNames="parent_id"
+    constraintName="fk_child_parent"
+    referencedTableName="parent" referencedColumnNames="id"/>
+```
+
+## Index Operations
+```xml
+<!-- Create index -->
+<createIndex indexName="idx_table_col" tableName="name">
+    <column name="col"/>
+</createIndex>
+
+<!-- Composite index -->
+<createIndex indexName="idx_table_cols" tableName="name">
+    <column name="col1"/>
+    <column name="col2"/>
+</createIndex>
+
+<!-- Drop index -->
+<dropIndex tableName="name" indexName="idx_table_col"/>
+```
+
+## Data Operations
+```xml
+<!-- Insert data -->
+<insert tableName="name">
+    <column name="id" value="1"/>
+    <column name="name" value="Admin"/>
+</insert>
+
+<!-- Load from CSV -->
+<loadData file="config/liquibase/data/entity.csv" tableName="name" separator=";">
+    <column name="id" type="numeric"/>
+    <column name="name" type="string"/>
+</loadData>
+```
+
+## Maven Commands
+```bash
+./mvnw liquibase:updateSQL    # Preview SQL
+./mvnw liquibase:update       # Apply migrations
+./mvnw liquibase:status       # Check pending
+./mvnw liquibase:validate     # Validate changelogs
+./mvnw liquibase:rollbackCount -Dliquibase.rollbackCount=1  # Rollback
+```