feat: implement RENAME with automatic reference refactoring

Add RENAME command for entity, microflow, nanoflow, page, enumeration,
association, constant, and module. A generic BSON string scanner updates
all BY_NAME references across the project. Supports DRY RUN to preview
changes. Adds mxcli rename CLI subcommand.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: ako

cmd/mxcli/cmd_rename.go

@@ -0,0 +1,115 @@
+// SPDX-License-Identifier: Apache-2.0
+
+package main
+
+import (
+	"fmt"
+	"os"
+	"strings"
+
+	"github.com/mendixlabs/mxcli/mdl/visitor"
+	"github.com/spf13/cobra"
+)
+
+var renameCmd = &cobra.Command{
+	Use:   "rename <type> <qualified-name> <new-name>",
+	Short: "Rename a project element and update all references",
+	Long: `Rename an element and automatically update all cross-references.
+
+Types:
+  entity         Rename an entity
+  microflow      Rename a microflow
+  nanoflow       Rename a nanoflow
+  page           Rename a page
+  enumeration    Rename an enumeration
+  association    Rename an association
+  constant       Rename a constant
+  module         Rename a module (updates all qualified names)
+
+Use --dry-run to preview changes without modifying.
+
+Example:
+  mxcli rename -p app.mpr entity MyModule.Customer Client
+  mxcli rename -p app.mpr microflow MyModule.ACT_Old ACT_New
+  mxcli rename -p app.mpr page MyModule.OldPage NewPage
+  mxcli rename -p app.mpr module OldModule NewModule
+  mxcli rename -p app.mpr entity MyModule.Customer Client --dry-run
+`,
+	Args: cobra.ExactArgs(3),
+	Run: func(cmd *cobra.Command, args []string) {
+		projectPath, _ := cmd.Flags().GetString("project")
+		if projectPath == "" {
+			fmt.Fprintln(os.Stderr, "Error: --project (-p) is required")
+			os.Exit(1)
+		}
+
+		dryRun, _ := cmd.Flags().GetBool("dry-run")
+
+		objectType := strings.ToUpper(args[0])
+		qualifiedName := args[1]
+		newName := args[2]
+
+		var mdlCmd string
+		dryRunSuffix := ""
+		if dryRun {
+			dryRunSuffix = " DRY RUN"
+		}
+
+		switch objectType {
+		case "ENTITY":
+			mdlCmd = fmt.Sprintf("RENAME ENTITY %s TO %s%s", qualifiedName, newName, dryRunSuffix)
+		case "MICROFLOW":
+			mdlCmd = fmt.Sprintf("RENAME MICROFLOW %s TO %s%s", qualifiedName, newName, dryRunSuffix)
+		case "NANOFLOW":
+			mdlCmd = fmt.Sprintf("RENAME NANOFLOW %s TO %s%s", qualifiedName, newName, dryRunSuffix)
+		case "PAGE":
+			mdlCmd = fmt.Sprintf("RENAME PAGE %s TO %s%s", qualifiedName, newName, dryRunSuffix)
+		case "ENUMERATION":
+			mdlCmd = fmt.Sprintf("RENAME ENUMERATION %s TO %s%s", qualifiedName, newName, dryRunSuffix)
+		case "ASSOCIATION":
+			mdlCmd = fmt.Sprintf("RENAME ASSOCIATION %s TO %s%s", qualifiedName, newName, dryRunSuffix)
+		case "CONSTANT":
+			mdlCmd = fmt.Sprintf("RENAME CONSTANT %s TO %s%s", qualifiedName, newName, dryRunSuffix)
+		case "MODULE":
+			mdlCmd = fmt.Sprintf("RENAME MODULE %s TO %s%s", qualifiedName, newName, dryRunSuffix)
+		default:
+			fmt.Fprintf(os.Stderr, "Unknown type: %s\n", args[0])
+			fmt.Fprintln(os.Stderr, "Valid types: entity, microflow, nanoflow, page, enumeration, association, constant, module")
+			os.Exit(1)
+		}
+
+		exec, logger := newLoggedExecutor("subcommand")
+		defer logger.Close()
+		defer exec.Close()
+
+		// Connect
+		connectProg, _ := visitor.Build(fmt.Sprintf("CONNECT LOCAL '%s' FOR WRITING", projectPath))
+		for _, stmt := range connectProg.Statements {
+			if err := exec.Execute(stmt); err != nil {
+				fmt.Fprintf(os.Stderr, "Error: %v\n", err)
+				os.Exit(1)
+			}
+		}
+
+		// Execute rename
+		renameProg, errs := visitor.Build(mdlCmd)
+		if len(errs) > 0 {
+			for _, err := range errs {
+				fmt.Fprintf(os.Stderr, "Parse error: %v\n", err)
+			}
+			os.Exit(1)
+		}
+
+		for _, stmt := range renameProg.Statements {
+			if err := exec.Execute(stmt); err != nil {
+				fmt.Fprintf(os.Stderr, "Error: %v\n", err)
+				os.Exit(1)
+			}
+		}
+	},
+}
+
+func init() {
+	renameCmd.Flags().Bool("dry-run", false, "Preview changes without modifying")
+	rootCmd.AddCommand(renameCmd)
+}

