e4c5 · Feb 17, 2026 · Feb 11, 2026 · Feb 11, 2026 · Feb 11, 2026 · Feb 11, 2026
diff --git a/README.md b/README.md
@@ -8,15 +8,25 @@ This module provides a suite of advanced utilities and tools built on top of the
 - [Development Setup](#development-setup)
 - [Maven Parent POM Converter](#maven-parent-pom-converter)
 - [Query Optimizer](#query-optimizer)
+- [JPA Repository Analyzer](#jpa-repository-analyzer)
 - [Spring Boot Migration Tools](#spring-boot-migration-tools)
     - [2.1 to 2.2 Migrator](#spring-boot-2122-migrator)
     - [2.2 to 2.3 Migrator](#spring-boot-2223-migrator)
+    - [2.3 to 2.4 Migrator](#spring-boot-2324-migrator)
+    - [2.4 to 2.5 Migrator](#spring-boot-2425-migrator)
+    - [Spring Boot Version Detector](#spring-boot-version-detector)
     - [Circular Dependency Tool](#circular-dependency-tool)
 - [Code Quality & Analysis Tools](#code-quality--analysis-tools)
+    - [AnnotationFinder](#annotationfinder)
     - [TestFixer](#testfixer)
-    - [Liquibase Indexes](#liquibase-indexes)
+    - [Logger Analysis](#logger-analysis)
+    - [Liquibase Tools](#liquibase-tools)
+        - [Liquibase Indexes](#liquibase-indexes)
+        - [Liquibase Validator](#liquibase-validator)
+        - [Liquibase Validation MCP Server](#liquibase-validation-mcp-server)
     - [HardDelete Detection](#harddelete-detection)
     - [UsageFinder](#usagefinder)
+- [Knowledge Graph](#knowledge-graph)
 
 ---
 
@@ -114,6 +124,24 @@ Ensure your `generator.yml` is set up with valid AI service credentials and poin
 
 ---
 
+## JPA Repository Analyzer
+
+Bulk exports all JPA repository queries to CSV for auditing and analysis.
+
+### Quick Start
+```bash
+mvn exec:java -Dexec.mainClass="sa.com.cloudsolutions.antikythera.examples.JPARepositoryAnalyzer" \
+  -Dexec.args="-b /path/to/project -o repository_queries.csv"
+```
+
+### Features
+- Extracts all `@Query` annotations from JPA repositories
+- Exports query metadata to CSV format
+- Supports custom output file paths
+- Analyzes both explicit queries and derived query methods
+
+---
+
 ## Spring Boot Migration Tools
 
 Automated tools to upgrade Spring Boot applications across major/minor versions.
@@ -132,6 +160,25 @@ java -cp target/classes com.raditha.spring.SpringBoot22to23Migrator --project-pa
 ```
 📖 **[Quick Start](docs/spring_boot_2.2_to_2.3_quickstart.md)**
 
+### Spring Boot 2.3→2.4 Migrator
+Upgrades Spring Boot 2.3 apps to 2.4.
+```bash
+java -cp target/classes com.raditha.spring.SpringBoot23to24Migrator --project-path /path/to/project
+```
+
+### Spring Boot 2.4→2.5 Migrator
+Upgrades Spring Boot 2.4 apps to 2.5.
+```bash
+java -cp target/classes com.raditha.spring.SpringBoot24to25Migrator --project-path /path/to/project
+```
+
+### Spring Boot Version Detector
+Detects the Spring Boot version from a POM file.
+```bash
+java -cp target/classes sa.com.cloudsolutions.antikythera.examples.SpringBootVersionDetector /path/to/pom.xml
+```
+Outputs the detected Spring Boot version to stdout.
+
 ### Circular Dependency Tool
 Detects and resolves circular bean dependencies using strategies like `@Lazy`, setter injection, and **Method Extraction** for `@PostConstruct` cycles.
 
@@ -146,20 +193,71 @@ mvn exec:java -Dexec.mainClass="com.raditha.spring.cycle.CircularDependencyTool"
 
 ## Code Quality & Analysis Tools
 
+### AnnotationFinder
+Finds all classes and methods annotated with a specific annotation.
+
+**Quick Start:**
+```bash
+# Detailed output (default) - includes full method signatures
+mvn exec:java -Dexec.mainClass="sa.com.cloudsolutions.antikythera.examples.AnnotationFinder" \
+  -Dexec.args="Service"
+
+# Simple output - method name only, duplicates eliminated
+mvn exec:java -Dexec.mainClass="sa.com.cloudsolutions.antikythera.examples.AnnotationFinder" \
+  -Dexec.args="Service --simple"
+```
+
+**Features:**
+- Searches entire codebase for specified annotation
+- Handles both simple names (e.g., `Service`) and fully qualified names (e.g., `org.springframework.stereotype.Service`)
+- Two output modes: detailed (default) and simple
+- Supports any annotation name (e.g., `@Service`, `@Test`, `@Entity`, `@Query`)
+
+**Output Format:**
+- **Class annotations**: `com.example.MyService` (same in both modes)
+- **Method annotations (detailed mode)**: `com.example.MyClass#print()` or `com.example.MyClass#print(String s)`
+- **Method annotations (simple mode)**: `com.example.MyClass#print` (method name only, no duplicates for overloaded methods)
+
+**Options:**
+- `--simple` or `-s`: Enable simple output mode (method name only, eliminates duplicates)
+
 ### TestFixer
 Identifies and fixes bad testing patterns (missing assertions, framework migration).
 ```bash
 mvn exec:java -Dexec.mainClass="sa.com.cloudsolutions.antikythera.examples.TestFixer" -Dexec.args="--dry-run"
 ```
 📖 **[Documentation](docs/test_fixer.md)**
 
-### Liquibase Indexes
-Audits database indexes defined in Liquibase changelogs.
+### Logger Analysis
+Analyzes and standardizes logger usage across the codebase, ensuring consistent logging patterns.
+```bash
+mvn exec:java -Dexec.mainClass="sa.com.cloudsolutions.antikythera.examples.Logger"
+```
+Processes all classes in the project and standardizes logger field declarations and usage.
+
+### Liquibase Tools
+
+#Audits database indexes defined in Liquibase changelogs.
 ```bash
 mvn exec:java -Dexec.mainClass="sa.com.cloudsolutions.liquibase.Indexes" -Dexec.args="path/to/db.changelog-master.xml"
 ```
 📖 **[Documentation](docs/liquibase_indexes.md)**
 
+#### Liquibase Validator
+Validates Liquibase changelog XML files for syntax errors and structural issues.
+```bash
+mvn exec:java -Dexec.mainClass="sa.com.cloudsolutions.antikythera.mcp.LiquibaseValidator" \
+  -Dexec.args="path/to/changelog.xml"
+```
+Outputs validation results in JSON format with exit code 0 for valid files, 1 for invalid.
+
+#### Liquibase Validation MCP Server
+MCP (Model Context Protocol) server for Liquibase validation, enabling integration with AI agents and tools.
+```bash
+mvn exec:java -Dexec.mainClass="sa.com.cloudsolutions.antikythera.mcp.LiquibaseValidationMcpServer"
+```
+Starts an MCP server that provides Liquibase validation capabilities via the MCP protocol.
+
 ### HardDelete Detection
 Finds hard delete operations in repositories to enforce soft-delete policies.
 ```bash
@@ -173,3 +271,19 @@ Analyzes collection usage (List, Set, Map) in non-entity classes to detect poten
 mvn exec:java -Dexec.mainClass="sa.com.cloudsolutions.antikythera.examples.UsageFinder"
 ```
 📖 **[Documentation](docs/usage_finder.md)**
+
+---
+
+## Knowledge Graph
+
+### KnowledgeGraphCLI
+Generates knowledge graphs from Java codebases, visualizing relationships between classes, methods, and dependencies.
+```bash
+mvn exec:java -Dexec.mainClass="com.raditha.graph.KnowledgeGraphCLI" \
+  -Dexec.args="--base-path=/path/to/project --config=src/main/resources/graph.yml"
+```
+
+### Features
+- Builds comprehensive dependency graphs
+- Configurable analysis scope via YAML configuration
+- Visualizes code relationships and dependencies
diff --git a/docs/findAll-vs-visit.md b/docs/findAll-vs-visit.md
@@ -0,0 +1,70 @@
+# Java Parser Method Finding Benchmark
+
+## Overview
+
+This benchmark compares the performance of two approaches for finding a specific method declaration in a JavaParser AST:
+
+1. **Using `findAll()`**: Calling `TypeDeclaration.findAll(MethodDeclaration.class)` and filtering by name
+2. **Using `VoidVisitor`**: Using a custom `VoidVisitorAdapter` to traverse the AST
+
+## Benchmark Details
+
+- **Target File**: `AbstractCompiler.java` (~1591 lines)
+- **Target Method**: `camelToSnakeCase`
+- **Iterations**: 1000 per approach
+- **JVM Warmup**: 100 iterations before actual benchmark
+
+## Results
+
+Based on multiple benchmark runs, the results consistently show:
+
+| Approach | Average Time (1000 iterations) | Performance |
+|----------|-------------------------------|-------------|
+| `findAll()` | ~87-90 ms | **2.3-2.6x FASTER** |
+| `VoidVisitor` | ~205-225 ms | Baseline |
+
+## Key Findings
+
+1. **`findAll()` is significantly faster** (~2.4x on average) than using a VoidVisitor pattern
+2. Both methods successfully locate the same method declaration (verification passed)
+3. Results are consistent across multiple runs with minimal variance
+
+## Why is `findAll()` Faster?
+
+The `findAll()` method in JavaParser is highly optimized and uses internal shortcuts to efficiently traverse the AST. The VoidVisitor pattern, while more flexible, involves:
+- Additional object creation (visitor instance)
+- Virtual method dispatch overhead
+- More callback invocations during traversal
+
+## When to Use Each Approach
+
+### Use `findAll()` when:
+- You need to find all instances of a specific node type
+- Performance is critical
+- The search criteria is simple (type-based filtering)
+
+### Use `VoidVisitor` when:
+- You need complex custom logic during traversal
+- You need to maintain state across multiple node visits
+- You need to visit multiple different node types in a single pass
+- You need to modify the AST during traversal
+
+## Running the Benchmark
+
+```bash
+cd /home/raditha/csi/Antikythera/antikythera-examples
+mvn clean compile test-compile
+java -cp "target/test-classes:target/classes:$(mvn dependency:build-classpath -q -Dmdep.outputFile=/dev/stdout)" com.raditha.perf.JavaParserMethodFindingBenchmark
+```
+
+## Implementation Notes
+
+- JavaParser is configured to support Java 21 language features
+- The benchmark includes JVM warmup to ensure accurate measurements
+- Both methods operate on the same parsed `CompilationUnit` to ensure fair comparison
+- Timing is done using `System.nanoTime()` for high precision
+
+## Conclusion
+
+For simple method lookups by name, **`findAll()` is the clear winner** in terms of performance. However, the VoidVisitor pattern remains valuable for more complex traversal scenarios where its flexibility outweighs the performance overhead.
+