feat: evaluate built-in routing predicates and parameterized host conditions

Store transition when as JSON instead of a lookup key so designers can compose closed-set logic while hosts still supply complex refs with args. Match conditional edges before the unconditional default.

Co-authored-by: Cursor <cursoragent@cursor.com>

ordo-storage-jdbc/src/main/java/com/jetlumen/ordo/storage/jdbc/JdbcProcessDefinitionRepository.java

@@ -45,7 +45,7 @@ public final class JdbcProcessDefinitionRepository implements ProcessDefinitionR
                     + " VALUES (?, ?, ?, ?, ?)";
     private static final String INSERT_TRANSITION =
             "INSERT INTO ordo_step_transition (definition_id, definition_version, from_step_id, to_step_id,"
-                    + " condition_key, priority) VALUES (?, ?, ?, ?, ?, ?)";
+                    + " condition_json, priority) VALUES (?, ?, ?, ?, ?, ?)";
     private static final String SELECT_DEFINITION =
             "SELECT name FROM ordo_process_definition WHERE id = ? AND version = ?";
     private static final String SELECT_STEPS =
@@ -56,7 +56,7 @@ public final class JdbcProcessDefinitionRepository implements ProcessDefinitionR
             "SELECT step_id, candidate FROM ordo_step_candidate"
                     + " WHERE definition_id = ? AND definition_version = ? ORDER BY step_id, candidate_order";
     private static final String SELECT_TRANSITIONS =
-            "SELECT from_step_id, to_step_id, condition_key, priority FROM ordo_step_transition "
+            "SELECT from_step_id, to_step_id, condition_json, priority FROM ordo_step_transition "
                     + "WHERE definition_id = ? AND definition_version = ? ORDER BY from_step_id, priority";
     private static final String SELECT_LATEST_PAGE_BASE =
             "SELECT p.id, p.current_version, d.name FROM ordo_process p"
@@ -260,7 +260,7 @@ public final class JdbcProcessDefinitionRepository implements ProcessDefinitionR
             try (ResultSet resultSet = selectTransitions.executeQuery()) {
                 while (resultSet.next()) {
                     TransitionRow row = StepTransitionMapper.readRow(resultSet);
-                    transitions.add(new StepTransition(row.fromStepId(), row.toStepId(), row.conditionKey(),
+                    transitions.add(new StepTransition(row.fromStepId(), row.toStepId(), row.when(),
                             row.priority()));
                 }
             }
@@ -377,7 +377,7 @@ public final class JdbcProcessDefinitionRepository implements ProcessDefinitionR
                 insertTransition.setInt(2, definition.version());
                 insertTransition.setString(3, transition.fromStepId());
                 insertTransition.setString(4, transition.toStepId());
-                insertTransition.setString(5, transition.conditionKey());
+                insertTransition.setString(5, transition.when() == null ? null : transition.when().toJson());
                 insertTransition.setInt(6, transition.priority());
                 insertTransition.executeUpdate();
             }

ordo-storage-jdbc/src/main/java/com/jetlumen/ordo/storage/jdbc/mapper/StepTransitionMapper.java

@@ -1,5 +1,7 @@
 package com.jetlumen.ordo.storage.jdbc.mapper;
 
+import com.jetlumen.ordo.api.RoutingWhen;
+
 import java.sql.ResultSet;
 import java.sql.SQLException;
 
@@ -12,10 +14,10 @@ public final class StepTransitionMapper {
         return new TransitionRow(
                 resultSet.getString("from_step_id"),
                 resultSet.getString("to_step_id"),
-                resultSet.getString("condition_key"),
+                RoutingWhen.parseJson(resultSet.getString("condition_json")),
                 resultSet.getInt("priority"));
     }
 
-    public record TransitionRow(String fromStepId, String toStepId, String conditionKey, int priority) {
+    public record TransitionRow(String fromStepId, String toStepId, RoutingWhen when, int priority) {
     }
 }

ordo-storage-jdbc/src/main/resources/db/mysql/migration/V2__transition_condition_json.sql

@@ -0,0 +1,4 @@
+-- Replace opaque condition_key with the full when JSON object.
+
+ALTER TABLE ordo_step_transition ADD COLUMN condition_json TEXT;
+ALTER TABLE ordo_step_transition DROP COLUMN condition_key;

ordo-storage-jdbc/src/main/resources/db/postgresql/migration/V2__transition_condition_json.sql

@@ -0,0 +1,4 @@
+-- Replace opaque condition_key with the full when JSON object.
+
+ALTER TABLE ordo_step_transition ADD COLUMN condition_json TEXT;
+ALTER TABLE ordo_step_transition DROP COLUMN condition_key;