Improve query stage names

Signed-off-by: Simeon Widdis <sawiddis@amazon.com>

Author: Swiddis

common/src/main/java/org/opensearch/sql/common/error/QueryProcessingStage.java

@@ -17,49 +17,49 @@ public enum QueryProcessingStage {
    * PARSING stage: PPL/SQL syntax parsing via ANTLR lexer/parser. Errors: Syntax errors, unexpected
    * tokens, malformed queries.
    */
-  PARSING("Validating Query Syntax"),
+  PARSING("Validating query syntax"),
 
   /**
    * AST_BUILDING stage: Abstract Syntax Tree construction from parse tree. Errors: Invalid AST
    * structure, node creation failures.
    */
-  AST_BUILDING("Building Query Structure"),
+  AST_BUILDING("Assembling the query steps"),
 
   /**
    * ANALYZING stage: Semantic validation and type checking. Errors: Field not found, type
    * mismatches, semantic violations.
    */
-  ANALYZING("Checking Query Against Your Data"),
+  ANALYZING("Validating the query's steps"),
 
   /**
    * OPTIMIZING stage: Logical plan optimization with transformation rules. Errors: Optimization
    * failures, rule application errors.
    */
-  OPTIMIZING("Optimizing Query"),
+  OPTIMIZING("Optimizing the query"),
 
   /**
    * PLAN_CONVERSION stage: Conversion to Calcite execution plan with system limits. Errors:
    * Unsupported operations, plan conversion failures.
    */
-  PLAN_CONVERSION("Preparing Query Execution"),
+  PLAN_CONVERSION("Preparing the query for physical execution"),
 
   /**
    * EXECUTING stage: Query execution via OpenSearch engine. Errors: Execution failures, index
    * access errors, resource limits.
    */
-  EXECUTING("Running Query on Cluster"),
+  EXECUTING("Running the query"),
 
   /**
    * RESULT_PROCESSING stage: Result formatting and cursor management. Errors: Result formatting
    * failures, cursor errors.
    */
-  RESULT_PROCESSING("Formatting Results"),
+  RESULT_PROCESSING("Processing the query results"),
 
   /**
    * CLUSTER_VALIDATION stage: Prevalidation that cluster is healthy before execution. Errors:
    * Cluster unhealthy, nodes unavailable.
    */
-  CLUSTER_VALIDATION("Checking Cluster Health");
+  CLUSTER_VALIDATION("Checking cluster health");
 
   private final String displayName;
 

common/src/test/java/org/opensearch/sql/common/error/ErrorReportTest.java

@@ -64,7 +64,7 @@ public void testErrorReportJsonMapWithStageInContext() {
     @SuppressWarnings("unchecked")
     Map<String, Object> context = (Map<String, Object>) json.get("context");
     assertEquals("analyzing", context.get("stage"));
-    assertEquals("Checking Query Against Your Data", context.get("stage_description"));
+    assertEquals("Validating the query's steps", context.get("stage_description"));
     assertEquals("test", context.get("field_name"));
   }