docs/01-project/MDL_QUICK_REFERENCE.md

@@ -28,6 +28,7 @@ CREATE PERSISTENT ENTITY Module.Photo (
 | Describe module | `DESCRIBE MODULE ModuleName;` | All contents (entities, microflows, pages, etc.) |
 | Create module | `CREATE MODULE ModuleName;` | |
 | Drop module | `DROP MODULE ModuleName;` | |
+| Rename module | `RENAME MODULE OldName TO NewName;` | Updates all qualified name references |
 
 ## Domain Model
 
@@ -40,6 +41,9 @@ CREATE PERSISTENT ENTITY Module.Photo (
 | Drop entity | `DROP ENTITY Module.Name;` | |
 | Describe entity | `DESCRIBE ENTITY Module.Name;` | Full MDL output |
 | Describe enumeration | `DESCRIBE ENUMERATION Module.Name;` | Full MDL output |
+| Rename entity | `RENAME ENTITY Module.Old TO New;` | Updates all references |
+| Rename enumeration | `RENAME ENUMERATION Module.Old TO New;` | Updates attribute type refs |
+| Rename association | `RENAME ASSOCIATION Module.Old TO New;` | Updates all references |
 | Show entities | `SHOW ENTITIES [IN Module];` | List all or filter by module |
 | Create enumeration | `CREATE [OR MODIFY] ENUMERATION Module.Name (Value1 'Caption', ...);` | |
 | Drop enumeration | `DROP ENUMERATION Module.Name;` | |
@@ -160,6 +164,10 @@ AUTHENTICATION Basic, Session
 | Show nanoflows | `SHOW NANOFLOWS [IN Module];` | List all or filter by module |
 | Describe microflow | `DESCRIBE MICROFLOW Module.Name;` | Full MDL with activities |
 | Describe nanoflow | `DESCRIBE NANOFLOW Module.Name;` | Full MDL with activities |
+| Rename microflow | `RENAME MICROFLOW Module.Old TO New;` | Updates all references |
+| Rename nanoflow | `RENAME NANOFLOW Module.Old TO New;` | Updates all references |
+| Rename page | `RENAME PAGE Module.Old TO New;` | Updates all references |
+| Rename constant | `RENAME CONSTANT Module.Old TO New;` | Updates all references |
 | Drop microflow | `DROP MICROFLOW Module.Name;` | |
 | Drop nanoflow | `DROP NANOFLOW Module.Name;` | |
 

mdl-examples/doctype-tests/25-rename-examples.mdl

@@ -0,0 +1,30 @@
+-- =============================================================================
+-- RENAME Examples
+-- =============================================================================
+
+CREATE MODULE RenameTest;
+
+-- Create test entities
+CREATE PERSISTENT ENTITY RenameTest.Customer (
+  Name: String(200),
+  Email: String(200)
+);
+
+CREATE PERSISTENT ENTITY RenameTest.Order (
+  OrderDate: DateTime
+);
+
+CREATE ASSOCIATION RenameTest.Order_Customer
+  FROM RenameTest.Order TO RenameTest.Customer
+  TYPE Reference;
+
+-- Rename entity
+RENAME ENTITY RenameTest.Customer TO Client;
+
+-- Rename association
+RENAME ASSOCIATION RenameTest.Order_Customer TO Order_Client;
+
+-- Clean up
+DROP ASSOCIATION RenameTest.Order_Client;
+DROP ENTITY RenameTest.Client;
+DROP ENTITY RenameTest.Order;

mdl/ast/ast_rename.go

@@ -0,0 +1,16 @@
+// SPDX-License-Identifier: Apache-2.0
+
+package ast
+
+// RenameStmt represents:
+//
+//	RENAME ENTITY Module.OldName TO NewName [DRY RUN];
+//	RENAME MODULE OldName TO NewName [DRY RUN];
+type RenameStmt struct {
+	ObjectType string        // "ENTITY", "MODULE"
+	Name       QualifiedName // Current name (Module.Entity or Module for modules)
+	NewName    string        // New simple name (just the name, not qualified)
+	DryRun     bool          // If true, report references without modifying
+}
+
+func (s *RenameStmt) isStatement() {}