refactor: renamed ChangeUnit to Change (#390)

Author: osantana85

CLAUDE.md

@@ -112,9 +112,9 @@ This is a multi-module Gradle project using Kotlin DSL.
 - **Critical**: Hierarchical context MUST be built before driver initialization
 
 **Pipeline Architecture**: Change execution organized in stages:
-- `LoadedPipeline` - Executable pipeline with stages and change units
+- `LoadedPipeline` - Executable pipeline with stages and changes
 - `pipeline.yaml` - Declarative pipeline definition in `src/test/resources/flamingock/`
-- Stages contain change units which are atomic migration operations
+- Stages contain changes which are atomic migration operations
 
 **AuditStore System**: Database/system-specific implementations:
 - `AuditStore` interface provides `ConnectionEngine` for specific technologies
@@ -130,7 +130,7 @@ This is a multi-module Gradle project using Kotlin DSL.
 
 **Core Modules** (`core/`):
 - `flamingock-core` - Core engine and orchestration logic
-- `flamingock-core-api` - Public API annotations (`@ChangeUnit`, `@Execution`)
+- `flamingock-core-api` - Public API annotations (`@Change`, `@Execution`)
 - `flamingock-core-commons` - Shared internal utilities
 - `flamingock-processor` - Annotation processor for pipeline generation
 - `flamingock-graalvm` - GraalVM native image support
@@ -155,7 +155,7 @@ This is a multi-module Gradle project using Kotlin DSL.
 
 ### Key Patterns
 
-**Change Units**: Atomic migration operations annotated with `@ChangeUnit`:
+**Changes**: Atomic migration operations annotated with `@Change`:
 - `id` - Unique identifier for tracking
 - `order` - Execution sequence (can be auto-generated)
 - `author` - Change author

README.md

@@ -82,8 +82,8 @@ No more fragile scripts or untracked console changes. With CaC:
 - **Change-as-Code (CaC)**: Treat changes to databases, queues, APIs, or configs as code — versioned, executable, and auditable.
 - **Unified system evolution**: Orchestrate changes across your full stack: event schemas, feature flags, databases, S3, SaaS APIs, and more.
 - **Programmatic or declarative**: Write changes in Java/Kotlin or define them in YAML using official or custom templates.
-- **Startup-Time synchronization**: Apply versioned ChangeUnits when your app starts — keeping deployments consistent and safe.
-- **Audit logging & rollback**: Every change is recorded externally; rollback logic is built into each ChangeUnit.
+- **Startup-Time synchronization**: Apply versioned Changes when your app starts — keeping deployments consistent and safe.
+- **Audit logging & rollback**: Every change is recorded externally; rollback logic is built into each Change.
 - **Multi-stage workflows**: Organize and execute your changes in coordinated, stage-based flows across instances.
 - **Native GraalVM support**: Compatible with native image builds for fast startup and low memory usage.
 - **Cloud-ready, OSS-Core**: Use locally, self-host, or plug into our managed Cloud — all powered by the same open source core.

RECOVERY_EXAMPLE.md

@@ -1,9 +1,9 @@
 # Recovery Feature Usage Examples
 
-## Code-Based ChangeUnit with Recovery
+## Code-Based Change with Recovery
 
 ```java
-@ChangeUnit(id = "example-change-with-retry", order = "001", author = "developer")
+@Change(id = "example-change-with-retry", order = "001", author = "developer")
 @Recovery(strategy = RecoveryStrategy.ALWAYS_RETRY)
 public class ExampleChangeWithRetry {
 
@@ -21,7 +21,7 @@ public class ExampleChangeWithRetry {
 ```
 
 ```java
-@ChangeUnit(id = "example-change-manual", order = "002", author = "developer")
+@Change(id = "example-change-manual", order = "002", author = "developer")
 @Recovery(strategy = RecoveryStrategy.MANUAL_INTERVENTION)  // This is the default
 public class ExampleChangeWithManualIntervention {
 
@@ -34,7 +34,7 @@ public class ExampleChangeWithManualIntervention {
 ```
 
 ```java
-@ChangeUnit(id = "example-change-default", order = "003", author = "developer")
+@Change(id = "example-change-default", order = "003", author = "developer")
 // No @Recovery annotation = defaults to MANUAL_INTERVENTION
 public class ExampleChangeWithDefaultRecovery {
 
@@ -46,14 +46,14 @@ public class ExampleChangeWithDefaultRecovery {
 }
 ```
 
-## Template-Based ChangeUnit with Recovery
+## Template-Based Change with Recovery
 
 Create a YAML file `src/test/resources/flamingock/pipeline.yaml`:
 
 ```yaml
 stages:
   - name: "example-stage"
-    changeUnits:
+    changes:
       - id: "template-change-retry"
         order: "001"
         template: "io.flamingock.template.mongodb.MongoChangeTemplate"

cli/flamingock-cli/CLI-README.md

@@ -24,10 +24,10 @@ A lightweight command-line interface for Flamingock audit operations in communit
 # List conflicted audit entries
 ./flamingock-cli-dist/flamingock audit list
 
-# Mark change unit as applied
+# Mark change as applied
 ./flamingock-cli-dist/flamingock audit mark --change-id ch1 --state APPLIED
 
-# Mark change unit as rolled back
+# Mark change as rolled back
 ./flamingock-cli-dist/flamingock audit mark --change-id ch2 --state ROLLED_BACK
 
 # Use custom configuration file
@@ -156,16 +156,16 @@ client.markAsRolledBack(changeId);
 
 ### `flamingock audit list`
 Lists all conflicted audit entries showing:
-- Change unit ID, execution ID, stage ID
+- Change ID, execution ID, stage ID
 - Author, state, type, class, method
 - Execution time, hostname, timestamps
 - Error traces (if any)
 
 ### `flamingock audit mark`
-Marks a change unit with a specific state:
+Marks a change with a specific state:
 - **`--state APPLIED`** - Marks as successfully applied
 - **`--state ROLLED_BACK`** - Marks as rolled back
-- **`--change-id <id>`** - Required change unit identifier
+- **`--change-id <id>`** - Required change identifier
 
 ## Error Handling
 - **Configuration errors**: Missing files, invalid YAML, multiple databases

cli/flamingock-cli/CLI_SPECIFICATION.md

@@ -14,7 +14,7 @@ flamingock [command] [operation] [options]
   - The CLI only parses input, calls `OpsClient`, and formats output.
 
 - Default behavior: 
-  - `flamingock audit list` (with no flags) → shows the **current snapshot** (latest state per changeUnit). 
+  - `flamingock audit list` (with no flags) → shows the **current snapshot** (latest state per change). 
   - Flags modify or filter the behavior.
 
 ---
@@ -50,15 +50,15 @@ flamingock audit list --limit 50 --page 2
 
 ### 2. `audit mark`
 
-Forcefully mark a given **changeUnit** with a new state.
+Forcefully mark a given **change** with a new state.
 
 **Base command:**
 ```
 flamingock audit mark --change-unit <id> --state <state>
 ```
 
 **Options:**
-- `--change-unit <id>` / `-c <id>` → the changeUnitId (required) 
+- `--change-unit <id>` / `-c <id>` → the changeId (required) 
 - `--state <state>` / `-s <state>` → the state to mark (`APPLIED` or `ROLLED_BACK`) (required) 
 
 **Examples:**
@@ -82,14 +82,14 @@ flamingock audit mark -c CU123 -s ROLLED_BACK
 - Command structure: `flamingock [command] [operation] [options]`
 - For now, only the `audit` command is implemented with: 
   - `list` (default snapshot, optional filters `--issues`, `--history`, `--since`, pagination) 
-  - `mark` (force a state for a changeUnit)
+  - `mark` (force a state for a change)
 - The CLI is a thin layer: config → build OpsClient → call → format result.
 
 ---
 
 ## Implementation Notes
 
-- **Default behavior change**: The `audit list` command now shows a **snapshot view** (latest state per changeUnit) by default, not just conflicted entries.
+- **Default behavior change**: The `audit list` command now shows a **snapshot view** (latest state per change) by default, not just conflicted entries.
 - **History flag**: Use `--history` to get the full chronological audit history.
 - **Issues flag**: Use `--issues` to filter for only entries with problems.
 - **Since flag**: Use `--since` with ISO-8601 format to filter by date.

cli/flamingock-cli/README.md

@@ -143,7 +143,7 @@ flamingock audit fix -c <change-id>
 # View all audit entries
 flamingock audit list
 
-# Check specific change unit
+# Check specific change
 flamingock audit get -c user-migration-v2
 
 # Export as JSON for processing

cli/flamingock-cli/src/main/java/io/flamingock/cli/command/audit/FixCommand.java

@@ -28,7 +28,7 @@
 
 @Command(
     name = "fix",
-    description = "Fix audit state for a change unit with inconsistent audit"
+    description = "Fix audit state for a change with inconsistent audit"
 )
 public class FixCommand implements Runnable {
 
@@ -37,7 +37,7 @@ public class FixCommand implements Runnable {
     @ParentCommand
     private AuditCommand parent;
 
-    @Option(names = {"-c", "--change-id"}, required = true, description = "ChangeUnit ID to fix")
+    @Option(names = {"-c", "--change-id"}, required = true, description = "Change ID to fix")
     private String changeId;
 
     @Option(names = {"-r", "--resolution"}, required = true, description = "Resolution state: APPLIED or ROLLED_BACK")
@@ -62,7 +62,7 @@ public void run() {
             // Handle different results with appropriate messaging
             switch (result) {
                 case APPLIED:
-                    System.out.println("✅ Successfully fixed audit state for change unit '" + changeId + "'");
+                    System.out.println("✅ Successfully fixed audit state for change '" + changeId + "'");
                     System.out.println("   Resolution applied: " + resolution);
 
                     if (resolution == Resolution.ROLLED_BACK) {
@@ -71,9 +71,9 @@ public void run() {
                     break;
 
                 case NO_ISSUE_FOUND:
-                    System.out.println("⚠️  Fix not applied for change unit '" + changeId + "'");
+                    System.out.println("⚠️  Fix not applied for change '" + changeId + "'");
                     System.out.println("   Reason: The audit state is already consistent and healthy.");
-                    System.out.println("   No action required - change unit has no issues to fix.");
+                    System.out.println("   No action required - change has no issues to fix.");
                     break;
 
                 default:

cli/flamingock-cli/src/main/java/io/flamingock/cli/command/audit/ListCommand.java

@@ -92,9 +92,9 @@ public void run() {
                 entries = auditService.listAuditEntriesSince(sinceDate);
                 listType = "Audit Entries since " + since;
             } else {
-                // Default: snapshot view (latest per changeUnit)
+                // Default: snapshot view (latest per change)
                 entries = auditService.listAuditEntriesSnapshot();
-                listType = "Audit Entries Snapshot (Latest per Change Unit)";
+                listType = "Audit Entries Snapshot (Latest per Change)";
             }
 
 

cli/flamingock-cli/src/main/java/io/flamingock/cli/command/issue/GetIssueCommand.java

@@ -44,7 +44,7 @@ public class GetIssueCommand implements Runnable {
     @ParentCommand
     private IssueCommand parent;
 
-    @Option(names = {"-c", "--change-id"}, required = false, description = "ChangeUnit ID to inspect (optional - shows next issue if not specified)")
+    @Option(names = {"-c", "--change-id"}, required = false, description = "Change ID to inspect (optional - shows next issue if not specified)")
     private String changeId;
 
     @Option(names = {"-j", "--json"}, description = "Output results in JSON format")
@@ -76,7 +76,7 @@ public void run() {
                 if (auditEntryIssueOpt.isPresent()) {
                     issueToShow = auditEntryIssueOpt.get();
                 } else {
-                    System.err.println("Error: There is no issue with changeUnit: " + changeId);
+                    System.err.println("Error: There is no issue with change: " + changeId);
                     return;
                 }
             } else {
@@ -85,7 +85,7 @@ public void run() {
                 List<AuditEntryIssue> issues = auditService.listAuditEntriesWithIssues();
 
                 if (issues.isEmpty()) {
-                    System.out.println("\n✅ No issues found! All change units are in consistent state.\n");
+                    System.out.println("\n✅ No issues found! All changes are in consistent state.\n");
                     return;
                 } else {
                     issueToShow = issues.get(0);  // Get the first issue

cli/flamingock-cli/src/main/java/io/flamingock/cli/command/issue/IssueCommand.java

@@ -21,7 +21,7 @@
 
 @Command(
     name = "issue",
-    description = "Issue operations for problematic change units",
+    description = "Issue operations for problematic changes",
     subcommands = {
         ListIssueCommand.class,
         GetIssueCommand.class