From 39cde80089f493fa5559bbb24a9aab24ac18d75e Mon Sep 17 00:00:00 2001
From: abdoruzaqi <245876665+abdoruzaqi@users.noreply.github.com>
Date: Sun, 24 May 2026 15:34:16 +0000
Subject: [PATCH 1/4] fix: resolve FlexiGrid reactive loops and ProcessConfig
 warnings

- Implemented stable row identity in `FlexiGrid.vue` to prevent redundant DOM unmounting.
- Added gated content updates in `FlexValueControl.vue` to stabilize Tiptap editor state.
- Refactored `ProcessConfig.vue` to safely handle async initialization and reduce log noise.
- Fixes "Node cannot be found in the current page" and "Process name or operation missing" errors.
---
 .../rule_config/types/ProcessConfig.vue       | 12 ++++++--
 .../controls/FlexValueControl.vue             | 14 ++++++---
 .../rule_builder/controls/FlexiGrid.vue       | 30 +++++++++++++++----
 3 files changed, 44 insertions(+), 12 deletions(-)

diff --git a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/ProcessConfig.vue b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/ProcessConfig.vue
index d3ab6e33..322f19d9 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/ProcessConfig.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/ProcessConfig.vue
@@ -53,7 +53,7 @@
 </template>
 
 <script setup>
-import { onMounted, ref, reactive, watch, computed } from "vue";
+import { onMounted, ref, reactive, watch, computed, toRaw } from "vue";
 import ProcessEngine from "../engines/ProcessEngine.js";
 import SchemaRenderer from "../SchemaRenderer.vue";
 import { useStore } from "../../../stores";
@@ -126,8 +126,14 @@ function update_visual_mappings(mappings) {
 let initCounter = 0;
 
 async function initEngine() {
-	if (!props.node?.data?.process_name || !props.node?.data?.operation) {
-		console.warn("ProcessConfig: Process name or operation missing", props.node?.data);
+	const process_name = props.node?.data?.process_name;
+	const operation = props.node?.data?.operation;
+
+	if (!process_name || !operation) {
+		// Only log if it's truly an unexpected state (e.g. not just initializing)
+		if (props.node?.data) {
+			console.debug("ProcessConfig: Waiting for process_name and operation", toRaw(props.node.data));
+		}
 		return;
 	}
 
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/FlexValueControl.vue b/flexirule/public/js/flexirule/rule_builder/controls/FlexValueControl.vue
index 137c16ff..aae01d24 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/FlexValueControl.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/FlexValueControl.vue
@@ -1123,17 +1123,23 @@ watch(
 	(val) => {
 		if (emitting) return;
 		const normalized = coerceStructuredValue(val);
+
 		if (normalized.mode !== "static") {
 			isDynamicMode.value = true;
-			emitting = true;
-			editor.commands.setContent(deserialize(normalized));
-			emitting = false;
+			const newContent = deserialize(normalized);
+
+			// Check if content actually changed to avoid Tiptap focus/cursor jumping
+			if (editor.getHTML() !== newContent) {
+				emitting = true;
+				editor.commands.setContent(newContent);
+				emitting = false;
+			}
 		} else {
 			isDynamicMode.value = false;
 			staticValue.value = normalized.value ?? "";
 		}
 	},
-	{ immediate: true }
+	{ immediate: true, deep: true }
 );
 
 onBeforeUnmount(() => {
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/FlexiGrid.vue b/flexirule/public/js/flexirule/rule_builder/controls/FlexiGrid.vue
index b32389bb..330398a3 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/FlexiGrid.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/FlexiGrid.vue
@@ -237,12 +237,32 @@ function stopResize() {
 watch(
 	() => props.modelValue,
 	(val) => {
-		localRows.value = (val || []).map((r) => ({
-			...r,
-			name: r.name || frappe.utils.get_random(10),
-		}));
+		const incoming = val || [];
+
+		// Efficiently sync localRows while preserving object identities for matching 'name'
+		const currentMap = new Map(localRows.value.map((r) => [r.name, r]));
+
+		localRows.value = incoming.map((r) => {
+			const existing = r.name ? currentMap.get(r.name) : null;
+
+			if (existing) {
+				// Update existing row properties without breaking reference
+				Object.keys(r).forEach((key) => {
+					if (existing[key] !== r[key]) {
+						existing[key] = r[key];
+					}
+				});
+				return existing;
+			}
+
+			// New row or no stable name
+			return {
+				...r,
+				name: r.name || frappe.utils.get_random(10),
+			};
+		});
 	},
-	{ immediate: true }
+	{ immediate: true, deep: false }
 );
 
 function updateCell(idx, field, value) {

From 9aeb5660361f2b7e253adbb058ba91d793cf2757 Mon Sep 17 00:00:00 2001
From: abdoruzaqi <245876665+abdoruzaqi@users.noreply.github.com>
Date: Sun, 24 May 2026 16:24:32 +0000
Subject: [PATCH 2/4] fix: resolve FlexiGrid stability and missing dedupe
 metadata

- Implemented stable row identity in `FlexiGrid.vue` to prevent redundant DOM unmounting and focus loss.
- Added gated content updates in `FlexValueControl.vue` to stabilize Tiptap editor state and prevent "Node cannot be found" errors.
- Refactored `ProcessConfig.vue` to safely handle async initialization and fixed linter formatting.
- Updated `deduplication.json` with missing `fields_config` child table schema to fix empty grid rendering.
- Standardized formatting across several files to ensure CI compliance.
---
 .github/ISSUE_TEMPLATE/bug_report.md          |   6 +-
 .github/PULL_REQUEST_TEMPLATE.md              |  18 +--
 CODE_OF_CONDUCT.md                            |  18 +--
 CONTRIBUTING.md                               |  16 +--
 README.md                                     | 118 ++++++++--------
 SECURITY.md                                   |   2 +-
 docs/CONTROLS.md                              | 128 +++++++++---------
 docs/_index.md                                |   8 +-
 docs/actions/assignment.md                    |  38 +++---
 docs/actions/condition.md                     |  16 +--
 docs/actions/document_action.md               |  16 +--
 docs/actions/loop.md                          |  16 +--
 docs/actions/notify.md                        |  14 +-
 docs/actions/overview.md                      |  36 ++---
 docs/actions/process.md                       |  20 +--
 docs/actions/query_records.md                 |  10 +-
 docs/actions/standards.md                     |  34 ++---
 docs/actions/switch.md                        |  12 +-
 docs/architecture.md                          |  14 +-
 docs/builder/condition_builder.md             |  38 +++---
 docs/builder/frontend_technical.md            |  12 +-
 docs/builder/rule_builder.md                  |  32 ++---
 docs/builder/user_guide_conditions.md         |  28 ++--
 docs/engine/condition_system.md               |  52 +++----
 docs/engine/execution_engine.md               |  24 ++--
 docs/engine/orchestration.md                  |  30 ++--
 docs/engine/trigger_system.md                 |  26 ++--
 docs/reference/api.md                         |  32 ++---
 docs/reference/contracts.md                   |  22 +--
 docs/reference/doctypes.md                    |  20 +--
 docs/reference/internals.md                   |   4 +-
 docs/roadmap/technical_audit.md               |  34 ++---
 .../components/ActionFieldProperties.vue      |   2 +-
 .../rule_builder/components/ActionPopover.vue |   4 +-
 .../condition_builder/SimpleCondition.vue     |   6 +-
 .../components/nodes/ConditionNode.vue        |   2 +-
 .../components/nodes/StartNode.vue            |   4 +-
 .../components/nodes/StopNode.vue             |   4 +-
 .../components/rule_config/FilterGroup.vue    |  14 +-
 .../rule_config/RuleConfigModal.vue           |   8 +-
 .../rule_config/types/ProcessConfig.vue       |   5 +-
 .../rule_config/types/QueryRecordsConfig.vue  |   6 +-
 .../rule_config/types/SubRuleConfig.vue       |   2 +-
 .../composables/useAsyncOptionsSource.js      |   2 +-
 .../rule_builder/composables/useRuleGraph.js  |   4 +-
 .../rule_builder/controls/ComboBoxControl.vue |   3 +-
 .../controls/FlexValueControl.vue             |   2 +-
 .../rule_builder/controls/MentionList.vue     |   4 +-
 .../rule_builder/controls/MultiSelectList.vue |   8 +-
 .../controls/ResourceMapperControl.vue        |   2 +-
 .../rule_builder/controls/TextControl.vue     |   4 +-
 .../controls/TransformControl.vue             |   8 +-
 .../controls/ValueResolverControl.vue         |   8 +-
 .../rule_builder/stores/useGraphStore.js      |   8 +-
 .../rule_builder/stores/useRuleStore.js       |   8 +-
 flexirule/ruleflow/README.md                  | 114 ++++++++--------
 .../process/deduplication/deduplication.json  |   2 +-
 .../ruleflow/process/enrichment/enrichment.js |   4 +-
 58 files changed, 582 insertions(+), 550 deletions(-)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index 7d371de4..bc644781 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -24,9 +24,9 @@ If applicable, add screenshots to help explain your problem.
 
 **Environment**
 
--   FlexiRule version:
--   Frappe/ERPNext version:
--   Browser (if UI related):
+- FlexiRule version:
+- Frappe/ERPNext version:
+- Browser (if UI related):
 
 **Additional context**
 Add any other context about the problem here.
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
index fb9dba32..ec1810b4 100644
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -9,18 +9,18 @@ Fixes #(issue)
 
 ## Type of Change
 
--   [ ] Bug fix
--   [ ] New feature
--   [ ] Refactor
--   [ ] Documentation update
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Refactor
+- [ ] Documentation update
 
 ## Checklist
 
--   [ ] My code follows the project’s coding standards
--   [ ] I have added tests that prove my fix is effective or my feature works
--   [ ] I have added necessary documentation
--   [ ] All new and existing tests pass
--   [ ] I have updated the README if needed
+- [ ] My code follows the project’s coding standards
+- [ ] I have added tests that prove my fix is effective or my feature works
+- [ ] I have added necessary documentation
+- [ ] All new and existing tests pass
+- [ ] I have updated the README if needed
 
 ## Additional Notes
 
diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md
index 9008891c..94c4d0a8 100644
--- a/CODE_OF_CONDUCT.md
+++ b/CODE_OF_CONDUCT.md
@@ -10,18 +10,18 @@ We pledge to act and interact in ways that contribute to an open, welcoming, div
 
 Examples of behavior that contributes to a positive environment:
 
--   Using welcoming and inclusive language
--   Being respectful of differing viewpoints and experiences
--   Gracefully accepting constructive criticism
--   Focusing on what is best for the community
--   Showing empathy towards other community members
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
 
 Examples of unacceptable behavior:
 
--   Harassment, intimidation, or discriminatory jokes and language
--   Personal attacks or insults
--   Publishing others’ private information without consent
--   Any behavior that could reasonably be considered inappropriate in a professional setting
+- Harassment, intimidation, or discriminatory jokes and language
+- Personal attacks or insults
+- Publishing others’ private information without consent
+- Any behavior that could reasonably be considered inappropriate in a professional setting
 
 ## Enforcement
 
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 782f9103..aa280011 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -4,10 +4,10 @@ Thank you for your interest in contributing!
 
 ## How to contribute
 
--   Open an issue for bugs, enhancements, or questions.
--   Submit pull requests (PRs) for fixes or new features.
--   Follow existing coding standards and folder structure.
--   Add clear descriptions to your PRs.
+- Open an issue for bugs, enhancements, or questions.
+- Submit pull requests (PRs) for fixes or new features.
+- Follow existing coding standards and folder structure.
+- Add clear descriptions to your PRs.
 
 ## Development setup
 
@@ -17,10 +17,10 @@ Thank you for your interest in contributing!
 
 ## What we welcome
 
--   Improvements to the rule engine.
--   Process expansions.
--   UI/UX improvements for the Rule Builder.
--   Documentation and test cases.
+- Improvements to the rule engine.
+- Process expansions.
+- UI/UX improvements for the Rule Builder.
+- Documentation and test cases.
 
 ## Communication
 
diff --git a/README.md b/README.md
index aa2b3ebb..6a4e7a3f 100644
--- a/README.md
+++ b/README.md
@@ -29,10 +29,10 @@ In modern enterprise systems like **Frappe / ERPNext**, business logic often evo
 
 ### 💎 Why FlexiRule?
 
--   **Centralized Logic**: Move rules out of scattered `.py` files into a single, auditable dashboard.
--   **No-Code Configuration**: Custom UI controls (pickers, autocomplete) allow complex logic setup without a single line of code.
--   **Explicit Execution**: Connections define deterministic paths. No more guessing which hook runs first.
--   **Schema-Driven UI**: Configuration forms for custom logic are auto-generated from JSON schemas.
+- **Centralized Logic**: Move rules out of scattered `.py` files into a single, auditable dashboard.
+- **No-Code Configuration**: Custom UI controls (pickers, autocomplete) allow complex logic setup without a single line of code.
+- **Explicit Execution**: Connections define deterministic paths. No more guessing which hook runs first.
+- **Schema-Driven UI**: Configuration forms for custom logic are auto-generated from JSON schemas.
 
 ---
 
@@ -79,9 +79,9 @@ FlexiRule is built around three core pillars that bridge the gap between design
 
 A **Rule** defines _when_ logic should trigger. It serves as the gateway to the graph and binds to one of three context sources:
 
--   **DocType Event**: Tied to database hooks (e.g., `Before Save`, `On Submit`).
--   **Scheduler Event**: Scheduled CRON-based executions via background jobs.
--   **Callable Event**: A sub-rule meant strictly to be executed by other parent rules via `Priority: 0`.
+- **DocType Event**: Tied to database hooks (e.g., `Before Save`, `On Submit`).
+- **Scheduler Event**: Scheduled CRON-based executions via background jobs.
+- **Callable Event**: A sub-rule meant strictly to be executed by other parent rules via `Priority: 0`.
 
 ### 2. The Rule Action (The Node)
 
@@ -91,8 +91,8 @@ Each node in the graph is a **Rule Action**. It represents a specific step in yo
 
 A **Process** is a file-backed module (similar to Frappe Reports/Dashboards) that acts as a container for reusable logic.
 
--   **File-Backed**: Logic is stored in code (`.py`) for performance and version control.
--   **Operations**: Individual functions within a process that declare their own **JSON Schema** for configuration parameters.
+- **File-Backed**: Logic is stored in code (`.py`) for performance and version control.
+- **Operations**: Individual functions within a process that declare their own **JSON Schema** for configuration parameters.
 
 ---
 
@@ -125,24 +125,24 @@ graph LR
 
 ## 🛠️ Key Features
 
--   **Vue 3 Visual Builder**: Smooth graph-editing via a VueFlow canvas rendered dynamically from Frappe backend schemas.
--   **Condition Compilation**: Visual engine builds JSON `trigger_conditions` that are transparently pre-compiled into ultra-fast, single-pass pure Python strings `compiled_expression` on Save to avoid runtime overhead.
--   **Node Execution State Management**: Real-time tracking of execution state across components for visualization and debugging.
--   **Compiled Runtime Registry**: Layered caching system (request-local → Redis → DB) for compiled rules and dependencies.
--   **Role-Based Execution Control**: `skip_for_roles` field to prevent rule execution for specific roles.
--   **Permission Audit Logging**: `skip_permissions` with audit reason for tracking bypassed permission checks.
--   **Watched Fields Optimization**: Automatic extraction and change-based filtering for event-driven rules.
--   **Comprehensive Error Handling**:
-    -   Retry with exponential backoff
-    -   Rollback with savepoints
-    -   Escalate to caller
-    -   Continue or Stop (default)
--   **Async Execution via Background Queues**: Offload long-running rules to background jobs.
--   **Timeout Protection**: Per-rule and per-action timeout limits.
--   **Asynchronous Execution Log Enqueuing**: Non-blocking persistence of execution traces.
--   **Graph Validation with Cycle Detection**: Prevents infinite loops with visit counting and iteration limits.
--   **Deterministic Graph Execution**: Zero ambiguity in execution order via Registry strategy pattern.
--   **Safety First**: Sandboxed execution via `SafeFrappeAPI`, savepoint rollbacks, and input validation.
+- **Vue 3 Visual Builder**: Smooth graph-editing via a VueFlow canvas rendered dynamically from Frappe backend schemas.
+- **Condition Compilation**: Visual engine builds JSON `trigger_conditions` that are transparently pre-compiled into ultra-fast, single-pass pure Python strings `compiled_expression` on Save to avoid runtime overhead.
+- **Node Execution State Management**: Real-time tracking of execution state across components for visualization and debugging.
+- **Compiled Runtime Registry**: Layered caching system (request-local → Redis → DB) for compiled rules and dependencies.
+- **Role-Based Execution Control**: `skip_for_roles` field to prevent rule execution for specific roles.
+- **Permission Audit Logging**: `skip_permissions` with audit reason for tracking bypassed permission checks.
+- **Watched Fields Optimization**: Automatic extraction and change-based filtering for event-driven rules.
+- **Comprehensive Error Handling**:
+    - Retry with exponential backoff
+    - Rollback with savepoints
+    - Escalate to caller
+    - Continue or Stop (default)
+- **Async Execution via Background Queues**: Offload long-running rules to background jobs.
+- **Timeout Protection**: Per-rule and per-action timeout limits.
+- **Asynchronous Execution Log Enqueuing**: Non-blocking persistence of execution traces.
+- **Graph Validation with Cycle Detection**: Prevents infinite loops with visit counting and iteration limits.
+- **Deterministic Graph Execution**: Zero ambiguity in execution order via Registry strategy pattern.
+- **Safety First**: Sandboxed execution via `SafeFrappeAPI`, savepoint rollbacks, and input validation.
 
 ---
 
@@ -176,16 +176,16 @@ Developers can extend FlexiRule by creating **Standard Processes**:
 
 FlexiRule provides a comprehensive set of whitelisted backend methods for programmatic interaction:
 
--   **`test_rule`** - Test rule execution with `dry_run` and `save_log` options
--   **`simulate_rule`** - Dry-run simulation without persisting logs
--   **`execute_rule`** - Manual/API execution of a rule
--   **`transition_rule`** - Lifecycle management (enable/disable rules)
--   **`get_execution_preview`** - Path prediction for rule execution
--   **`get_contract_dto`** - Frontend introspection of rule contracts
--   **`get_node_config_schema`** - Dynamic configuration schema generation
--   **`get_action_context_schema`** - Variable resolution context inspection
--   **`clone_rule`** / **`amend_rule`** - Rule versioning operations
--   **`get_rule_stats`** - Monitoring and performance metrics
+- **`test_rule`** - Test rule execution with `dry_run` and `save_log` options
+- **`simulate_rule`** - Dry-run simulation without persisting logs
+- **`execute_rule`** - Manual/API execution of a rule
+- **`transition_rule`** - Lifecycle management (enable/disable rules)
+- **`get_execution_preview`** - Path prediction for rule execution
+- **`get_contract_dto`** - Frontend introspection of rule contracts
+- **`get_node_config_schema`** - Dynamic configuration schema generation
+- **`get_action_context_schema`** - Variable resolution context inspection
+- **`clone_rule`** / **`amend_rule`** - Rule versioning operations
+- **`get_rule_stats`** - Monitoring and performance metrics
 
 All APIs are accessible via `frappe.call()` and follow standard Frappe whitelisted method conventions.
 
@@ -197,33 +197,33 @@ The FlexiRule codebase has undergone significant architectural improvements:
 
 ### Core Engine Enhancements
 
--   **Assignment Action (V2)**: Replaced legacy "Set Value" with a powerful batch assignment system supporting multiple operators (Set, Clear, Increment, Decrement, Append, Merge, Toggle).
--   **Condition System (V2)**: Introduced recursive collection logic (Any, All, None) and iterator aliases for complex child-table evaluations.
--   **Node Execution State Management**: Real-time tracking of execution state across components for visualization and debugging.
--   **Compiled Runtime Registry**: Layered caching system (request-local → Redis → DB) for compiled rules and dependencies.
--   **Graph Validation Improvements**: Enhanced cycle detection with visit counting and iteration limits.
--   **Async Execution Refinements**: Better background job handling and timeout protection.
+- **Assignment Action (V2)**: Replaced legacy "Set Value" with a powerful batch assignment system supporting multiple operators (Set, Clear, Increment, Decrement, Append, Merge, Toggle).
+- **Condition System (V2)**: Introduced recursive collection logic (Any, All, None) and iterator aliases for complex child-table evaluations.
+- **Node Execution State Management**: Real-time tracking of execution state across components for visualization and debugging.
+- **Compiled Runtime Registry**: Layered caching system (request-local → Redis → DB) for compiled rules and dependencies.
+- **Graph Validation Improvements**: Enhanced cycle detection with visit counting and iteration limits.
+- **Async Execution Refinements**: Better background job handling and timeout protection.
 
 ### Security & Reliability
 
--   **Permission Audit Logging**: `skip_permissions` with audit reason for tracking bypassed permission checks
--   **Role-Based Execution Control**: `skip_for_roles` field to prevent rule execution for specific roles
--   **Watched Fields Optimization**: Automatic extraction and change-based filtering for event-driven rules
--   **Comprehensive Error Handling**: Retry with exponential backoff, rollback with savepoints, escalate to caller
+- **Permission Audit Logging**: `skip_permissions` with audit reason for tracking bypassed permission checks
+- **Role-Based Execution Control**: `skip_for_roles` field to prevent rule execution for specific roles
+- **Watched Fields Optimization**: Automatic extraction and change-based filtering for event-driven rules
+- **Comprehensive Error Handling**: Retry with exponential backoff, rollback with savepoints, escalate to caller
 
 ### Developer Experience
 
--   **Dynamic Configuration Schemas**: Improved `get_node_config_schema` and `get_action_context_schema` APIs
--   **Extended Process Operation Metadata**: New fields like `writes_to`, `requires_doc`, `transactional`, `has_side_effect`, `config_schema`, `output_schema`, `action_overrides`
--   **Enhanced Rule Lifecycle APIs**: Better `clone_rule`, `amend_rule`, `transition_rule` functionality
--   **Improved Monitoring**: Enhanced `get_rule_stats` and execution tracing capabilities
+- **Dynamic Configuration Schemas**: Improved `get_node_config_schema` and `get_action_context_schema` APIs
+- **Extended Process Operation Metadata**: New fields like `writes_to`, `requires_doc`, `transactional`, `has_side_effect`, `config_schema`, `output_schema`, `action_overrides`
+- **Enhanced Rule Lifecycle APIs**: Better `clone_rule`, `amend_rule`, `transition_rule` functionality
+- **Improved Monitoring**: Enhanced `get_rule_stats` and execution tracing capabilities
 
 ### Frontend Improvements
 
--   **Vue 3 + Pinia Architecture**: Modular state management with 5 dedicated stores
--   **Real-time Execution Visualization**: `useNodeExecutionState` composable for test runs
--   **Enhanced Condition Builder**: Improved visual multi-condition builder with nested AND/OR groups
--   **Dynamic Control Factory**: Schema-driven UI generation for Process Operations
+- **Vue 3 + Pinia Architecture**: Modular state management with 5 dedicated stores
+- **Real-time Execution Visualization**: `useNodeExecutionState` composable for test runs
+- **Enhanced Condition Builder**: Improved visual multi-condition builder with nested AND/OR groups
+- **Dynamic Control Factory**: Schema-driven UI generation for Process Operations
 
 These changes solidify FlexiRule as a production-ready, enterprise-grade workflow automation platform for Frappe/ERPNext.
 
@@ -240,10 +240,10 @@ FlexiRule is evolving fast. Whether you are a developer, designer, or documenter
 
 ### How You Can Help
 
--   🐛 **Bug Reports**: Open an issue for any glitches.
--   💡 **Feature Requests**: Suggest new Nodes or Process Operations.
--   📖 **Documentation**: Help us clarify concepts or add examples.
--   🔧 **Pull Requests**: We welcome fixes, optimizations, and new features.
+- 🐛 **Bug Reports**: Open an issue for any glitches.
+- 💡 **Feature Requests**: Suggest new Nodes or Process Operations.
+- 📖 **Documentation**: Help us clarify concepts or add examples.
+- 🔧 **Pull Requests**: We welcome fixes, optimizations, and new features.
 
 Follow [Frappe Coding Standards](https://frappeframework.com/docs/v14/user/en/guidelines/coding-standards) and ensure all tests pass.
 
diff --git a/SECURITY.md b/SECURITY.md
index b9b2ddd9..7018e753 100644
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -4,7 +4,7 @@
 
 If you discover a security vulnerability in FlexiRule, please report it **privately**:
 
--   Email:
+- Email:
 
 Do **not** create a public issue for security vulnerabilities.
 
diff --git a/docs/CONTROLS.md b/docs/CONTROLS.md
index 0b8328bb..2a30c0dd 100644
--- a/docs/CONTROLS.md
+++ b/docs/CONTROLS.md
@@ -17,21 +17,21 @@ The `ValueResolverControl` is a "magic" input widget that allows users to define
 
 ### ✨ Key Features & Innovation
 
--   **Multi-Modal Formula Support:** A single token-based UI that can switch between:
-    -   **Date Formula:** Add/subtract days, weeks, months, or years from "Today" or a Document Field with sign-aware offsets.
-    -   **Math Formula:** Perform arithmetic operations between fields or constants with configurable decimal precision.
-    -   **Date Difference:** Calculate the span between two dates in days, months, or years (with intelligent month-to-year conversion).
-    -   **Child Table Aggregation:** Perform `SUM`, `AVG`, or `COUNT` operations on child table rows with zero-length safety (e.g., using `max(len(rows), 1)` for averages).
-    -   **String Manipulation:** Advanced concatenation, currency formatting, and case transformations (Upper/Lower).
-    -   **System Context:** Access session user data or perform role-based authorization checks directly within a value.
--   **Dynamic Expression Preview:** As the user configures the formula via the popover UI, a live Jinja-compatible expression snippet is generated and displayed at the bottom of the popover.
--   **Context-Aware Field Pickers:** Automatically filters and displays relevant document fields based on the selected formula type (e.g., only showing numeric fields for Math Formulas).
--   **Tokenized UI:** Displays a compact, icon-rich "token" in the form that summarizes the configured logic (e.g., "Today + 5 Days").
--   **Intelligent Viewport Positioning (Auto-Flipping):** The control automatically calculates available screen space. If there isn't enough room below the input, the configuration popover intelligently "flips" to appear above the token, ensuring the UI is never cut off by the browser window.
--   **Granular Category Filtering:** Developers can use the `allowedKinds` prop to restrict which formula categories are available. This is useful for specific fields where only "Date" or "Math" logic might be appropriate.
--   **Seamless Backwards Compatibility:** Includes a robust hydration layer that automatically migrates older rule schemas (like legacy `function_name` or `offset_days` fields) into the modern multi-mode format without user intervention.
--   **Deep Frappe Utility Integration:** The generated snippets leverage high-level Frappe Python utilities (e.g., `frappe.utils.add_to_date`, `frappe.utils.fmt_money`), ensuring the resulting logic is both powerful and standard-compliant.
--   **Intelligent Teleportation:** Uses Vue's `<Teleport to="body">` to escape `overflow: hidden` containers (like graph nodes or side panels) while maintaining correct z-index stacking.
+- **Multi-Modal Formula Support:** A single token-based UI that can switch between:
+    - **Date Formula:** Add/subtract days, weeks, months, or years from "Today" or a Document Field with sign-aware offsets.
+    - **Math Formula:** Perform arithmetic operations between fields or constants with configurable decimal precision.
+    - **Date Difference:** Calculate the span between two dates in days, months, or years (with intelligent month-to-year conversion).
+    - **Child Table Aggregation:** Perform `SUM`, `AVG`, or `COUNT` operations on child table rows with zero-length safety (e.g., using `max(len(rows), 1)` for averages).
+    - **String Manipulation:** Advanced concatenation, currency formatting, and case transformations (Upper/Lower).
+    - **System Context:** Access session user data or perform role-based authorization checks directly within a value.
+- **Dynamic Expression Preview:** As the user configures the formula via the popover UI, a live Jinja-compatible expression snippet is generated and displayed at the bottom of the popover.
+- **Context-Aware Field Pickers:** Automatically filters and displays relevant document fields based on the selected formula type (e.g., only showing numeric fields for Math Formulas).
+- **Tokenized UI:** Displays a compact, icon-rich "token" in the form that summarizes the configured logic (e.g., "Today + 5 Days").
+- **Intelligent Viewport Positioning (Auto-Flipping):** The control automatically calculates available screen space. If there isn't enough room below the input, the configuration popover intelligently "flips" to appear above the token, ensuring the UI is never cut off by the browser window.
+- **Granular Category Filtering:** Developers can use the `allowedKinds` prop to restrict which formula categories are available. This is useful for specific fields where only "Date" or "Math" logic might be appropriate.
+- **Seamless Backwards Compatibility:** Includes a robust hydration layer that automatically migrates older rule schemas (like legacy `function_name` or `offset_days` fields) into the modern multi-mode format without user intervention.
+- **Deep Frappe Utility Integration:** The generated snippets leverage high-level Frappe Python utilities (e.g., `frappe.utils.add_to_date`, `frappe.utils.fmt_money`), ensuring the resulting logic is both powerful and standard-compliant.
+- **Intelligent Teleportation:** Uses Vue's `<Teleport to="body">` to escape `overflow: hidden` containers (like graph nodes or side panels) while maintaining correct z-index stacking.
 
 ---
 
@@ -43,16 +43,16 @@ The `ResourceMapperControl` is a high-density mapping interface used to define h
 
 ### ✨ Key Features & Innovation
 
--   **Intelligent Auto-Mapping:** A "Magic" button that performs fuzzy matching between source and target field names, suggesting mappings and allowing users to review/delete them before applying.
--   **Recursive Mapping Support:** Handles both scalar (top-level) fields and complex child table mappings within a single unified interface.
--   **Source Context Versatility:** Allows mapping from various sources including `doc`, `old_doc`, `vars` (upstream node outputs), and loop iterators.
--   **Mixed-Mode Source Types:** Each field mapping can be defined as:
-    -   **Path:** A direct reference to a field in the source object.
-    -   **Expr:** A dynamic Jinja expression.
-    -   **Static:** A hardcoded literal value.
--   **Batch Operations:** Supports multi-select and bulk deletion of mappings to speed up configuration.
--   **Read-Only / No-Copy Detection:** Visually highlights fields that are read-only or marked as "No Copy" in the DocType metadata.
--   **Type Validation:** Highlights potential type mismatches (e.g., trying to map a text field to a numeric field).
+- **Intelligent Auto-Mapping:** A "Magic" button that performs fuzzy matching between source and target field names, suggesting mappings and allowing users to review/delete them before applying.
+- **Recursive Mapping Support:** Handles both scalar (top-level) fields and complex child table mappings within a single unified interface.
+- **Source Context Versatility:** Allows mapping from various sources including `doc`, `old_doc`, `vars` (upstream node outputs), and loop iterators.
+- **Mixed-Mode Source Types:** Each field mapping can be defined as:
+    - **Path:** A direct reference to a field in the source object.
+    - **Expr:** A dynamic Jinja expression.
+    - **Static:** A hardcoded literal value.
+- **Batch Operations:** Supports multi-select and bulk deletion of mappings to speed up configuration.
+- **Read-Only / No-Copy Detection:** Visually highlights fields that are read-only or marked as "No Copy" in the DocType metadata.
+- **Type Validation:** Highlights potential type mismatches (e.g., trying to map a text field to a numeric field).
 
 ---
 
@@ -64,14 +64,14 @@ A sophisticated rich-text editor based on Tiptap that seamlessly blends static t
 
 ### ✨ Key Features & Innovation
 
--   **Visual Logic Blocks:** Instead of writing complex Jinja tags ({% raw %}`{% if ... %}`{% endraw %}), users insert visual "Badges" for conditions and loops.
--   **Nested Recursive Editing:** Double-clicking a logic badge opens a "Bottom Panel" containing another instance of `TextGeneratorControl`, allowing users to define content for "IF TRUE", "ELSE", or "LOOP BODY" in a structured, hierarchical way.
--   **Slash Commands & Mentions:**
-    -   Typing `@` or {% raw %}`{{`{% endraw %} triggers a field picker for inserting dynamic variables.
-    -   Typing `/` opens a logic block picker.
--   **Live Jinja Synchronization:** Seamlessly toggles between a "Visual" mode and a "Raw Jinja" mode, ensuring compatibility for power users while maintaining simplicity for others.
--   **Context-Aware Iterators:** Inside a loop block, the variable picker automatically includes properties of the current loop item (e.g., `item.qty`).
--   **Live Preview:** Renders a sample of the generated Jinja template in real-time.
+- **Visual Logic Blocks:** Instead of writing complex Jinja tags ({% raw %}`{% if ... %}`{% endraw %}), users insert visual "Badges" for conditions and loops.
+- **Nested Recursive Editing:** Double-clicking a logic badge opens a "Bottom Panel" containing another instance of `TextGeneratorControl`, allowing users to define content for "IF TRUE", "ELSE", or "LOOP BODY" in a structured, hierarchical way.
+- **Slash Commands & Mentions:**
+    - Typing `@` or {% raw %}`{{`{% endraw %} triggers a field picker for inserting dynamic variables.
+    - Typing `/` opens a logic block picker.
+- **Live Jinja Synchronization:** Seamlessly toggles between a "Visual" mode and a "Raw Jinja" mode, ensuring compatibility for power users while maintaining simplicity for others.
+- **Context-Aware Iterators:** Inside a loop block, the variable picker automatically includes properties of the current loop item (e.g., `item.qty`).
+- **Live Preview:** Renders a sample of the generated Jinja template in real-time.
 
 ---
 
@@ -83,14 +83,14 @@ The `FlexStructuredValueControl` is a hybrid, single-line input field that seaml
 
 ### ✨ Key Features & Innovation
 
--   **Context-Aware Static Mode:** Automatically renders the appropriate Frappe control (Link, Select, Check, etc.) based on the target field's type.
--   **Tiptap-Powered Expression Mode:** A single-line rich-text editor that supports:
-    -   **@ Mentions:** For inserting document fields or context variables.
-    -   **Slash Commands (/):** A command palette for inserting advanced logic tokens like formulas, formatters, and localizations.
--   **Unified UI:** Users can switch between static input and dynamic expressions without leaving the field. Typing `@` or `/` in a static field automatically upgrades it to expression mode.
--   **Tokenized Logic Chips:** Advanced logic is represented as compact, color-coded "chips" (e.g., 🧮 Formula, 🎨 Format) that open a specialized configuration popover when clicked.
--   **Field-Type Intelligent Filtering:** The command palette (/) intelligently filters available logic tokens based on the field's data type (e.g., only showing currency formatting for numeric fields).
--   **Single-Line Constraint:** Custom Tiptap extensions ensure the editor remains a single line, ideal for grid-based configurations like the Assignment action.
+- **Context-Aware Static Mode:** Automatically renders the appropriate Frappe control (Link, Select, Check, etc.) based on the target field's type.
+- **Tiptap-Powered Expression Mode:** A single-line rich-text editor that supports:
+    - **@ Mentions:** For inserting document fields or context variables.
+    - **Slash Commands (/):** A command palette for inserting advanced logic tokens like formulas, formatters, and localizations.
+- **Unified UI:** Users can switch between static input and dynamic expressions without leaving the field. Typing `@` or `/` in a static field automatically upgrades it to expression mode.
+- **Tokenized Logic Chips:** Advanced logic is represented as compact, color-coded "chips" (e.g., 🧮 Formula, 🎨 Format) that open a specialized configuration popover when clicked.
+- **Field-Type Intelligent Filtering:** The command palette (/) intelligently filters available logic tokens based on the field's data type (e.g., only showing currency formatting for numeric fields).
+- **Single-Line Constraint:** Custom Tiptap extensions ensure the editor remains a single line, ideal for grid-based configurations like the Assignment action.
 
 ---
 
@@ -102,12 +102,12 @@ A visual "Spider-Web" style mapper for connecting two data schemas.
 
 ### ✨ Key Features & Innovation
 
--   **Visual Connectivity:** Uses SVG-based cubic bezier curves to draw connections between source (left) and target (right) tree nodes.
--   **Tree-Based Schema Explorer:** Handles deeply nested JSON schemas or DocType hierarchies with expandable/collapsible nodes.
--   **Drag-to-Connect:** Users can initiate a connection by clicking an anchor on a source field and "dropping" it onto a target field.
--   **Fuzzy Search & Filtering:** Both source and target columns have independent search bars to quickly locate fields in large schemas.
--   **Auto-Syncing Lines:** The mapping lines automatically recalculate and redraw as the user scrolls, expands nodes, or resizes the window.
--   **Standard Functions:** Includes built-in filters like `unique`, `sum`, `map`, and `filter`.
+- **Visual Connectivity:** Uses SVG-based cubic bezier curves to draw connections between source (left) and target (right) tree nodes.
+- **Tree-Based Schema Explorer:** Handles deeply nested JSON schemas or DocType hierarchies with expandable/collapsible nodes.
+- **Drag-to-Connect:** Users can initiate a connection by clicking an anchor on a source field and "dropping" it onto a target field.
+- **Fuzzy Search & Filtering:** Both source and target columns have independent search bars to quickly locate fields in large schemas.
+- **Auto-Syncing Lines:** The mapping lines automatically recalculate and redraw as the user scrolls, expands nodes, or resizes the window.
+- **Standard Functions:** Includes built-in filters like `unique`, `sum`, `map`, and `filter`.
 
 ---
 
@@ -119,11 +119,11 @@ A powerful, recursive interface for building complex boolean logic.
 
 ### ✨ Key Features & Innovation
 
--   **Nested Logic Groups:** Supports infinite nesting of AND/OR groups to create sophisticated logical branches.
--   **Drag-and-Drop Reordering:** Allows users to move conditions or entire groups between different levels of the hierarchy using a smooth drag-and-drop UX.
--   **Collection Queries:** Specialized "Collection" nodes allow checking conditions against child tables (e.g., "Check if ANY item in the table has a price > 100").
--   **Smart Operator Loading:** Dynamically fetches valid operators from the backend based on field types (e.g., `contains` for strings, `>` for numbers).
--   **Context-Aware Scoping:** Automatically manages variable aliases (like `doc` or `item`) depending on where the condition is being evaluated.
+- **Nested Logic Groups:** Supports infinite nesting of AND/OR groups to create sophisticated logical branches.
+- **Drag-and-Drop Reordering:** Allows users to move conditions or entire groups between different levels of the hierarchy using a smooth drag-and-drop UX.
+- **Collection Queries:** Specialized "Collection" nodes allow checking conditions against child tables (e.g., "Check if ANY item in the table has a price > 100").
+- **Smart Operator Loading:** Dynamically fetches valid operators from the backend based on field types (e.g., `contains` for strings, `>` for numbers).
+- **Context-Aware Scoping:** Automatically manages variable aliases (like `doc` or `item`) depending on where the condition is being evaluated.
 
 ---
 
@@ -135,12 +135,12 @@ A highly optimized replacement for the standard HTML select/autocomplete, tailor
 
 ### ✨ Key Features & Innovation
 
--   **Floating UI Portal:** Uses `Teleport` and `useFloatingDropdown` to ensure the dropdown menu is never clipped by parent containers or scroll areas.
--   **Multi-Source Loading:** Seamlessly handles local arrays, remote Frappe Link queries, and custom async data providers.
--   **Rich Option Rendering:** Supports icons, descriptions, and "Type Badges" for each option, making it easier to distinguish between different types of variables or fields.
--   **Button vs. Input Modes:** Can function as a standard autocomplete input or a compact "Button" trigger that opens a searchable popover.
--   **Keyboard Navigation:** Full support for arrow keys, Enter to select, and Escape to close, including type-ahead matching in button mode.
--   **Frappe Link Integration:** Can be configured to fetch options from any Frappe DocType via the standard `frappe.call` API.
+- **Floating UI Portal:** Uses `Teleport` and `useFloatingDropdown` to ensure the dropdown menu is never clipped by parent containers or scroll areas.
+- **Multi-Source Loading:** Seamlessly handles local arrays, remote Frappe Link queries, and custom async data providers.
+- **Rich Option Rendering:** Supports icons, descriptions, and "Type Badges" for each option, making it easier to distinguish between different types of variables or fields.
+- **Button vs. Input Modes:** Can function as a standard autocomplete input or a compact "Button" trigger that opens a searchable popover.
+- **Keyboard Navigation:** Full support for arrow keys, Enter to select, and Escape to close, including type-ahead matching in button mode.
+- **Frappe Link Integration:** Can be configured to fetch options from any Frappe DocType via the standard `frappe.call` API.
 
 ---
 
@@ -152,12 +152,12 @@ A high-performance filter builder used in `Query Records` and `Trigger Condition
 
 ### ✨ Key Features & Innovation
 
--   **Multi-Modal Value Input:** Allows switching between Literal values, Numbers, Boolean, Variables, Advanced Expressions, and an integrated **Formula Builder** (via `ValueResolverControl`).
--   **Context-Aware Operators:** Dynamically adjusts available operators based on the field type (e.g., `Before`/`After` for dates, `Starts With`/`Ends With` for text, and Tree-based operators like `Descendants Of`).
--   **Intelligent Field Picker:** Supports both parent fields and child table fields (e.g., `items.item_code`), providing a unified interface for deep data filtering.
--   **Enhanced Timespan Filtering:** Includes a "Timespan" operator with human-readable tokens (e.g., "Last 30 Days", "Next Quarter") that the engine automatically resolves to date ranges.
--   **Dynamic Field Validation:** Visually flags fields with a warning icon if they are no longer present in the DocType metadata (useful when DocTypes are modified after a rule is created).
--   **Themed UI Integration:** Automatically adopts the accent color of its parent action node (e.g., cyan for Query actions) using dynamic CSS variables.
+- **Multi-Modal Value Input:** Allows switching between Literal values, Numbers, Boolean, Variables, Advanced Expressions, and an integrated **Formula Builder** (via `ValueResolverControl`).
+- **Context-Aware Operators:** Dynamically adjusts available operators based on the field type (e.g., `Before`/`After` for dates, `Starts With`/`Ends With` for text, and Tree-based operators like `Descendants Of`).
+- **Intelligent Field Picker:** Supports both parent fields and child table fields (e.g., `items.item_code`), providing a unified interface for deep data filtering.
+- **Enhanced Timespan Filtering:** Includes a "Timespan" operator with human-readable tokens (e.g., "Last 30 Days", "Next Quarter") that the engine automatically resolves to date ranges.
+- **Dynamic Field Validation:** Visually flags fields with a warning icon if they are no longer present in the DocType metadata (useful when DocTypes are modified after a rule is created).
+- **Themed UI Integration:** Automatically adopts the accent color of its parent action node (e.g., cyan for Query actions) using dynamic CSS variables.
 
 ---
 
diff --git a/docs/_index.md b/docs/_index.md
index c5f366a7..5351d7fe 100644
--- a/docs/_index.md
+++ b/docs/_index.md
@@ -43,10 +43,10 @@ In modern enterprise systems like **Frappe / ERPNext**, business logic often evo
 
 ### 💎 Why FlexiRule?
 
--   **Centralized Logic**: Move rules out of scattered `.py` files into a single, auditable dashboard.
--   **No-Code Configuration**: Custom UI controls (pickers, autocomplete) allow complex logic setup without a single line of code.
--   **Explicit Execution**: Connections define deterministic paths. No more guessing which hook runs first.
--   **Schema-Driven UI**: Configuration forms for custom logic are auto-generated from JSON schemas.
+- **Centralized Logic**: Move rules out of scattered `.py` files into a single, auditable dashboard.
+- **No-Code Configuration**: Custom UI controls (pickers, autocomplete) allow complex logic setup without a single line of code.
+- **Explicit Execution**: Connections define deterministic paths. No more guessing which hook runs first.
+- **Schema-Driven UI**: Configuration forms for custom logic are auto-generated from JSON schemas.
 
 ### 🧠 The Mental Model
 
diff --git a/docs/actions/assignment.md b/docs/actions/assignment.md
index 1608c7db..d115240d 100644
--- a/docs/actions/assignment.md
+++ b/docs/actions/assignment.md
@@ -9,11 +9,11 @@ The **Assignment** action is a powerful tool for performing batch state mutation
 
 ## Key Features
 
--   **Batch Processing**: Define multiple mutations within a single action node.
--   **Dual-Mode Editor**: Seamlessly switch between a visual **Formula Resolver** (for dates, math, and aggregations) and a **Template Editor** (for rich text and complex Jinja logic).
--   **Conditional Execution**: Each assignment row can have its own **"Run If"** condition using the visual Condition Builder, allowing for granular control over which mutations are applied.
--   **Multiple Operators**: Beyond simple assignment, it supports math, list operations, and object merging.
--   **Path Validation**: Prevents accidental mutation of protected system paths.
+- **Batch Processing**: Define multiple mutations within a single action node.
+- **Dual-Mode Editor**: Seamlessly switch between a visual **Formula Resolver** (for dates, math, and aggregations) and a **Template Editor** (for rich text and complex Jinja logic).
+- **Conditional Execution**: Each assignment row can have its own **"Run If"** condition using the visual Condition Builder, allowing for granular control over which mutations are applied.
+- **Multiple Operators**: Beyond simple assignment, it supports math, list operations, and object merging.
+- **Path Validation**: Prevents accidental mutation of protected system paths.
 
 ## Value Editors
 
@@ -23,18 +23,18 @@ The Assignment action provides two modes for defining values:
 
 A "no-code" interface for common operations:
 
--   **Date Math**: `Today + 5 Days`, `doc.posting_date - 1 Month`.
--   **Numeric Calculations**: Basic math between fields or constants.
--   **Aggregations**: `SUM`, `AVG`, or `COUNT` of child table rows.
--   **String Helpers**: Concatenation, Case conversion, and Currency formatting.
+- **Date Math**: `Today + 5 Days`, `doc.posting_date - 1 Month`.
+- **Numeric Calculations**: Basic math between fields or constants.
+- **Aggregations**: `SUM`, `AVG`, or `COUNT` of child table rows.
+- **String Helpers**: Concatenation, Case conversion, and Currency formatting.
 
 ### 2. Template Editor
 
 A rich-text interface for:
 
--   **Jinja Templates**: Dynamic strings with full access to the execution context.
--   **Variable Insertion**: Easily pick fields from `doc` or `vars`.
--   **Manual Overrides**: Write custom logic when the visual resolver isn't enough.
+- **Jinja Templates**: Dynamic strings with full access to the execution context.
+- **Variable Insertion**: Easily pick fields from `doc` or `vars`.
+- **Manual Overrides**: Write custom logic when the visual resolver isn't enough.
 
 ## Operators
 
@@ -58,15 +58,15 @@ Assignments can target two primary scopes:
 
 Mutates fields on the document that triggered the rule.
 
--   **Root Fields**: `doc.status`, `doc.naming_series`.
--   **Note**: In V1, deep document path assignments for child tables (e.g., `doc.items.0.qty`) are not supported directly via this action.
+- **Root Fields**: `doc.status`, `doc.naming_series`.
+- **Note**: In V1, deep document path assignments for child tables (e.g., `doc.items.0.qty`) are not supported directly via this action.
 
 ### 2. Context Variables (`vars.*`)
 
 Mutates variables in the execution context.
 
--   **Nesting**: Supports deep paths like `vars.totals.tax_amount`.
--   **Auto-Initialization**: Intermediate dictionaries are created automatically if they don't exist.
+- **Nesting**: Supports deep paths like `vars.totals.tax_amount`.
+- **Auto-Initialization**: Intermediate dictionaries are created automatically if they don't exist.
 
 ## Configuration (JSON)
 
@@ -106,6 +106,6 @@ The configuration is stored as a JSON array of assignment objects. The engine ha
 
 ## Safety & Restrictions
 
--   **System Protection**: Mutations to paths starting with `meta.`, `frappe.`, `rule.`, or `caller.` are blocked.
--   **Event Awareness**: `doc.*` mutations are prohibited during `after_save` and other read-only events to prevent inconsistent states.
--   **Sandboxed Evaluation**: Values are evaluated using Jinja templates with a restricted `SafeFrappeAPI` context.
+- **System Protection**: Mutations to paths starting with `meta.`, `frappe.`, `rule.`, or `caller.` are blocked.
+- **Event Awareness**: `doc.*` mutations are prohibited during `after_save` and other read-only events to prevent inconsistent states.
+- **Sandboxed Evaluation**: Values are evaluated using Jinja templates with a restricted `SafeFrappeAPI` context.
diff --git a/docs/actions/condition.md b/docs/actions/condition.md
index 84ff3609..5c7c7c86 100644
--- a/docs/actions/condition.md
+++ b/docs/actions/condition.md
@@ -11,17 +11,17 @@ The **Condition** action allows for branching execution logic based on the evalu
 
 Conditions are built using the visual Condition Builder (V2), which supports:
 
--   **Hierarchical Grouping**: Combine conditions using `AND` and `OR` logic.
--   **Recursive Collection Logic**: Evaluate child tables or lists using `Any`, `All`, or `None` criteria.
--   **Iterator Aliases**: Define custom aliases for nested loop contexts to avoid variable collisions.
--   **Drag-and-Drop**: Easily restructure logic by dragging conditions between groups.
+- **Hierarchical Grouping**: Combine conditions using `AND` and `OR` logic.
+- **Recursive Collection Logic**: Evaluate child tables or lists using `Any`, `All`, or `None` criteria.
+- **Iterator Aliases**: Define custom aliases for nested loop contexts to avoid variable collisions.
+- **Drag-and-Drop**: Easily restructure logic by dragging conditions between groups.
 
 ## Execution
 
--   **Compiled Logic**: Design-time JSON is compiled into an optimized Python string for runtime execution.
--   **Branches**:
-    -   `True`: Followed if the condition evaluates to true.
-    -   `False`: Followed if the condition evaluates to false.
+- **Compiled Logic**: Design-time JSON is compiled into an optimized Python string for runtime execution.
+- **Branches**:
+    - `True`: Followed if the condition evaluates to true.
+    - `False`: Followed if the condition evaluates to false.
 
 ## Context Access
 
diff --git a/docs/actions/document_action.md b/docs/actions/document_action.md
index 4c272dc0..520537f6 100644
--- a/docs/actions/document_action.md
+++ b/docs/actions/document_action.md
@@ -9,17 +9,17 @@ The **Document Action** node allows rules to interact with the lifecycle of any
 
 ## Supported Operations
 
--   **Create New**: Generates a new document and populates its fields.
--   **Update Existing**: Modifies fields on a specific record identified by name.
--   **Delete Record**: Permanently removes a document.
--   **Create ToDo**: Assigns a task to a user related to the current context.
--   **Add Comment**: Posts a comment to the document's timeline.
+- **Create New**: Generates a new document and populates its fields.
+- **Update Existing**: Modifies fields on a specific record identified by name.
+- **Delete Record**: Permanently removes a document.
+- **Create ToDo**: Assigns a task to a user related to the current context.
+- **Add Comment**: Posts a comment to the document's timeline.
 
 ## Configuration
 
--   **Target DocType**: The DocType to act upon.
--   **Target Record**: (For Update/Delete) The specific document name.
--   **Data Mapping**: A visual interface for mapping context variables or Jinja templates to the target document's fields.
+- **Target DocType**: The DocType to act upon.
+- **Target Record**: (For Update/Delete) The specific document name.
+- **Data Mapping**: A visual interface for mapping context variables or Jinja templates to the target document's fields.
 
 ## Safety
 
diff --git a/docs/actions/loop.md b/docs/actions/loop.md
index a8a0b64e..9c6eab28 100644
--- a/docs/actions/loop.md
+++ b/docs/actions/loop.md
@@ -9,19 +9,19 @@ The **Loop** action enables iterative processing of collections, such as child t
 
 ## Configuration
 
--   **Iterator**: A reference to the collection to iterate over (e.g., `doc.items` or `vars.query_results`).
--   **Item Alias**: The name to use for the current item inside the loop body (e.g., `row`).
+- **Iterator**: A reference to the collection to iterate over (e.g., `doc.items` or `vars.query_results`).
+- **Item Alias**: The name to use for the current item inside the loop body (e.g., `row`).
 
 ## Execution Flow
 
--   **For Each**: This path is followed for every item in the collection. The `Item Alias` is updated with the current record at each step.
--   **After Last**: This path is followed once the collection has been fully processed.
+- **For Each**: This path is followed for every item in the collection. The `Item Alias` is updated with the current record at each step.
+- **After Last**: This path is followed once the collection has been fully processed.
 
 ## Meta Variables
 
 Inside a loop, the engine provides automatic metadata:
 
--   `vars.loop.index`: The current iteration number (starting at 0).
--   `vars.loop.length`: The total number of items in the collection.
--   `vars.loop.first`: `True` if it's the first iteration.
--   `vars.loop.last`: `True` if it's the last iteration.
+- `vars.loop.index`: The current iteration number (starting at 0).
+- `vars.loop.length`: The total number of items in the collection.
+- `vars.loop.first`: `True` if it's the first iteration.
+- `vars.loop.last`: `True` if it's the last iteration.
diff --git a/docs/actions/notify.md b/docs/actions/notify.md
index 05fe93a8..881a4fcd 100644
--- a/docs/actions/notify.md
+++ b/docs/actions/notify.md
@@ -9,10 +9,10 @@ The **Notify** action sends alerts and communications to users or external syste
 
 ## Notification Channels
 
--   **Toast**: A temporary browser notification that appears in the Frappe UI.
--   **System Notification**: A permanent entry in the user's notification log.
--   **Email**: Sends an email via Frappe's email queue.
--   **External Provider**: Dispatches a notification through a custom registered provider (e.g., SMS, Slack).
+- **Toast**: A temporary browser notification that appears in the Frappe UI.
+- **System Notification**: A permanent entry in the user's notification log.
+- **Email**: Sends an email via Frappe's email queue.
+- **External Provider**: Dispatches a notification through a custom registered provider (e.g., SMS, Slack).
 
 ## Content
 
@@ -22,6 +22,6 @@ All fields (Subject, Message, Recipients) support Jinja templates, allowing for
 
 Notifications are commonly used for:
 
--   Informing a manager of a pending approval.
--   Alerting a user about a validation error or a successful background process.
--   Sending transaction summaries to customers.
+- Informing a manager of a pending approval.
+- Alerting a user about a validation error or a successful background process.
+- Sending transaction summaries to customers.
diff --git a/docs/actions/overview.md b/docs/actions/overview.md
index ec49d472..c232bd58 100644
--- a/docs/actions/overview.md
+++ b/docs/actions/overview.md
@@ -31,31 +31,31 @@ FlexiRule provides a variety of action types, each represented as a node in the
 
 Executes reusable business logic defined in a `Process` DocType. This is the primary way to extend FlexiRule with custom Python code.
 
--   **Inputs**: Defined by the Operation's `config_schema`.
--   **Outputs**: Defined by the Operation's `output_schema`.
--   **Mutation Logic**: Processes are designed to be side-effect free. They return results (data) or explicit **Mutation Intents**. The Rule Engine is responsible for applying these changes (e.g., updating a document field or context variable) based on the **Mutation Mode** selected by the rule designer.
+- **Inputs**: Defined by the Operation's `config_schema`.
+- **Outputs**: Defined by the Operation's `output_schema`.
+- **Mutation Logic**: Processes are designed to be side-effect free. They return results (data) or explicit **Mutation Intents**. The Rule Engine is responsible for applying these changes (e.g., updating a document field or context variable) based on the **Mutation Mode** selected by the rule designer.
 
 ### **Assignment**
 
 Updates a document field or a context variable using a suite of operators. This action replaces the legacy **Set Value** action.
 
--   **Batching**: Allows multiple assignments in a single node.
--   **Operators**: Supports `Set`, `Clear`, `Increment`, `Decrement`, `Append`, `Merge`, and `Toggle`.
--   **Validation**: Strict path protection and event-based mutation blocking.
+- **Batching**: Allows multiple assignments in a single node.
+- **Operators**: Supports `Set`, `Clear`, `Increment`, `Decrement`, `Append`, `Merge`, and `Toggle`.
+- **Validation**: Strict path protection and event-based mutation blocking.
 
 ### **Query Records**
 
 Retrieves data from the database.
 
--   **Operations**: `Query List`, `Query Doc`, `Exist Record`, `Count`, `Sum`, `Average`, `Min`, `Max`, `Group By`.
--   **Filters**: Visual filter builder with support for dynamic variable values.
+- **Operations**: `Query List`, `Query Doc`, `Exist Record`, `Count`, `Sum`, `Average`, `Min`, `Max`, `Group By`.
+- **Filters**: Visual filter builder with support for dynamic variable values.
 
 ### **Document Action**
 
 Standard CRUD and social operations on DocTypes.
 
--   **Operations**: `Create New`, `Update Existing`, `Delete Record`, `Create ToDo`, `Add Comment`.
--   **Mappings**: Direct mapping of data to fields.
+- **Operations**: `Create New`, `Update Existing`, `Delete Record`, `Create ToDo`, `Add Comment`.
+- **Mappings**: Direct mapping of data to fields.
 
 ---
 
@@ -65,15 +65,15 @@ Standard CRUD and social operations on DocTypes.
 
 Communicates with the user or external systems.
 
--   **Channels**: `Toast`, `System Notification`, `Email`, `External Provider`.
--   **Dynamic Content**: Uses Jinja templates for subjects and messages.
+- **Channels**: `Toast`, `System Notification`, `Email`, `External Provider`.
+- **Dynamic Content**: Uses Jinja templates for subjects and messages.
 
 ### **Stop**
 
 The final node of a path.
 
--   **Success**: Ends execution and marks the path as successful.
--   **Error**: Aborts the current operation and raises a custom error message to the user.
+- **Success**: Ends execution and marks the path as successful.
+- **Error**: Aborts the current operation and raises a custom error message to the user.
 
 ### **Raise Error**
 
@@ -87,10 +87,10 @@ Immediately terminates the rule by throwing a Python exception. Used for strict
 
 Every action type is governed by a **Contract** defined in `flexirule/ruleflow/core/contracts.py`. This contract specifies:
 
--   Required configuration fields.
--   Available outgoing handles (True/False/Default).
--   Allowed **Mutation Modes** (e.g., whether it can update the document).
--   Expected **Return Types**.
+- Required configuration fields.
+- Available outgoing handles (True/False/Default).
+- Allowed **Mutation Modes** (e.g., whether it can update the document).
+- Expected **Return Types**.
 
 ### **Action Handlers**
 
diff --git a/docs/actions/process.md b/docs/actions/process.md
index 1a5fed13..37146132 100644
--- a/docs/actions/process.md
+++ b/docs/actions/process.md
@@ -9,24 +9,24 @@ The **Process** action is the primary way to extend FlexiRule with custom Python
 
 ## Key Features
 
--   **Reusability**: Define logic once in a Process module and use it across multiple rules.
--   **Configurable**: Uses JSON Schemas to generate a custom configuration UI in the Rule Builder.
--   **Side-Effect Free**: Following the **Mutation Intent Architecture**, Processes should return data rather than directly modifying the database.
+- **Reusability**: Define logic once in a Process module and use it across multiple rules.
+- **Configurable**: Uses JSON Schemas to generate a custom configuration UI in the Rule Builder.
+- **Side-Effect Free**: Following the **Mutation Intent Architecture**, Processes should return data rather than directly modifying the database.
 
 ## Configuration
 
--   **Process**: Select the target Process DocType.
--   **Operation**: Choose the specific function within that Process to execute.
--   **Config**: Provide inputs as defined by the operation's `config_schema`.
+- **Process**: Select the target Process DocType.
+- **Operation**: Choose the specific function within that Process to execute.
+- **Config**: Provide inputs as defined by the operation's `config_schema`.
 
 ## Mutation Mode
 
 After the Process executes, the Rule Engine applies the result based on the selected **Mutation Mode**:
 
--   `Set Context Variable`: Stores the result in the `vars` dictionary.
--   `Set Doc Field`: Updates a field on the primary document.
--   `Update Doc Field`: Merges a dictionary result into the document's fields.
--   `Batch Database Set`: Directly updates the database for performance (bypasses ORM).
+- `Set Context Variable`: Stores the result in the `vars` dictionary.
+- `Set Doc Field`: Updates a field on the primary document.
+- `Update Doc Field`: Merges a dictionary result into the document's fields.
+- `Batch Database Set`: Directly updates the database for performance (bypasses ORM).
 
 ## Standards
 
diff --git a/docs/actions/query_records.md b/docs/actions/query_records.md
index 032f79a8..efa0dd65 100644
--- a/docs/actions/query_records.md
+++ b/docs/actions/query_records.md
@@ -9,11 +9,11 @@ The **Query Records** action retrieves data from any DocType in the system.
 
 ## Query Modes
 
--   **Query List**: Returns a list of records matching the filters.
--   **Query Doc**: Returns a single record by name or ID.
--   **Exist Record**: Returns `True` or `False` based on whether matching records exist.
--   **Aggregate Operations**: `Count`, `Sum`, `Average`, `Min`, `Max`.
--   **Group By**: Returns aggregated results grouped by a specific field.
+- **Query List**: Returns a list of records matching the filters.
+- **Query Doc**: Returns a single record by name or ID.
+- **Exist Record**: Returns `True` or `False` based on whether matching records exist.
+- **Aggregate Operations**: `Count`, `Sum`, `Average`, `Min`, `Max`.
+- **Group By**: Returns aggregated results grouped by a specific field.
 
 ## Filters
 
diff --git a/docs/actions/standards.md b/docs/actions/standards.md
index 9377da84..d8a16f39 100644
--- a/docs/actions/standards.md
+++ b/docs/actions/standards.md
@@ -13,26 +13,26 @@ Processes are the primary extensibility point for FlexiRule. A **Process** is a
 
 Create a `Process` document in Frappe.
 
--   Set a **Unique Name** (e.g., `Financial Utils`).
--   Check **Is Standard** if you want Frappe to generate boilerplate code in your app.
+- Set a **Unique Name** (e.g., `Financial Utils`).
+- Check **Is Standard** if you want Frappe to generate boilerplate code in your app.
 
 ### 2. Operations Child Table
 
 Define each function in the Operations table:
 
--   **Function Name**: The exact name of the Python function.
--   **Icon/Color**: Visual cues for the builder.
--   **Contract Settings**:
-    -   **Writes To**: `Document`, `Database`, `Context`, or `None`. This defines the _intent_ of the operation.
-    -   **Requires Doc**: Does the function need a Frappe document to work?
-    -   **Transactional**: Should this operation be wrapped in a database savepoint?
+- **Function Name**: The exact name of the Python function.
+- **Icon/Color**: Visual cues for the builder.
+- **Contract Settings**:
+    - **Writes To**: `Document`, `Database`, `Context`, or `None`. This defines the _intent_ of the operation.
+    - **Requires Doc**: Does the function need a Frappe document to work?
+    - **Transactional**: Should this operation be wrapped in a database savepoint?
 
 ### 3. Schemas (JSON)
 
 Schemas define the UI for your operation.
 
--   **Config Schema**: Defines the inputs (e.g., `limit`, `status`). Use standard JSON Schema with custom `ui_schema` extensions.
--   **Output Schema**: Defines what the function returns. This allows the builder to provide autocomplete for the result.
+- **Config Schema**: Defines the inputs (e.g., `limit`, `status`). Use standard JSON Schema with custom `ui_schema` extensions.
+- **Output Schema**: Defines what the function returns. This allows the builder to provide autocomplete for the result.
 
 ---
 
@@ -64,11 +64,11 @@ class MyProcess:
 
 ### Best Practices
 
--   **Mutation Intent Architecture**: Processes should not perform direct mutations on the database or the document. Instead, they should return data. The Rule Engine applies these changes based on the **Mutation Mode** configured by the rule designer in the builder.
--   **Idempotency**: Operations should be designed so that re-executing them (on retry) is safe.
--   **Context Awareness**: Use `context.get('vars')` to access intermediate data from previous steps.
--   **Result Format**: Always return a serializable value (dict, list, int, str, bool).
--   **Error Handling**: Raise `frappe.ValidationError` for business logic errors; the engine will handle logging and the `on_error` policy.
+- **Mutation Intent Architecture**: Processes should not perform direct mutations on the database or the document. Instead, they should return data. The Rule Engine applies these changes based on the **Mutation Mode** configured by the rule designer in the builder.
+- **Idempotency**: Operations should be designed so that re-executing them (on retry) is safe.
+- **Context Awareness**: Use `context.get('vars')` to access intermediate data from previous steps.
+- **Result Format**: Always return a serializable value (dict, list, int, str, bool).
+- **Error Handling**: Raise `frappe.ValidationError` for business logic errors; the engine will handle logging and the `on_error` policy.
 
 ---
 
@@ -76,5 +76,5 @@ class MyProcess:
 
 If your process requires custom UI components (e.g., a special map picker), you can define a `.js` file for your process.
 
--   FlexiRule automatically loads these scripts when the process is selected in the builder.
--   You can register custom control components to be used in the node configuration sidebar.
+- FlexiRule automatically loads these scripts when the process is selected in the builder.
+- You can register custom control components to be used in the node configuration sidebar.
diff --git a/docs/actions/switch.md b/docs/actions/switch.md
index 319f1d83..9ac46702 100644
--- a/docs/actions/switch.md
+++ b/docs/actions/switch.md
@@ -9,9 +9,9 @@ The **Switch** action enables multi-path branching based on the value of an expr
 
 ## Configuration
 
--   **Expression**: A Python expression that evaluates to a value (e.g., `doc.status` or `vars.category`).
--   **Cases**: A mapping of expected values to target Action IDs.
--   **Default Path**: If no case matches the expression's value, execution follows the `next_step_if_false` (labeled as "Default" in the UI) path.
+- **Expression**: A Python expression that evaluates to a value (e.g., `doc.status` or `vars.category`).
+- **Cases**: A mapping of expected values to target Action IDs.
+- **Default Path**: If no case matches the expression's value, execution follows the `next_step_if_false` (labeled as "Default" in the UI) path.
 
 ## Execution Logic
 
@@ -22,6 +22,6 @@ The **Switch** action enables multi-path branching based on the value of an expr
 
 ## Use Cases
 
--   **Document Routing**: Direct a document to different approval paths based on its status.
--   **Category Handling**: Apply different logic based on a "Type" or "Category" field without nesting multiple `Condition` nodes.
--   **Error Code Handling**: Branch execution based on the specific result of a `Process` or `Query` action.
+- **Document Routing**: Direct a document to different approval paths based on its status.
+- **Category Handling**: Apply different logic based on a "Type" or "Category" field without nesting multiple `Condition` nodes.
+- **Error Code Handling**: Branch execution based on the specific result of a `Process` or `Query` action.
diff --git a/docs/architecture.md b/docs/architecture.md
index 1d035dde..e93b5e8c 100644
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -62,15 +62,15 @@ FlexiRule uses several Frappe DocTypes to maintain rules, processes, and audit t
 
 The system includes a built-in technical audit mechanism to ensure rule integrity:
 
--   **Graph Validation**: Prevents disconnected nodes, cycles, and invalid exit paths.
--   **Contract Enforcement**: Ensures action configurations match the backend expectations defined in `contracts.py`.
--   **Pre-Activation Check**: A full validation suite runs automatically before a rule can be transitioned to "Active" status.
+- **Graph Validation**: Prevents disconnected nodes, cycles, and invalid exit paths.
+- **Contract Enforcement**: Ensures action configurations match the backend expectations defined in `contracts.py`.
+- **Pre-Activation Check**: A full validation suite runs automatically before a rule can be transitioned to "Active" status.
 
 ---
 
 ## Integration with Frappe
 
--   **Doc Events**: Rules are hooked into the standard Frappe lifecycle via `hooks.py`.
--   **Background Jobs**: Asynchronous rules are offloaded using `frappe.enqueue`.
--   **Distributed Caching**: Uses Frappe's Redis cache and Realtime events to synchronize rule states across multiple web workers.
--   **Security**: Execution is sandboxed using `SafeFrappeAPI` and `frappe.safe_eval`.
+- **Doc Events**: Rules are hooked into the standard Frappe lifecycle via `hooks.py`.
+- **Background Jobs**: Asynchronous rules are offloaded using `frappe.enqueue`.
+- **Distributed Caching**: Uses Frappe's Redis cache and Realtime events to synchronize rule states across multiple web workers.
+- **Security**: Execution is sandboxed using `SafeFrappeAPI` and `frappe.safe_eval`.
diff --git a/docs/builder/condition_builder.md b/docs/builder/condition_builder.md
index 42fe5dc8..a1dd289e 100644
--- a/docs/builder/condition_builder.md
+++ b/docs/builder/condition_builder.md
@@ -33,17 +33,17 @@ A specialized interface for evaluating logic across child tables. It allows user
 
 The leaf node component where actual comparisons are defined. It includes:
 
--   **Context Picker**: To select fields from `doc`, `old_doc`, or loop aliases.
--   **Operator Dropdown**: Dynamically filtered based on the selected field's type (e.g., showing "Contains" for strings but ">" for numbers).
--   **Value Input**: Uses `FlexStructuredValueControl` to allow both literal values and dynamic expressions.
+- **Context Picker**: To select fields from `doc`, `old_doc`, or loop aliases.
+- **Operator Dropdown**: Dynamically filtered based on the selected field's type (e.g., showing "Contains" for strings but ">" for numbers).
+- **Value Input**: Uses `FlexStructuredValueControl` to allow both literal values and dynamic expressions.
 
 ---
 
 ## State Management & Synchronization
 
--   **JSON AST**: The builder maintains a single reactive JSON object representing the entire logic tree.
--   **UUIDs**: Every node in the tree is assigned a unique ID upon creation. This is critical for the **Drag-and-Drop** system to track nodes as they are moved between groups.
--   **Reactivity**: Any change in a leaf node (e.g., changing an operator) bubbles up through the reactive state, which the parent `RuleConfigModal` then syncs to the Rule DocType.
+- **JSON AST**: The builder maintains a single reactive JSON object representing the entire logic tree.
+- **UUIDs**: Every node in the tree is assigned a unique ID upon creation. This is critical for the **Drag-and-Drop** system to track nodes as they are moved between groups.
+- **Reactivity**: Any change in a leaf node (e.g., changing an operator) bubbles up through the reactive state, which the parent `RuleConfigModal` then syncs to the Rule DocType.
 
 ## Logical Grouping & Operators
 
@@ -53,8 +53,8 @@ FlexiRule supports sophisticated logical grouping to handle complex business req
 
 Each group (including the root) has a logical operator toggle.
 
--   **AND**: All conditions within the group must evaluate to True.
--   **OR**: At least one condition within the group must evaluate to True.
+- **AND**: All conditions within the group must evaluate to True.
+- **OR**: At least one condition within the group must evaluate to True.
 
 ### Infinite Nesting
 
@@ -73,20 +73,20 @@ The builder implements a custom drag-and-drop layer to allow reordering and re-g
 
 Users can grab any condition or entire group by its drag handle and move it:
 
--   **Reordering**: Dragging a node up or down within the same group.
--   **Nesting**: Dragging a node into a different group or collection.
--   **Promoting**: Dragging a node out of a nested group back to a parent level.
+- **Reordering**: Dragging a node up or down within the same group.
+- **Nesting**: Dragging a node into a different group or collection.
+- **Promoting**: Dragging a node out of a nested group back to a parent level.
 
 ### Technical Implementation & Safety
 
--   **UUID-Based Tracking**: Every node has a unique `id`. The `moveNode(fromGroup, fromIndex, toGroup, toIndex)` method uses these IDs to safely splice nodes out of their source array and into their target destination.
--   **AST Integrity**: When a node is moved, its entire subtree in the JSON AST is moved with it. The `ConditionCompiler` then automatically handles the structural change upon the next save, regenerating the Python expression based on the new hierarchy.
--   **Illegal Move Prevention**: The system includes a recursive `isDescendantOf(parent, targetId)` check. This prevents a user from accidentally dropping a parent group into one of its own children, which would cause a circular reference and crash the builder.
--   **Visual Feedback**: Real-time "drop zone" highlighting shows exactly where a node will land.
--   **Smooth Transitions**: Uses Vue's `<TransitionGroup>` to animate nodes as they are added, removed, or moved.
+- **UUID-Based Tracking**: Every node has a unique `id`. The `moveNode(fromGroup, fromIndex, toGroup, toIndex)` method uses these IDs to safely splice nodes out of their source array and into their target destination.
+- **AST Integrity**: When a node is moved, its entire subtree in the JSON AST is moved with it. The `ConditionCompiler` then automatically handles the structural change upon the next save, regenerating the Python expression based on the new hierarchy.
+- **Illegal Move Prevention**: The system includes a recursive `isDescendantOf(parent, targetId)` check. This prevents a user from accidentally dropping a parent group into one of its own children, which would cause a circular reference and crash the builder.
+- **Visual Feedback**: Real-time "drop zone" highlighting shows exactly where a node will land.
+- **Smooth Transitions**: Uses Vue's `<TransitionGroup>` to animate nodes as they are added, removed, or moved.
 
 ## Keyboard Shortcuts & Accessibility
 
--   **Focus Management**: When a new condition is added, focus is automatically shifted to the field picker.
--   **ARIA Labels**: All icon buttons include descriptive ARIA labels for screen readers.
--   **Standard Controls**: Uses standard HTML input types where possible to ensure native browser accessibility features work as expected.
+- **Focus Management**: When a new condition is added, focus is automatically shifted to the field picker.
+- **ARIA Labels**: All icon buttons include descriptive ARIA labels for screen readers.
+- **Standard Controls**: Uses standard HTML input types where possible to ensure native browser accessibility features work as expected.
diff --git a/docs/builder/frontend_technical.md b/docs/builder/frontend_technical.md
index 19509d4a..e342299d 100644
--- a/docs/builder/frontend_technical.md
+++ b/docs/builder/frontend_technical.md
@@ -19,8 +19,8 @@ The builder manages three distinct layers of state:
 
 Because Frappe child tables are linear (indexed), but Rule logic is a graph, we must ensure that actions are stored in a logical sequence. Before saving, `useRuleStore` calls a topological sort algorithm:
 
--   **Algorithm**: Breadth-First Search (BFS) starting from the `Entry Action`.
--   **Purpose**: Ensures that when the Rule Engine loads the rule sequentially from the database, nodes that depend on upstream results are generally loaded after their dependencies, facilitating faster registry hydration.
+- **Algorithm**: Breadth-First Search (BFS) starting from the `Entry Action`.
+- **Purpose**: Ensures that when the Rule Engine loads the rule sequentially from the database, nodes that depend on upstream results are generally loaded after their dependencies, facilitating faster registry hydration.
 
 ---
 
@@ -30,8 +30,8 @@ Because Frappe child tables are linear (indexed), but Rule logic is a graph, we
 
 The `SchemaRenderer` component takes a backend JSON schema and iterates through its properties. For each property, it uses the `ControlFactory` to mount a Vue component:
 
--   **Reactivity**: Every control emits a `change` event that triggers a re-validation of the entire node's schema.
--   **Awareness**: Controls like `FieldPicker` use the `getAvailableVariables` algorithm to traverse the graph and provide real-time suggestions.
+- **Reactivity**: Every control emits a `change` event that triggers a re-validation of the entire node's schema.
+- **Awareness**: Controls like `FieldPicker` use the `getAvailableVariables` algorithm to traverse the graph and provide real-time suggestions.
 
 ### Variable Resolution Algorithm
 
@@ -46,5 +46,5 @@ Implemented in `useGraphStore.getAvailableVariables`, this is the heart of the b
 
 ## Performance & Optimization
 
--   **Snapshot-based History**: Undo/Redo is implemented by taking full snapshots of the `nodes` and `edges` arrays. To optimize memory, consecutive identical states are deduplicated.
--   **Metadata Caching**: `useMetaStore` maintains a request-level cache of DocType schemas to prevent redundant `get_doctype_fields` API calls while the user is designing.
+- **Snapshot-based History**: Undo/Redo is implemented by taking full snapshots of the `nodes` and `edges` arrays. To optimize memory, consecutive identical states are deduplicated.
+- **Metadata Caching**: `useMetaStore` maintains a request-level cache of DocType schemas to prevent redundant `get_doctype_fields` API calls while the user is designing.
diff --git a/docs/builder/rule_builder.md b/docs/builder/rule_builder.md
index b8d6f97e..afafdc69 100644
--- a/docs/builder/rule_builder.md
+++ b/docs/builder/rule_builder.md
@@ -13,9 +13,9 @@ The Rule Builder is a Vue 3-based visual workspace for designing business logic
 
 Each node in the graph represents a **Rule Action**.
 
--   **Entry Action**: The starting point. Defines trigger criteria.
--   **Functional Nodes**: Perform work (Process, Assignment, Query Records, Document Action, Notify).
--   **Control Nodes**: Manage flow (Condition, Loop, Switch, Wait, Stop, Raise Error).
+- **Entry Action**: The starting point. Defines trigger criteria.
+- **Functional Nodes**: Perform work (Process, Assignment, Query Records, Document Action, Notify).
+- **Control Nodes**: Manage flow (Condition, Loop, Switch, Wait, Stop, Raise Error).
 
 ---
 
@@ -27,18 +27,18 @@ A primary goal of the Rule Builder is to eliminate error-prone manual input by p
 
 One of the core safety features of the builder is **Temporal Context Isolation**. At design-time, the builder ensures that an action can only access variables that are logically available at its point in the execution flow.
 
--   **Upstream-Only Visibility**: The field picker _only_ displays variables created or updated by **upstream nodes** (nodes that execute before the current one).
--   **Isolation from the Future**: A node cannot "see" or reference variables that are created or updated by actions that come after it in the graph.
--   **Dynamic Schema Switching**: When a node points to a different record (e.g., in a `Query Records` action), the picker automatically switches to the schema of that reference DocType, while maintaining access to all valid upstream context.
+- **Upstream-Only Visibility**: The field picker _only_ displays variables created or updated by **upstream nodes** (nodes that execute before the current one).
+- **Isolation from the Future**: A node cannot "see" or reference variables that are created or updated by actions that come after it in the graph.
+- **Dynamic Schema Switching**: When a node points to a different record (e.g., in a `Query Records` action), the picker automatically switches to the schema of that reference DocType, while maintaining access to all valid upstream context.
 
 ### Reactive & Type-Aware Controls
 
 The builder's input controls are highly reactive and understand the **FieldType** of the selected data.
 
--   **Intelligent Filter Builder (`FilterGroup`)**: Used in Query and Condition nodes, it dynamically adapts operators based on field types and supports advanced **Timespan** tokens (e.g., "Last Week").
--   **Magic Formula Builder (`ValueResolver`)**: Allows defining complex logic (Date math, Aggregations, String manipulation) via a guided UI that generates safe Jinja snippets.
--   **Automatic Validation**: If a user selects a Date field (`posting_date`), the system ensures the comparison value is a date, preventing invalid configurations like `posting_date == "Yes"`.
--   **Dynamic Operator Filtering**: Available operators (e.g., `Greater Than`, `Contains`) change based on the data type (numeric, string, or collection).
+- **Intelligent Filter Builder (`FilterGroup`)**: Used in Query and Condition nodes, it dynamically adapts operators based on field types and supports advanced **Timespan** tokens (e.g., "Last Week").
+- **Magic Formula Builder (`ValueResolver`)**: Allows defining complex logic (Date math, Aggregations, String manipulation) via a guided UI that generates safe Jinja snippets.
+- **Automatic Validation**: If a user selects a Date field (`posting_date`), the system ensures the comparison value is a date, preventing invalid configurations like `posting_date == "Yes"`.
+- **Dynamic Operator Filtering**: Available operators (e.g., `Greater Than`, `Contains`) change based on the data type (numeric, string, or collection).
 
 ---
 
@@ -46,13 +46,13 @@ The builder's input controls are highly reactive and understand the **FieldType*
 
 ### 1. The Canvas (VueFlow)
 
--   **Auto-Layout**: Automatically organize nodes using the "Auto Layout" button.
--   **Mini-map & Controls**: Navigate large graphs with ease.
+- **Auto-Layout**: Automatically organize nodes using the "Auto Layout" button.
+- **Mini-map & Controls**: Navigate large graphs with ease.
 
 ### 2. Configuration Modes
 
--   **Sidebar Mode**: Quick edits on the right panel.
--   **Modal Mode**: Focused full-screen dialog.
+- **Sidebar Mode**: Quick edits on the right panel.
+- **Modal Mode**: Focused full-screen dialog.
 
 ---
 
@@ -62,8 +62,8 @@ The builder's input controls are highly reactive and understand the **FieldType*
 
 Click **Test Rule** to execute the current logic against a real document.
 
--   **Dry Run**: No database commits.
--   **Visual Feedback**: Highlights the execution path and provides real-time status badges (✅/❌) on each node.
+- **Dry Run**: No database commits.
+- **Visual Feedback**: Highlights the execution path and provides real-time status badges (✅/❌) on each node.
 
 ### Simulation
 
diff --git a/docs/builder/user_guide_conditions.md b/docs/builder/user_guide_conditions.md
index 04b0f650..456f77a6 100644
--- a/docs/builder/user_guide_conditions.md
+++ b/docs/builder/user_guide_conditions.md
@@ -33,8 +33,8 @@ _"If the status is Open AND (Priority is High OR the Customer is VIP)."_
 
 1.  Click **+ Group**. A new nested box appears.
 2.  **Toggle Logic**: Click the **AND** or **OR** button at the top of the group.
-    -   **AND**: All conditions inside must be true.
-    -   **OR**: Only one needs to be true.
+    - **AND**: All conditions inside must be true.
+    - **OR**: Only one needs to be true.
 3.  **Add Sub-conditions**: Click the buttons _inside_ the group box to add conditions specifically to that container.
 
 ---
@@ -50,9 +50,9 @@ Click **+ Collection** to create a specialized loop checker.
 1.  **Collection Path**: Pick the child table (e.g., `doc.items`).
 2.  **Alias**: By default, this is `row`. It represents a single row in the table.
 3.  **Quantifier**:
-    -   **Any**: True if at least one row matches.
-    -   **All**: True only if every single row matches.
-    -   **None**: True if no rows match.
+    - **Any**: True if at least one row matches.
+    - **All**: True only if every single row matches.
+    - **None**: True if no rows match.
 4.  **Criteria**: Use the sub-builder inside the collection node to define what you are looking for in each row (e.g., `row.qty > 10`).
 
 ---
@@ -61,9 +61,9 @@ Click **+ Collection** to create a specialized loop checker.
 
 Don't worry if you build things in the wrong order. You can easily reorganize your logic:
 
--   **Move**: Grab the drag handle (⠿) on the left of any condition or group and move it.
--   **Nesting**: Drag a condition into an existing group to include it in that group's logic.
--   **Reordering**: Move conditions up or down to change the visual flow (and execution order).
+- **Move**: Grab the drag handle (⠿) on the left of any condition or group and move it.
+- **Nesting**: Drag a condition into an existing group to include it in that group's logic.
+- **Reordering**: Move conditions up or down to change the visual flow (and execution order).
 
 ---
 
@@ -71,14 +71,14 @@ Don't worry if you build things in the wrong order. You can easily reorganize yo
 
 One of the most powerful uses for conditions is detecting changes.
 
--   **Trigger Level**: Use `doc.status != old_doc.status` to make a rule run ONLY when the status field is actually modified.
--   **Previous Value**: Check if a value _was_ something specific: `old_doc.status == "Draft"`.
+- **Trigger Level**: Use `doc.status != old_doc.status` to make a rule run ONLY when the status field is actually modified.
+- **Previous Value**: Check if a value _was_ something specific: `old_doc.status == "Draft"`.
 
 ---
 
 ## Best Practices
 
--   **Keep it Simple**: If a condition group gets too deep (more than 3 levels), consider splitting the logic into multiple rules or sub-rules.
--   **Use Clear Aliases**: When using collection nodes, use descriptive aliases like `item` or `entry` instead of just `row` if you have nested collections.
--   **Check for "Is Set"**: Before comparing values of optional fields, it's often safer to first check if the field `is set`.
--   **Naming**: If a condition action is complex, give the node a descriptive label (e.g., "Check VIP Eligibility") so it's easy to understand the graph at a glance.
+- **Keep it Simple**: If a condition group gets too deep (more than 3 levels), consider splitting the logic into multiple rules or sub-rules.
+- **Use Clear Aliases**: When using collection nodes, use descriptive aliases like `item` or `entry` instead of just `row` if you have nested collections.
+- **Check for "Is Set"**: Before comparing values of optional fields, it's often safer to first check if the field `is set`.
+- **Naming**: If a condition action is complex, give the node a descriptive label (e.g., "Check VIP Eligibility") so it's easy to understand the graph at a glance.
diff --git a/docs/engine/condition_system.md b/docs/engine/condition_system.md
index d1ce6f1e..256fd5d6 100644
--- a/docs/engine/condition_system.md
+++ b/docs/engine/condition_system.md
@@ -11,11 +11,11 @@ FlexiRule employs a sophisticated, high-performance condition system that allows
 
 The Condition Builder is not limited to a single "Condition" node; it is a pervasive component used throughout FlexiRule to drive logic-based execution at multiple levels:
 
--   **Rule Trigger Eligibility**: Every Rule has a global condition defined at the DocType level. This is evaluated by the `RuleCoordinator` to decide if a rule should skip or start execution.
--   **Node-Level Branching**: The `Condition` action node uses it to split the execution path into True/False branches.
--   **Row-Level Assignment (`Run If`)**: In `Assignment` actions, each mutation can have its own "Run If" condition, allowing for granular, state-dependent updates within a single batch.
--   **Collection Filtering**: Used within `Loop` and `Collection` nodes to filter datasets or define exit criteria.
--   **Switch Case Logic**: The `Switch` action uses multiple condition blocks to determine which path to follow among many options.
+- **Rule Trigger Eligibility**: Every Rule has a global condition defined at the DocType level. This is evaluated by the `RuleCoordinator` to decide if a rule should skip or start execution.
+- **Node-Level Branching**: The `Condition` action node uses it to split the execution path into True/False branches.
+- **Row-Level Assignment (`Run If`)**: In `Assignment` actions, each mutation can have its own "Run If" condition, allowing for granular, state-dependent updates within a single batch.
+- **Collection Filtering**: Used within `Loop` and `Collection` nodes to filter datasets or define exit criteria.
+- **Switch Case Logic**: The `Switch` action uses multiple condition blocks to determine which path to follow among many options.
 
 ## The Three-Tier Architecture
 
@@ -25,28 +25,28 @@ The system is divided into three distinct layers, ensuring a clean separation be
 
 The **Condition Builder** is a recursive Vue 3 interface that allows users to construct logic trees.
 
--   **Input**: User interactions (drag-and-drop, field selection, operator picking).
--   **Output**: A standardized **JSON AST (Abstract Syntax Tree)**.
--   **Key Files**: `ConditionBuilder.vue`, `ConditionNode.vue`, `SimpleCondition.vue`.
--   **Detailed Guide**: [Condition Builder Frontend](../builder/condition_builder.md)
+- **Input**: User interactions (drag-and-drop, field selection, operator picking).
+- **Output**: A standardized **JSON AST (Abstract Syntax Tree)**.
+- **Key Files**: `ConditionBuilder.vue`, `ConditionNode.vue`, `SimpleCondition.vue`.
+- **Detailed Guide**: [Condition Builder Frontend](../builder/condition_builder.md)
 
 ### 2. The Condition Compiler (Backend - Save-Time)
 
 To avoid the overhead of parsing JSON at runtime, FlexiRule uses a "Save-Time Compilation" strategy. When a Rule is saved, the `ConditionCompiler` processes the JSON AST.
 
--   **Input**: JSON AST.
--   **Output**: An optimized **Python Expression String** and a list of **Watched Fields**.
--   **Optimization**: The compiler translates visual groups into native Python `and`/`or` chains and collections into efficient generator expressions (e.g., `any(row.status == 'Open' for row in doc.items)`).
--   **Key Files**: `compiler.py`.
+- **Input**: JSON AST.
+- **Output**: An optimized **Python Expression String** and a list of **Watched Fields**.
+- **Optimization**: The compiler translates visual groups into native Python `and`/`or` chains and collections into efficient generator expressions (e.g., `any(row.status == 'Open' for row in doc.items)`).
+- **Key Files**: `compiler.py`.
 
 ### 3. The Evaluator (Backend - Runtime)
 
 At runtime, the execution engine evaluates the pre-compiled Python string within a sandboxed environment.
 
--   **Input**: Compiled Python string + Execution Context (`doc`, `vars`, etc.).
--   **Execution**: Uses `frappe.safe_eval` for maximum performance with guaranteed security.
--   **Security**: Restricted to `SafeFrappeAPI`, preventing any write operations or unauthorized access during evaluation.
--   **Key Files**: `runtime_eval.py`, `engine.py`.
+- **Input**: Compiled Python string + Execution Context (`doc`, `vars`, etc.).
+- **Execution**: Uses `frappe.safe_eval` for maximum performance with guaranteed security.
+- **Security**: Restricted to `SafeFrappeAPI`, preventing any write operations or unauthorized access during evaluation.
+- **Key Files**: `runtime_eval.py`, `engine.py`.
 
 ## The Condition Evaluator (`ConditionEvaluator`)
 
@@ -71,15 +71,15 @@ The `ConditionCompiler` is responsible for transforming the structured JSON repr
 
 The compiler expects three types of nodes:
 
--   **Condition Node**: A leaf node representing a single comparison.
+- **Condition Node**: A leaf node representing a single comparison.
     ```json
     { "left": { "ref": "doc.status" }, "op": "==", "right": { "value": "Open" } }
     ```
--   **Group Node**: A logical container for multiple nodes.
+- **Group Node**: A logical container for multiple nodes.
     ```json
     { "op": "and", "conditions": [...] }
     ```
--   **Collection Node**: Logic applied across a child table or list.
+- **Collection Node**: Logic applied across a child table or list.
     ```json
     { "op": "any", "collection": "doc.items", "alias": "item", "where": { ... } }
     ```
@@ -101,9 +101,9 @@ The compiler maps visual operators to Python equivalents and helper functions:
 
 One of the most powerful features of the compiler is how it handles child tables using Python generator expressions:
 
--   **Any**: `any(condition for alias in (collection or []))`
--   **All**: `all(condition for alias in (collection or []))`
--   **None**: `not any(condition for alias in (collection or []))`
+- **Any**: `any(condition for alias in (collection or []))`
+- **All**: `all(condition for alias in (collection or []))`
+- **None**: `not any(condition for alias in (collection or []))`
 
 Example: "Check if any item has a quantity greater than 10" becomes:
 `any(item.get('qty') > 10 for item in (doc.get('items') or []))`
@@ -112,9 +112,9 @@ Example: "Check if any item has a quantity greater than 10" becomes:
 
 The compiler intelligently resolves variable scopes:
 
--   `doc.status` -> `doc.get('status')`
--   `row.price` -> `row.get('price')`
--   Deep paths like `doc.owner.email` are wrapped in a `resolve()` helper: `resolve(doc, 'owner.email')`.
+- `doc.status` -> `doc.get('status')`
+- `row.price` -> `row.get('price')`
+- Deep paths like `doc.owner.email` are wrapped in a `resolve()` helper: `resolve(doc, 'owner.email')`.
 
 ## Performance: Why Pre-Compilation?
 
diff --git a/docs/engine/execution_engine.md b/docs/engine/execution_engine.md
index 437912d6..96042d77 100644
--- a/docs/engine/execution_engine.md
+++ b/docs/engine/execution_engine.md
@@ -27,17 +27,17 @@ The engine provides enterprise-grade reliability features for handling failures
 
 When an action is configured with `on_error: "Retry"`, the engine uses an exponential backoff strategy:
 
--   **Delay Formula**: `wait_time = 2 ** current_attempt` seconds.
--   **Example**: Attempt 1 (2s), Attempt 2 (4s), Attempt 3 (8s).
--   **Safety**: Retries are automatically disabled if the context flag `_in_sync_hook` is set, preventing unsafe sleeps in synchronous DocType events.
+- **Delay Formula**: `wait_time = 2 ** current_attempt` seconds.
+- **Example**: Attempt 1 (2s), Attempt 2 (4s), Attempt 3 (8s).
+- **Safety**: Retries are automatically disabled if the context flag `_in_sync_hook` is set, preventing unsafe sleeps in synchronous DocType events.
 
 ### Savepoint / Rollback Management
 
 For actions with the `transactional` flag or `on_error: "Rollback"`, the engine uses database savepoints to ensure atomic consistency at the node level:
 
 1.  **Creation**: `frappe.db.savepoint(savepoint_name)` is called before the action handler.
-    -   **Process naming**: `process_{process_name}_{operation}_{attempt}`
-    -   **Action naming**: `flexirule_action_{action_id}`
+    - **Process naming**: `process_{process_name}_{operation}_{attempt}`
+    - **Action naming**: `flexirule_action_{action_id}`
 2.  **Execution**: The action handler is executed within a try-except block.
 3.  **Rollback**: If an error occurs and rollback is required, `frappe.db.rollback(save_point=...)` is called, reverting only the changes made by that specific action, not the entire transaction.
 4.  **Cleanup**: Savepoints are released upon successful completion of the action (only for Process actions).
@@ -46,9 +46,9 @@ For actions with the `transactional` flag or `on_error: "Rollback"`, the engine
 
 To prevent infinite recursive loops, the `RuleCoordinator` implements a global reentrancy guard:
 
--   **Mechanism**: A request-local registry tracks active executions.
--   **Key Format**: `{doctype}:{name}:{event_name}`.
--   **Action**: If a key is already present in the local stack, the execution request is denied to prevent stack overflow and cascading updates.
+- **Mechanism**: A request-local registry tracks active executions.
+- **Key Format**: `{doctype}:{name}:{event_name}`.
+- **Action**: If a key is already present in the local stack, the execution request is denied to prevent stack overflow and cascading updates.
 
 ---
 
@@ -60,8 +60,8 @@ The engine maintains a strict **Temporal Context Isolation** policy.
 
 At runtime, the execution context (`vars`, `doc` state) is built **incrementally**.
 
--   **Step-by-Step Availability**: An action can only read variables or document states that have been set by preceding actions in the current execution path.
--   **Future Isolation**: An action has no visibility into variables, document updates, or mutations that occur in steps following it.
+- **Step-by-Step Availability**: An action can only read variables or document states that have been set by preceding actions in the current execution path.
+- **Future Isolation**: An action has no visibility into variables, document updates, or mutations that occur in steps following it.
 
 ---
 
@@ -87,8 +87,8 @@ The engine uses a pluggable handler system.
 
 ### Cycle Detection
 
--   **Visit Count**: Each node can be visited a maximum of 100 times.
--   **Total Iterations**: A single rule execution is limited to 1000 steps.
+- **Visit Count**: Each node can be visited a maximum of 100 times.
+- **Total Iterations**: A single rule execution is limited to 1000 steps.
 
 ### Sandboxing
 
diff --git a/docs/engine/orchestration.md b/docs/engine/orchestration.md
index 71e77535..0170b4cb 100644
--- a/docs/engine/orchestration.md
+++ b/docs/engine/orchestration.md
@@ -13,44 +13,44 @@ FlexiRule is more than a simple automation engine; it is a **Visual Orchestratio
 
 While the engine executes nodes sequentially, the graph structure allows for complex logical paths.
 
--   **Conditional Branching**: Use the `Condition` node to create `If/Else` paths.
--   **Switch Logic**: Dispatch execution to different paths based on a variable's value (e.g., routing a document based on its "Status").
+- **Conditional Branching**: Use the `Condition` node to create `If/Else` paths.
+- **Switch Logic**: Dispatch execution to different paths based on a variable's value (e.g., routing a document based on its "Status").
 
 ### 2. Iterative Orchestration (`Loop`)
 
 The `Loop` action allows you to orchestrate logic over collections of data.
 
--   **Child Table Processing**: Iterate over items in a Sales Invoice to apply line-by-line calculations or validations.
--   **Batch Processing**: Process results from a `Query Records` action in a loop.
--   **Scoped Context**: Each iteration has its own `item` alias, ensuring clean data separation.
+- **Child Table Processing**: Iterate over items in a Sales Invoice to apply line-by-line calculations or validations.
+- **Batch Processing**: Process results from a `Query Records` action in a loop.
+- **Scoped Context**: Each iteration has its own `item` alias, ensuring clean data separation.
 
 ### 3. Modular Reusability (`Sub-Rule`)
 
 Complex workflows can be decomposed into smaller, manageable sub-rules.
 
--   **Callable Rules**: Define a rule once and mark it as `Exposed as Sub-Rule`.
--   **Context Merging**: Sub-rules inherit context from the caller, allowing for seamless data transfer between the main orchestration and utility routines.
--   **Separation of Concerns**: Keep your main flow high-level and offload detailed technical logic to sub-rules.
+- **Callable Rules**: Define a rule once and mark it as `Exposed as Sub-Rule`.
+- **Context Merging**: Sub-rules inherit context from the caller, allowing for seamless data transfer between the main orchestration and utility routines.
+- **Separation of Concerns**: Keep your main flow high-level and offload detailed technical logic to sub-rules.
 
 ### 4. Lifecycle Orchestration (`Document Action`)
 
 FlexiRule can orchestrate the entire lifecycle of records in Frappe.
 
--   **Chained Transactions**: A single rule on `Sales Order` can automatically create a `Production Plan`, multiple `Work Orders`, and send a `Notification` to the warehouse manager.
--   **Reference Updates**: Update related documents (e.g., updating a `Customer` record based on a `Payment Entry`) as part of a larger flow.
+- **Chained Transactions**: A single rule on `Sales Order` can automatically create a `Production Plan`, multiple `Work Orders`, and send a `Notification` to the warehouse manager.
+- **Reference Updates**: Update related documents (e.g., updating a `Customer` record based on a `Payment Entry`) as part of a larger flow.
 
 ### 5. Error & Recovery Orchestration
 
 Orchestration includes managing what happens when things go wrong.
 
--   **Self-Healing Flows**: Use the `Retry` policy with exponential backoff for transient failures (e.g., external API calls).
--   **Graceful Degradation**: Use the `Continue` policy to skip non-critical steps if they fail.
--   **Atomic Rollbacks**: Use `savepoints` to ensure that if a specific step in a complex orchestration fails, only that step is reverted, maintaining the integrity of the overall process.
+- **Self-Healing Flows**: Use the `Retry` policy with exponential backoff for transient failures (e.g., external API calls).
+- **Graceful Degradation**: Use the `Continue` policy to skip non-critical steps if they fail.
+- **Atomic Rollbacks**: Use `savepoints` to ensure that if a specific step in a complex orchestration fails, only that step is reverted, maintaining the integrity of the overall process.
 
 ### 6. Synchronous vs. Asynchronous Execution
 
--   **Sync**: For real-time validations and blocking logic.
--   **Async**: For long-running orchestrations (e.g., generating 100+ documents) that should not block the user's browser. The engine automatically handles the offloading to background workers.
+- **Sync**: For real-time validations and blocking logic.
+- **Async**: For long-running orchestrations (e.g., generating 100+ documents) that should not block the user's browser. The engine automatically handles the offloading to background workers.
 
 ---
 
diff --git a/docs/engine/trigger_system.md b/docs/engine/trigger_system.md
index 9efd70a9..eb92596b 100644
--- a/docs/engine/trigger_system.md
+++ b/docs/engine/trigger_system.md
@@ -15,23 +15,23 @@ FlexiRule supports three primary trigger types, each serving a different archite
 
 This is the most common trigger type. It hooks directly into Frappe's `doc_events`.
 
--   **Standard Hooks**: Supports all standard Frappe hooks (e.g., `Before Insert`, `Before Save`, `Validate`, `On Submit`, `On Change`, `On Trash`).
--   **Optimization**: Uses `watched_fields` to avoid executing rules if unrelated fields are modified.
--   **Context**: Provides the current `doc` and `old_doc` (state before save) to the execution engine.
+- **Standard Hooks**: Supports all standard Frappe hooks (e.g., `Before Insert`, `Before Save`, `Validate`, `On Submit`, `On Change`, `On Trash`).
+- **Optimization**: Uses `watched_fields` to avoid executing rules if unrelated fields are modified.
+- **Context**: Provides the current `doc` and `old_doc` (state before save) to the execution engine.
 
 ### 2. Scheduler Event
 
 Used for background, time-based automation.
 
--   **Mechanism**: Integrated with Frappe's scheduled tasks.
--   **Context**: Since it's not tied to a specific document event, these rules typically start with a `Query Records` action to find the documents they need to process.
+- **Mechanism**: Integrated with Frappe's scheduled tasks.
+- **Context**: Since it's not tied to a specific document event, these rules typically start with a `Query Records` action to find the documents they need to process.
 
 ### 3. Callable Event (Sub-Rules)
 
 These rules do not trigger automatically. Instead, they are designed to be called by other rules.
 
--   **Exposability**: Must have the `exposed_as_subrule` flag enabled to be visible in the `Sub-Rule` action picker.
--   **Priority**: Always has a priority of `0` because execution is determined by the caller.
+- **Exposability**: Must have the `exposed_as_subrule` flag enabled to be visible in the `Sub-Rule` action picker.
+- **Priority**: Always has a priority of `0` because execution is determined by the caller.
 
 ---
 
@@ -52,9 +52,9 @@ When a document event occurs, the Coordinator:
 
 To maintain high performance, FlexiRule uses a layered caching strategy for rule metadata:
 
--   **Level 1 (Request)**: `frappe.local` storage for the duration of a single request.
--   **Level 2 (Redis)**: A global `flexirule_runtime_registry` in Redis.
--   **Level 3 (Database)**: Rebuilds the registry from the `Rule` DocType on cache miss or manual clear.
+- **Level 1 (Request)**: `frappe.local` storage for the duration of a single request.
+- **Level 2 (Redis)**: A global `flexirule_runtime_registry` in Redis.
+- **Level 3 (Database)**: Rebuilds the registry from the `Rule` DocType on cache miss or manual clear.
 
 ---
 
@@ -64,9 +64,9 @@ Trigger conditions are written visually in the builder and compiled into pure Py
 
 ### Features
 
--   **Field Access**: Access fields via `doc.status` or deep paths like `doc.items.0.qty`.
--   **Change Detection**: Compare `doc` vs `old_doc` (e.g., `doc.status != old_doc.status`).
--   **Safety**: Evaluation is strictly read-only via `SafeFrappeAPI`.
+- **Field Access**: Access fields via `doc.status` or deep paths like `doc.items.0.qty`.
+- **Change Detection**: Compare `doc` vs `old_doc` (e.g., `doc.status != old_doc.status`).
+- **Safety**: Evaluation is strictly read-only via `SafeFrappeAPI`.
 
 ### Performance Note
 
diff --git a/docs/reference/api.md b/docs/reference/api.md
index 46e940c4..0616739c 100644
--- a/docs/reference/api.md
+++ b/docs/reference/api.md
@@ -13,23 +13,23 @@ FlexiRule provides a comprehensive set of whitelisted backend methods for progra
 
 Executes a rule against a document for testing purposes. Works for draft and inactive rules.
 
--   **Parameters**:
-    -   `rule_name`: Name of the Rule.
-    -   `doctype` / `docname`: Target document.
-    -   `document_json`: Transient document data (alternative to docname).
-    -   `dry_run` (bool): If true, rolls back changes after execution.
-    -   `skip_log_enqueue` (bool): If true, does not persist logs.
-    -   `save_log` (bool): Forces log persistence regardless of dry_run.
--   **Returns**: Execution payload including `status`, `path_trace`, `vars`, and legacy `context_snapshot`.
+- **Parameters**:
+    - `rule_name`: Name of the Rule.
+    - `doctype` / `docname`: Target document.
+    - `document_json`: Transient document data (alternative to docname).
+    - `dry_run` (bool): If true, rolls back changes after execution.
+    - `skip_log_enqueue` (bool): If true, does not persist logs.
+    - `save_log` (bool): Forces log persistence regardless of dry_run.
+- **Returns**: Execution payload including `status`, `path_trace`, `vars`, and legacy `context_snapshot`.
 
 ### `execute_rule`
 
 The primary API for manual or programmatic rule execution.
 
--   **Parameters**:
-    -   `rule_name`: Name of the Rule.
-    -   `context` (dict): Initial variable state.
-    -   `dry_run` (bool): Execution safety flag.
+- **Parameters**:
+    - `rule_name`: Name of the Rule.
+    - `context` (dict): Initial variable state.
+    - `dry_run` (bool): Execution safety flag.
 
 ---
 
@@ -39,14 +39,14 @@ The primary API for manual or programmatic rule execution.
 
 Moves a rule through its lifecycle states.
 
--   **Statuses**: `Draft`, `Active`, `Disabled`, `Archived`.
--   **Note**: Transitioning to `Active` triggers a full validation check.
+- **Statuses**: `Draft`, `Active`, `Disabled`, `Archived`.
+- **Note**: Transitioning to `Active` triggers a full validation check.
 
 ### `validate_rule_document`
 
 Performs deep validation of a rule's graph, configuration, and conditions.
 
--   **Modes**: `full` (for activation), `draft` (partial check), `node` (single action).
+- **Modes**: `full` (for activation), `draft` (partial check), `node` (single action).
 
 ### `clone_rule` / `amend_rule`
 
@@ -64,7 +64,7 @@ Returns the global contract for all action types, including CSS styles, required
 
 Returns the dynamic configuration schema for a specific action type or process operation.
 
--   **Parameters**: `action_type`, `operation`, `process_name`.
+- **Parameters**: `action_type`, `operation`, `process_name`.
 
 ### `get_action_context_schema`
 
diff --git a/docs/reference/contracts.md b/docs/reference/contracts.md
index 8b3cbed7..c60916dc 100644
--- a/docs/reference/contracts.md
+++ b/docs/reference/contracts.md
@@ -15,18 +15,18 @@ The source of truth for all actions is `flexirule/ruleflow.core.contracts.py`. T
 
 Defines the global behavior for a category of actions (e.g., `Process`, `Condition`, `Loop`).
 
--   **Required Fields**: Fields that must be present for the action to be valid.
--   **Handle Configuration**: Specifies if the node has a `True` (`next_step_if_true`) or `False` (`next_step_if_false`) exit.
--   **Terminal Flag**: If `True`, the engine knows no further actions can follow.
--   **Visual Metadata**: Defines the icon and color used on the builder canvas.
--   **Mutation Policies**: Lists allowed `mutation_mode` options (e.g., a `Condition` cannot mutate a document).
+- **Required Fields**: Fields that must be present for the action to be valid.
+- **Handle Configuration**: Specifies if the node has a `True` (`next_step_if_true`) or `False` (`next_step_if_false`) exit.
+- **Terminal Flag**: If `True`, the engine knows no further actions can follow.
+- **Visual Metadata**: Defines the icon and color used on the builder canvas.
+- **Mutation Policies**: Lists allowed `mutation_mode` options (e.g., a `Condition` cannot mutate a document).
 
 ### 2. `OPERATION_CONTRACTS`
 
 Provides fine-grained overrides for specific operations (e.g., `Query List` vs `Query Doc`).
 
--   **Field Overrides**: Can change a field's label, description, or requirement status based on the selected mode.
--   **Validation Hooks**: Links to backend Python functions (e.g., `validate_stop_error`) or frontend JS functions for real-time integrity checks.
+- **Field Overrides**: Can change a field's label, description, or requirement status based on the selected mode.
+- **Validation Hooks**: Links to backend Python functions (e.g., `validate_stop_error`) or frontend JS functions for real-time integrity checks.
 
 ---
 
@@ -36,15 +36,15 @@ Provides fine-grained overrides for specific operations (e.g., `Query List` vs `
 
 The frontend calls the `get_contract_dto` API, which exports these Python dictionaries as a JSON object.
 
--   **Dynamic UI**: The `ControlFactory` uses the contract to decide which fields to show and how to label them.
--   **Client-Side Validation**: The builder prevents users from connecting nodes or saving configurations that violate the contract (e.g., connecting a `False` path to a `Process` node).
+- **Dynamic UI**: The `ControlFactory` uses the contract to decide which fields to show and how to label them.
+- **Client-Side Validation**: The builder prevents users from connecting nodes or saving configurations that violate the contract (e.g., connecting a `False` path to a `Process` node).
 
 ### Runtime (Engine)
 
 The `RuleEngine` uses the contract during execution to:
 
--   **Policy Enforcement**: Before applying a result, the engine checks the `allowed_mutations` and `allowed_return_types` defined in the contract.
--   **Schema Validation**: If a contract defines an `output_schema`, the engine validates the returned data before allowing it to enter the execution context.
+- **Policy Enforcement**: Before applying a result, the engine checks the `allowed_mutations` and `allowed_return_types` defined in the contract.
+- **Schema Validation**: If a contract defines an `output_schema`, the engine validates the returned data before allowing it to enter the execution context.
 
 ---
 
diff --git a/docs/reference/doctypes.md b/docs/reference/doctypes.md
index f1ec2184..360ef5cf 100644
--- a/docs/reference/doctypes.md
+++ b/docs/reference/doctypes.md
@@ -194,19 +194,19 @@ Global application configuration.
 
 ### Rule Permission (Child Table)
 
--   `role` (Link): Frappe Role allowed to execute the rule.
--   `can_execute` (Check): Permission flag.
+- `role` (Link): Frappe Role allowed to execute the rule.
+- `can_execute` (Check): Permission flag.
 
 ### Data Review Task
 
--   `task_type` (Select): `Duplicate Review`, `Data Quality`, etc.
--   `status` (Select): `Open`, `In Progress`, `Resolved`, `Rejected`.
--   `priority` (Select): `Low` to `Critical`.
--   `source_doctype` / `source_document`: The record being reviewed.
--   `similarity_score` (Percent): Match score for duplicate detection.
--   `context_json` (Code): Snapshot of context when task was created.
--   `related_documents` (Table): List of `Data Review Related Document`.
+- `task_type` (Select): `Duplicate Review`, `Data Quality`, etc.
+- `status` (Select): `Open`, `In Progress`, `Resolved`, `Rejected`.
+- `priority` (Select): `Low` to `Critical`.
+- `source_doctype` / `source_document`: The record being reviewed.
+- `similarity_score` (Percent): Match score for duplicate detection.
+- `context_json` (Code): Snapshot of context when task was created.
+- `related_documents` (Table): List of `Data Review Related Document`.
 
 ### RuleFlow Excluded DocType (Child Table)
 
--   `document_type` (Link): The DocType to blacklist from rule evaluation.
+- `document_type` (Link): The DocType to blacklist from rule evaluation.
diff --git a/docs/reference/internals.md b/docs/reference/internals.md
index 0373aa3a..b220ca33 100644
--- a/docs/reference/internals.md
+++ b/docs/reference/internals.md
@@ -44,8 +44,8 @@ When a Rule is saved, deleted, or its status changes:
 
 The engine maintains a granular approach to transactions. Instead of a single "all-or-nothing" rule execution, each action can be its own transactional unit:
 
--   **Savepoint Naming**: `flexirule_action_{action_id}`.
--   **Savepoint Logic**: Enables the "Rollback" error policy, allowing one node to fail and revert its specific database changes while the rule execution continues or escalates gracefully.
+- **Savepoint Naming**: `flexirule_action_{action_id}`.
+- **Savepoint Logic**: Enables the "Rollback" error policy, allowing one node to fail and revert its specific database changes while the rule execution continues or escalates gracefully.
 
 ---
 
diff --git a/docs/roadmap/technical_audit.md b/docs/roadmap/technical_audit.md
index fa26d70f..d00cef00 100644
--- a/docs/roadmap/technical_audit.md
+++ b/docs/roadmap/technical_audit.md
@@ -13,17 +13,17 @@ FlexiRule is currently in a **Beta** state, with a stable core engine and a prod
 
 ### Strengths
 
--   **Deterministic Engine**: Graph-based execution with strict cycle detection and visit counting.
--   **Unified Contract**: Single source of truth for action metadata shared between Python and Vue 3.
--   **High Performance**: Layered caching (Local → Redis → DB) and pre-compiled conditions.
--   **Observability**: Detailed execution tracing and persistence for every rule run.
--   **Security**: Sandboxed execution and role-based access control (RBAC) at the rule and action level.
+- **Deterministic Engine**: Graph-based execution with strict cycle detection and visit counting.
+- **Unified Contract**: Single source of truth for action metadata shared between Python and Vue 3.
+- **High Performance**: Layered caching (Local → Redis → DB) and pre-compiled conditions.
+- **Observability**: Detailed execution tracing and persistence for every rule run.
+- **Security**: Sandboxed execution and role-based access control (RBAC) at the rule and action level.
 
 ### Identified Debt
 
--   **Frontend Bundle Size**: The Vue/VueFlow bundle is large; needs optimization.
--   **Condition Complexity**: Very deep nested AND/OR groups in the UI can sometimes produce complex compiled strings.
--   **Testing Coverage**: Core engine is well-covered, but edge cases in complex loop/sub-rule interactions need more automated tests.
+- **Frontend Bundle Size**: The Vue/VueFlow bundle is large; needs optimization.
+- **Condition Complexity**: Very deep nested AND/OR groups in the UI can sometimes produce complex compiled strings.
+- **Testing Coverage**: Core engine is well-covered, but edge cases in complex loop/sub-rule interactions need more automated tests.
 
 ---
 
@@ -31,21 +31,21 @@ FlexiRule is currently in a **Beta** state, with a stable core engine and a prod
 
 ### **Phase 1: Performance & Scale (Current Focus)**
 
--   [ ] **Partial Registry Updates**: Avoid full registry rebuilds for small rule changes.
--   [ ] **Serialized Context Optimization**: Reduce the size of `context_snapshot` in Rule Execution Logs.
--   [ ] **Lazy-loading Components**: Optimize the Rule Builder's initialization time.
+- [ ] **Partial Registry Updates**: Avoid full registry rebuilds for small rule changes.
+- [ ] **Serialized Context Optimization**: Reduce the size of `context_snapshot` in Rule Execution Logs.
+- [ ] **Lazy-loading Components**: Optimize the Rule Builder's initialization time.
 
 ### **Phase 2: Advanced Orchestration**
 
--   [ ] **Parallel Execution**: Allow nodes to execute in parallel where dependencies allow.
--   [ ] **State Machine Integration**: Support long-running rules that pause and wait for external signals (e.g., "Wait for Approval").
--   [ ] **Version Diffing**: Visual comparison between rule versions.
+- [ ] **Parallel Execution**: Allow nodes to execute in parallel where dependencies allow.
+- [ ] **State Machine Integration**: Support long-running rules that pause and wait for external signals (e.g., "Wait for Approval").
+- [ ] **Version Diffing**: Visual comparison between rule versions.
 
 ### **Phase 3: Ecosystem & Tools**
 
--   [ ] **Visual Debugger**: Step-through debugging directly on the canvas.
--   [ ] **Bulk Import/Export**: Better CLI tools for migrating rules between environments.
--   [ ] **Rule Analytics**: Dashboard for visualizing performance trends and error hotspots across all rules.
+- [ ] **Visual Debugger**: Step-through debugging directly on the canvas.
+- [ ] **Bulk Import/Export**: Better CLI tools for migrating rules between environments.
+- [ ] **Rule Analytics**: Dashboard for visualizing performance trends and error hotspots across all rules.
 
 ---
 
diff --git a/flexirule/public/js/flexirule/rule_builder/components/ActionFieldProperties.vue b/flexirule/public/js/flexirule/rule_builder/components/ActionFieldProperties.vue
index 774826db..c38e3f88 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/ActionFieldProperties.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/ActionFieldProperties.vue
@@ -61,7 +61,7 @@ const doc_fields = computed(() => {
 				? getFieldLabel(actionType, df.fieldname, {
 						operation: props.nodeData?.operation,
 						processName: props.nodeData?.process_name,
-				  })
+					})
 				: null;
 			if (resolved.fieldname === "action_type") {
 				resolved = {
diff --git a/flexirule/public/js/flexirule/rule_builder/components/ActionPopover.vue b/flexirule/public/js/flexirule/rule_builder/components/ActionPopover.vue
index e0b0f502..a124138f 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/ActionPopover.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/ActionPopover.vue
@@ -518,7 +518,9 @@ onUnmounted(() => {
 	background: #fff;
 	border: 1px solid var(--border-color, #dfe3e8);
 	border-radius: 8px;
-	box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
+	box-shadow:
+		0 10px 15px -3px rgba(0, 0, 0, 0.1),
+		0 4px 6px -2px rgba(0, 0, 0, 0.05);
 	z-index: 2147483647; /* Maximum possible z-index */
 	display: flex;
 	flex-direction: column;
diff --git a/flexirule/public/js/flexirule/rule_builder/components/condition_builder/SimpleCondition.vue b/flexirule/public/js/flexirule/rule_builder/components/condition_builder/SimpleCondition.vue
index 0a8c07c7..f34cfee8 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/condition_builder/SimpleCondition.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/condition_builder/SimpleCondition.vue
@@ -63,7 +63,7 @@ const operators = computed(() => {
 		Array.isArray(fieldOps) && fieldOps.length
 			? fieldOps
 			: config.fieldtype_operators?.[ft] ||
-			  config.fieldtype_operators?.["_default"] || ["==", "!=", "is_set", "is_not_set"];
+				config.fieldtype_operators?.["_default"] || ["==", "!=", "is_set", "is_not_set"];
 	const labels = config.operator_labels || {};
 
 	return validOps.map((op) => ({
@@ -380,7 +380,9 @@ watch(
 	border: 1px solid var(--fxr-border);
 	border-radius: var(--fxr-radius-md);
 	padding: var(--fxr-space-1) var(--fxr-space-2);
-	transition: border-color var(--fxr-transition-fast), background-color var(--fxr-transition-fast);
+	transition:
+		border-color var(--fxr-transition-fast),
+		background-color var(--fxr-transition-fast);
 }
 
 .simple-condition:hover {
diff --git a/flexirule/public/js/flexirule/rule_builder/components/nodes/ConditionNode.vue b/flexirule/public/js/flexirule/rule_builder/components/nodes/ConditionNode.vue
index c283a6c5..d00c3e77 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/nodes/ConditionNode.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/nodes/ConditionNode.vue
@@ -44,7 +44,7 @@ const conditionSummary = computed(() => {
 		const op = first.op;
 		const right = first.right?.ref
 			? first.right.ref.replace("doc.", "")
-			: first.right?.value ?? "?";
+			: (first.right?.value ?? "?");
 		return `${left} ${op} ${right}${count > 1 ? ` (+${count - 1})` : ""}`;
 	}
 	return `${count} ${__("conditions")}`;
diff --git a/flexirule/public/js/flexirule/rule_builder/components/nodes/StartNode.vue b/flexirule/public/js/flexirule/rule_builder/components/nodes/StartNode.vue
index 1074c589..20b3e3f0 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/nodes/StartNode.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/nodes/StartNode.vue
@@ -119,7 +119,9 @@ function openConfig() {
 	align-items: center;
 	padding: 8px 16px 8px 10px;
 	border-radius: 4px 40px 40px 4px; /* Reflected D-Shape */
-	box-shadow: 0 2px 4px -1px rgba(0, 0, 0, 0.1), 0 1px 2px -1px rgba(0, 0, 0, 0.06);
+	box-shadow:
+		0 2px 4px -1px rgba(0, 0, 0, 0.1),
+		0 1px 2px -1px rgba(0, 0, 0, 0.06);
 	transition: all 0.2s ease;
 	border: 1px solid rgba(255, 255, 255, 0.2);
 }
diff --git a/flexirule/public/js/flexirule/rule_builder/components/nodes/StopNode.vue b/flexirule/public/js/flexirule/rule_builder/components/nodes/StopNode.vue
index 01ca393d..16319690 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/nodes/StopNode.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/nodes/StopNode.vue
@@ -104,7 +104,9 @@ function openConfig() {
 }
 
 .stop-node-card.selected {
-	box-shadow: 0 0 0 2px #fff, 0 0 0 4px #dc3545;
+	box-shadow:
+		0 0 0 2px #fff,
+		0 0 0 4px #dc3545;
 }
 
 .stop-node-card.test-executed {
diff --git a/flexirule/public/js/flexirule/rule_builder/components/rule_config/FilterGroup.vue b/flexirule/public/js/flexirule/rule_builder/components/rule_config/FilterGroup.vue
index c4098ef8..ada53d1b 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/rule_config/FilterGroup.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/rule_config/FilterGroup.vue
@@ -225,7 +225,7 @@ const timespanOptions = frappe.ui?.filter_utils?.get_timespan_options
 			"Tomorrow",
 			"This",
 			"Next",
-	  ])
+		])
 	: [
 			{ label: __("Last 7 Days"), value: "last 7 days" },
 			{ label: __("Last 14 Days"), value: "last 14 days" },
@@ -251,7 +251,7 @@ const timespanOptions = frappe.ui?.filter_utils?.get_timespan_options
 			{ label: __("Next Quarter"), value: "next quarter" },
 			{ label: __("Next 6 Months"), value: "next 6 months" },
 			{ label: __("Next Year"), value: "next year" },
-	  ];
+		];
 
 const BASE_QUERY_OPERATORS = [
 	"=",
@@ -886,7 +886,7 @@ const updateBetweenValue = (idx, arrayIndex, val) => {
 		: [
 				{ mode: "static", value: "" },
 				{ mode: "static", value: "" },
-		  ];
+			];
 	list[arrayIndex] = val;
 	merged.value = list;
 	filters.value[idx] = merged;
@@ -936,7 +936,9 @@ onMounted(async () => {
 	border: 1px solid var(--fxr-border);
 	border-radius: var(--fxr-radius-lg);
 	padding: var(--fxr-space-4) var(--fxr-space-5);
-	transition: border-color var(--fxr-transition-fast), box-shadow var(--fxr-transition-fast);
+	transition:
+		border-color var(--fxr-transition-fast),
+		box-shadow var(--fxr-transition-fast);
 }
 
 .filter-row:hover {
@@ -1171,7 +1173,9 @@ onMounted(async () => {
 	font-size: var(--fxr-input-font-size) !important;
 	border: 1px solid var(--fxr-border) !important;
 	border-radius: var(--fxr-radius-md) !important;
-	transition: border-color var(--fxr-transition-fast), box-shadow var(--fxr-transition-fast) !important;
+	transition:
+		border-color var(--fxr-transition-fast),
+		box-shadow var(--fxr-transition-fast) !important;
 }
 
 .filter-row-main :deep(.fxr-control),
diff --git a/flexirule/public/js/flexirule/rule_builder/components/rule_config/RuleConfigModal.vue b/flexirule/public/js/flexirule/rule_builder/components/rule_config/RuleConfigModal.vue
index 65dd8fe0..3b150b6b 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/rule_config/RuleConfigModal.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/rule_config/RuleConfigModal.vue
@@ -370,10 +370,10 @@
 																		collapseInputPanel
 																			? __(
 																					'Expand Input Panel'
-																			  )
+																				)
 																			: __(
 																					'Collapse Input Panel'
-																			  )
+																				)
 																	"
 																>
 																	<i
@@ -1523,7 +1523,9 @@ onUnmounted(() => {
 .fxr-overflow-dropdown {
 	background: #fff;
 	border-radius: 12px;
-	box-shadow: 0 10px 25px -5px rgba(0, 0, 0, 0.1), 0 8px 10px -6px rgba(0, 0, 0, 0.1);
+	box-shadow:
+		0 10px 25px -5px rgba(0, 0, 0, 0.1),
+		0 8px 10px -6px rgba(0, 0, 0, 0.1);
 	border: 1px solid #e2e8f0;
 	overflow: hidden;
 	animation: dropdown-slide 0.2s cubic-bezier(0, 0, 0.2, 1);
diff --git a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/ProcessConfig.vue b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/ProcessConfig.vue
index 322f19d9..ff1d67e4 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/ProcessConfig.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/ProcessConfig.vue
@@ -132,7 +132,10 @@ async function initEngine() {
 	if (!process_name || !operation) {
 		// Only log if it's truly an unexpected state (e.g. not just initializing)
 		if (props.node?.data) {
-			console.debug("ProcessConfig: Waiting for process_name and operation", toRaw(props.node.data));
+			console.debug(
+				"ProcessConfig: Waiting for process_name and operation",
+				toRaw(props.node.data)
+			);
 		}
 		return;
 	}
diff --git a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/QueryRecordsConfig.vue b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/QueryRecordsConfig.vue
index 50864997..4ab17e90 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/QueryRecordsConfig.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/QueryRecordsConfig.vue
@@ -1004,7 +1004,7 @@ function load_local_config(val) {
 					field: parts[0],
 					direction: (parts[1] || "asc").toLowerCase(),
 				};
-		  })
+			})
 		: [];
 	const current_order_by_rows = order_by_rows.value.map((r) => ({
 		field: r.field,
@@ -1165,7 +1165,9 @@ defineExpose({
 	font-size: var(--fxr-input-font-size) !important;
 	border: 1px solid var(--fxr-border) !important;
 	border-radius: var(--fxr-radius-md) !important;
-	transition: border-color var(--fxr-transition-fast), box-shadow var(--fxr-transition-fast) !important;
+	transition:
+		border-color var(--fxr-transition-fast),
+		box-shadow var(--fxr-transition-fast) !important;
 }
 
 :deep(.form-control:focus) {
diff --git a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/SubRuleConfig.vue b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/SubRuleConfig.vue
index fd0d7d90..ab427b8b 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/SubRuleConfig.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/SubRuleConfig.vue
@@ -239,7 +239,7 @@ function load_local_config() {
 		? mappings.map((m) => ({
 				source: m.source || m.source_expression || "",
 				target: m.target || "",
-		  }))
+			}))
 		: [];
 }
 
diff --git a/flexirule/public/js/flexirule/rule_builder/composables/useAsyncOptionsSource.js b/flexirule/public/js/flexirule/rule_builder/composables/useAsyncOptionsSource.js
index a80c3ee5..4f08bfa8 100644
--- a/flexirule/public/js/flexirule/rule_builder/composables/useAsyncOptionsSource.js
+++ b/flexirule/public/js/flexirule/rule_builder/composables/useAsyncOptionsSource.js
@@ -40,7 +40,7 @@ export function useAsyncOptionsSource(fetcher, config = {}) {
 							start: nextPage * pageSize,
 							page: nextPage,
 							pageSize,
-					  })
+						})
 					: []) || [];
 
 			if (token !== requestId) return options.value;
diff --git a/flexirule/public/js/flexirule/rule_builder/composables/useRuleGraph.js b/flexirule/public/js/flexirule/rule_builder/composables/useRuleGraph.js
index 78e16334..49d31bc9 100644
--- a/flexirule/public/js/flexirule/rule_builder/composables/useRuleGraph.js
+++ b/flexirule/public/js/flexirule/rule_builder/composables/useRuleGraph.js
@@ -209,8 +209,8 @@ export function useRuleGraph() {
 						? "bottom"
 						: "left" // Side exit for return path (on the left to avoid After Last branch)
 					: isHorizontal
-					? "right"
-					: "bottom", // Standard flow exit
+						? "right"
+						: "bottom", // Standard flow exit
 				targetPosition: isHorizontal ? "left" : "top",
 			};
 		});
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/ComboBoxControl.vue b/flexirule/public/js/flexirule/rule_builder/controls/ComboBoxControl.vue
index a7b055f5..6f975ac1 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/ComboBoxControl.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/ComboBoxControl.vue
@@ -833,7 +833,8 @@ onBeforeUnmount(() => {
 /* Dropdown Animation */
 .dropdown-fade-enter-active,
 .dropdown-fade-leave-active {
-	transition: opacity 0.2s cubic-bezier(0.4, 0, 0.2, 1),
+	transition:
+		opacity 0.2s cubic-bezier(0.4, 0, 0.2, 1),
 		transform 0.2s cubic-bezier(0.4, 0, 0.2, 1);
 }
 
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/FlexValueControl.vue b/flexirule/public/js/flexirule/rule_builder/controls/FlexValueControl.vue
index aae01d24..9d5bbb45 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/FlexValueControl.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/FlexValueControl.vue
@@ -1060,7 +1060,7 @@ function handleBuilderUpdate(config) {
 					fieldType: fieldType.value,
 					referenceDoctype: referenceDoctype.value,
 					context: props.context,
-			  })
+				})
 			: props.context?.resolverDefaults;
 	const mergedConfig =
 		defaults && typeof defaults === "object" ? { ...defaults, ...config } : config;
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/MentionList.vue b/flexirule/public/js/flexirule/rule_builder/controls/MentionList.vue
index d55f72ef..8f521227 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/MentionList.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/MentionList.vue
@@ -139,7 +139,9 @@ export default {
 	background: #fff;
 	border: 1px solid #e2e8f0;
 	border-radius: 12px;
-	box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
+	box-shadow:
+		0 10px 15px -3px rgba(0, 0, 0, 0.1),
+		0 4px 6px -2px rgba(0, 0, 0, 0.05);
 	padding: 4px;
 	min-width: 220px;
 	overflow: hidden;
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/MultiSelectList.vue b/flexirule/public/js/flexirule/rule_builder/controls/MultiSelectList.vue
index b2dfdb33..1228b235 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/MultiSelectList.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/MultiSelectList.vue
@@ -742,7 +742,9 @@ onBeforeUnmount(() => {
 	align-items: center;
 	gap: 8px;
 	cursor: pointer;
-	transition: border-color 0.15s ease, box-shadow 0.15s ease;
+	transition:
+		border-color 0.15s ease,
+		box-shadow 0.15s ease;
 }
 
 .multi-select-trigger.invalid {
@@ -1047,7 +1049,9 @@ onBeforeUnmount(() => {
 
 .dropdown-fade-enter-active,
 .dropdown-fade-leave-active {
-	transition: opacity 0.2s ease, transform 0.2s ease;
+	transition:
+		opacity 0.2s ease,
+		transform 0.2s ease;
 }
 
 .dropdown-fade-enter-from,
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/ResourceMapperControl.vue b/flexirule/public/js/flexirule/rule_builder/controls/ResourceMapperControl.vue
index f2a9115d..31b57a73 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/ResourceMapperControl.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/ResourceMapperControl.vue
@@ -746,7 +746,7 @@ function normalizeModel(val) {
 						mappings: Array.isArray(table?.mappings)
 							? table.mappings.map((m) => ({ ...m, _id: m._id || generateId() }))
 							: [],
-				  }))
+					}))
 				: [],
 		};
 	}
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/TextControl.vue b/flexirule/public/js/flexirule/rule_builder/controls/TextControl.vue
index 2a719e0d..457b6c6c 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/TextControl.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/TextControl.vue
@@ -64,7 +64,9 @@ textarea.form-control {
 	padding: var(--fxr-input-padding-y) var(--fxr-input-padding-x);
 	border: 1px solid var(--fxr-border);
 	border-radius: var(--fxr-radius-md);
-	transition: border-color var(--fxr-transition-fast), box-shadow var(--fxr-transition-fast);
+	transition:
+		border-color var(--fxr-transition-fast),
+		box-shadow var(--fxr-transition-fast);
 }
 
 textarea.form-control:focus {
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/TransformControl.vue b/flexirule/public/js/flexirule/rule_builder/controls/TransformControl.vue
index fc851daa..74352889 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/TransformControl.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/TransformControl.vue
@@ -209,7 +209,9 @@ watch(
 	border-radius: 12px;
 	position: relative;
 	overflow: hidden;
-	box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
+	box-shadow:
+		0 4px 6px -1px rgba(0, 0, 0, 0.1),
+		0 2px 4px -1px rgba(0, 0, 0, 0.06);
 }
 
 .transform-header {
@@ -281,7 +283,9 @@ watch(
 	stroke-width: 2.5;
 	pointer-events: stroke;
 	cursor: pointer;
-	transition: stroke 0.2s, stroke-width 0.2s;
+	transition:
+		stroke 0.2s,
+		stroke-width 0.2s;
 }
 
 .mapping-line:hover,
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/ValueResolverControl.vue b/flexirule/public/js/flexirule/rule_builder/controls/ValueResolverControl.vue
index b70292c4..00e94b07 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/ValueResolverControl.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/ValueResolverControl.vue
@@ -491,8 +491,8 @@
 									v-for="opt in localState.fmt_op === 'fmt_money'
 										? numericFieldOptions
 										: localState.fmt_op === 'format_date'
-										? dateFieldOptions
-										: stringFieldOptions"
+											? dateFieldOptions
+											: stringFieldOptions"
 									:key="opt.value"
 									:value="opt.value"
 								>
@@ -505,8 +505,8 @@
 								localState.fmt_op === "fmt_money"
 									? __("Currency (Field or Code)")
 									: localState.fmt_op === "format_date"
-									? __("Date Format (e.g. YYYY-MM-DD)")
-									: __("Template")
+										? __("Date Format (e.g. YYYY-MM-DD)")
+										: __("Template")
 							}}</label>
 							<input
 								type="text"
diff --git a/flexirule/public/js/flexirule/rule_builder/stores/useGraphStore.js b/flexirule/public/js/flexirule/rule_builder/stores/useGraphStore.js
index 5f9bde06..ce5086c0 100644
--- a/flexirule/public/js/flexirule/rule_builder/stores/useGraphStore.js
+++ b/flexirule/public/js/flexirule/rule_builder/stores/useGraphStore.js
@@ -1046,8 +1046,8 @@ export const useGraphStore = defineStore("rule-builder-graph", () => {
 				source.field_b_type === "constant"
 					? String(source.constant_b ?? 0)
 					: source.field_b
-					? `frappe.utils.flt(${toDocExpression(source.field_b)})`
-					: "0";
+						? `frappe.utils.flt(${toDocExpression(source.field_b)})`
+						: "0";
 			const op = source.math_op || "+";
 			const precision = Number.isFinite(Number(source.precision))
 				? Number(source.precision)
@@ -1380,14 +1380,14 @@ export const useGraphStore = defineStore("rule-builder-graph", () => {
 							actionType: "Process",
 							processName: action.process_name,
 							operation: action.operation,
-					  }) || {}
+						}) || {}
 					: rawConfigData;
 			const conditionPayload =
 				actionTypeRaw === "Condition"
 					? getConditionPayload({
 							config: configData,
 							condition_json: action.condition_json,
-					  })
+						})
 					: null;
 			const effectiveConfig =
 				actionTypeRaw === "Condition"
diff --git a/flexirule/public/js/flexirule/rule_builder/stores/useRuleStore.js b/flexirule/public/js/flexirule/rule_builder/stores/useRuleStore.js
index b83d86d1..6d25e142 100644
--- a/flexirule/public/js/flexirule/rule_builder/stores/useRuleStore.js
+++ b/flexirule/public/js/flexirule/rule_builder/stores/useRuleStore.js
@@ -312,7 +312,7 @@ export const useRuleStore = defineStore("rule-builder-rule", () => {
 						? getConditionPayload({
 								config: node.data?.config,
 								condition_json: node.data?.condition_json,
-						  })
+							})
 						: null;
 
 				const finalInputMapping =
@@ -678,7 +678,7 @@ export const useRuleStore = defineStore("rule-builder-rule", () => {
 						istable: doctype_meta.istable,
 						is_submittable: doctype_meta.is_submittable,
 						track_changes: doctype_meta.track_changes,
-				  }
+					}
 				: null,
 		});
 	}
@@ -723,8 +723,8 @@ export const useRuleStore = defineStore("rule-builder-rule", () => {
 		let breadcrumbs = `
 			<li><a href="/app/rule">${__("Rule")}</a></li>
 			<li><a href="/app/rule/${rule_name.value}">${__(
-			rule_doc.value?.rule_name || rule_name.value
-		)}</a></li>
+				rule_doc.value?.rule_name || rule_name.value
+			)}</a></li>
 			<li class="disabled"><a href="#">${__("Builder")}</a></li>
 		`;
 		frappe.breadcrumbs.clear();
diff --git a/flexirule/ruleflow/README.md b/flexirule/ruleflow/README.md
index 6ff1ed6d..3980a342 100644
--- a/flexirule/ruleflow/README.md
+++ b/flexirule/ruleflow/README.md
@@ -8,26 +8,26 @@ FlexiRule Ruleflow is the execution backbone that transforms visual rule definit
 
 ## 🔑 Key Features
 
--   **Graph-Based Execution Engine**: Processes rules as directed graphs with full cycle detection
--   **Condition Compilation**: Pre-compiles visual conditions to optimized Python expressions
--   **Action Handler Strategy Pattern**: Pluggable architecture for different action types
--   **Comprehensive Error Handling**: Retry, rollback, escalate, and continue policies
--   **Async Execution Support**: Background job processing for long-running rules
--   **Permission Model**: Role-based execution control and audit logging
--   **Transaction Management**: Per-action savepoints for granular rollback capability
--   **Execution Tracing**: Detailed path tracking with timing and variable states
--   **Runtime Registry**: Layered caching (local → Redis → DB) for performance
+- **Graph-Based Execution Engine**: Processes rules as directed graphs with full cycle detection
+- **Condition Compilation**: Pre-compiles visual conditions to optimized Python expressions
+- **Action Handler Strategy Pattern**: Pluggable architecture for different action types
+- **Comprehensive Error Handling**: Retry, rollback, escalate, and continue policies
+- **Async Execution Support**: Background job processing for long-running rules
+- **Permission Model**: Role-based execution control and audit logging
+- **Transaction Management**: Per-action savepoints for granular rollback capability
+- **Execution Tracing**: Detailed path tracking with timing and variable states
+- **Runtime Registry**: Layered caching (local → Redis → DB) for performance
 
 ## 📚 Documentation
 
 For detailed architecture and deep dives, see the main documentation:
 
--   [System Architecture](../docs/architecture.md)
--   [Execution Engine Deep Dive](../docs/execution_engine.md)
--   [Condition System Deep Dive](../docs/condition_system.md)
--   [Trigger System Deep Dive](../docs/trigger_system.md)
--   [Process Adapter Standards](../docs/adapter_standards.md)
--   [Frontend (Rule Builder) Architecture](../docs/rule_builder.md)
+- [System Architecture](../docs/architecture.md)
+- [Execution Engine Deep Dive](../docs/execution_engine.md)
+- [Condition System Deep Dive](../docs/condition_system.md)
+- [Trigger System Deep Dive](../docs/trigger_system.md)
+- [Process Adapter Standards](../docs/adapter_standards.md)
+- [Frontend (Rule Builder) Architecture](../docs/rule_builder.md)
 
 ## 🔌 API Reference
 
@@ -35,35 +35,35 @@ All API methods are whitelisted and accessible via `frappe.call()`:
 
 ### Rule Execution & Testing
 
--   `test_rule` - Test execution with dry_run and save_log options
--   `simulate_rule` - Dry-run simulation without side effects
--   `execute_rule` - Direct rule execution
--   `get_execution_preview` - Predict execution path without running actions
+- `test_rule` - Test execution with dry_run and save_log options
+- `simulate_rule` - Dry-run simulation without side effects
+- `execute_rule` - Direct rule execution
+- `get_execution_preview` - Predict execution path without running actions
 
 ### Rule Lifecycle
 
--   `transition_rule` - Change rule status (Draft/Active/Disabled/etc)
--   `clone_rule` - Create a copy of a rule
--   `amend_rule` - Create a versioned amendment
--   `get_rule_versions` / `restore_rule_version` - Version history management
+- `transition_rule` - Change rule status (Draft/Active/Disabled/etc)
+- `clone_rule` - Create a copy of a rule
+- `amend_rule` - Create a versioned amendment
+- `get_rule_versions` / `restore_rule_version` - Version history management
 
 ### Cache & Metadata
 
--   `clear_cache` - Invalidate rule runtime registry
--   `get_contract_dto` - Get action/trigger contracts for frontend
--   `get_node_config_schema` - Get dynamic configuration schema
--   `get_action_context_schema` - Get available context variables
--   `get_rule_stats` - Get execution statistics
--   `get_process_operations` - Get available process operations
+- `clear_cache` - Invalidate rule runtime registry
+- `get_contract_dto` - Get action/trigger contracts for frontend
+- `get_node_config_schema` - Get dynamic configuration schema
+- `get_action_context_schema` - Get available context variables
+- `get_rule_stats` - Get execution statistics
+- `get_process_operations` - Get available process operations
 
 ### Validation & Utilities
 
--   `validate_rule_document` - Validate rule definition
--   `validate_node` - Validate single action/node
--   `get_operator_config` - Get condition builder operator mappings
--   `search_actions` - Fuzzy search across actions/operations
--   `get_doctype_fields` - Get DocType formatted fields
--   `export_rule` / `import_rule` - Rule import/export functionality
+- `validate_rule_document` - Validate rule definition
+- `validate_node` - Validate single action/node
+- `get_operator_config` - Get condition builder operator mappings
+- `search_actions` - Fuzzy search across actions/operations
+- `get_doctype_fields` - Get DocType formatted fields
+- `export_rule` / `import_rule` - Rule import/export functionality
 
 ### Example Usage
 
@@ -114,13 +114,13 @@ FlexiRule uses file-backed **Processes** which contain multiple **Operations**:
 
 ### Standard Processes
 
--   **Normalization** - Clean and standardize field data
--   **Validation** - Complex multi-field validation
--   **Enrichment** - Auto-populate fields from multiple sources
--   **Deduplication** - Detect and prevent duplicates using various algorithms
--   **Communication** - Send notifications/emails/messages
--   **Data Transformation** - Format, convert, and manipulate data
--   **Integration** - Call external APIs and webhooks
+- **Normalization** - Clean and standardize field data
+- **Validation** - Complex multi-field validation
+- **Enrichment** - Auto-populate fields from multiple sources
+- **Deduplication** - Detect and prevent duplicates using various algorithms
+- **Communication** - Send notifications/emails/messages
+- **Data Transformation** - Format, convert, and manipulate data
+- **Integration** - Call external APIs and webhooks
 
 ### Creating Custom Processes
 
@@ -133,29 +133,29 @@ FlexiRule uses file-backed **Processes** which contain multiple **Operations**:
 
 ## 🔐 Security & Permissions
 
--   All API endpoints require builder access via `require_builder_access()`
--   Condition evaluation uses `SafeFrappeAPI` (read-only methods only)
--   Permission auditing via `skip_permissions` with audit reason
--   Role-based execution control via `skip_for_roles`
--   Input validation through JSON schemas for Process configurations
+- All API endpoints require builder access via `require_builder_access()`
+- Condition evaluation uses `SafeFrappeAPI` (read-only methods only)
+- Permission auditing via `skip_permissions` with audit reason
+- Role-based execution control via `skip_for_roles`
+- Input validation through JSON schemas for Process configurations
 
 ## 📈 Monitoring & Observability
 
--   Rule Execution Log doctype captures all runs
--   Detailed path tracing with timestamps and variable states
--   Performance metrics via `get_rule_stats`
--   Debug mode for verbose logging
--   Execution timeouts and circuit breaker patterns
+- Rule Execution Log doctype captures all runs
+- Detailed path tracing with timestamps and variable states
+- Performance metrics via `get_rule_stats`
+- Debug mode for verbose logging
+- Execution timeouts and circuit breaker patterns
 
 ## 🔄 Extensibility
 
 The engine is designed for extension through:
 
--   **Custom Action Types**: Register new handlers via `HandlerRegistry`
--   **Process Operations**: Create reusable logic units with schemas
--   **Middleware Plugins**: Hook into execution lifecycle events
--   **Cache Providers**: Implement custom registry caching strategies
--   **Error Policies**: Define custom error handling behaviors
+- **Custom Action Types**: Register new handlers via `HandlerRegistry`
+- **Process Operations**: Create reusable logic units with schemas
+- **Middleware Plugins**: Hook into execution lifecycle events
+- **Cache Providers**: Implement custom registry caching strategies
+- **Error Policies**: Define custom error handling behaviors
 
 ## 📝 License
 
diff --git a/flexirule/ruleflow/process/deduplication/deduplication.json b/flexirule/ruleflow/process/deduplication/deduplication.json
index ff0c5b5e..90b390b4 100644
--- a/flexirule/ruleflow/process/deduplication/deduplication.json
+++ b/flexirule/ruleflow/process/deduplication/deduplication.json
@@ -28,7 +28,7 @@
 			"writes_vars": "[{\"fieldname\":\"has_match\",\"fieldtype\":\"Check\",\"label\":\"Has Match\"},{\"fieldname\":\"match_count\",\"fieldtype\":\"Int\",\"label\":\"Match Count\"},{\"fieldname\":\"best_match\",\"fieldtype\":\"JSON\",\"label\":\"Best Match\"},{\"fieldname\":\"matches\",\"fieldtype\":\"JSON\",\"label\":\"Matches\"}]"
 		},
 		{
-			"action_overrides": "{\"contract_v2\":{\"adapter_key\":\"dedupe\",\"capabilities\":{\"allows_async\":false,\"can_stop_save\":false,\"has_side_effect\":false,\"requires_doc\":true,\"transactional\":false,\"writes_to\":\"Context\"},\"config_schema\":{\"additionalProperties\":false,\"properties\":{\"blocking_prefix_length\":{\"default\":3,\"minimum\":1,\"type\":\"integer\"},\"candidate_doctype\":{\"type\":[\"string\",\"null\"]},\"candidate_fields\":{\"items\":{\"type\":\"string\"},\"type\":[\"string\",\"array\"]},\"candidate_filters\":{\"type\":\"object\"},\"candidate_limit\":{\"default\":1000,\"minimum\":1,\"type\":\"integer\"},\"candidate_order_by\":{\"type\":[\"string\",\"null\"]},\"exclude_current_document\":{\"default\":true,\"type\":\"boolean\"},\"fields\":{\"items\":{\"type\":\"string\"},\"type\":[\"string\",\"array\"]},\"fields_config\":{\"items\":{\"additionalProperties\":false,\"properties\":{\"algorithm\":{\"enum\":[\"Exact\",\"Fuzzy\",\"Contains\",\"Phonetic\",\"Numeric Range\",\"Date Distance\"],\"type\":\"string\"},\"fieldname\":{\"type\":\"string\"},\"included_in_filters\":{\"type\":\"boolean\"},\"normalize\":{\"type\":\"boolean\"},\"threshold\":{\"maximum\":1,\"minimum\":0,\"type\":\"number\"},\"tolerance\":{\"minimum\":0,\"type\":\"number\"},\"weight\":{\"minimum\":0,\"type\":\"number\"}},\"required\":[\"fieldname\"],\"type\":\"object\"},\"type\":\"array\"},\"ignore_cancelled\":{\"default\":true,\"type\":\"boolean\"},\"minimum_fields_matched\":{\"default\":1,\"minimum\":1,\"type\":\"integer\"},\"overall_threshold\":{\"default\":0.8,\"maximum\":1,\"minimum\":0,\"type\":\"number\"},\"stop_after_first_match\":{\"default\":false,\"type\":\"boolean\"}},\"type\":\"object\",\"ui_schema\":[{\"fieldname\":\"fields\",\"fieldtype\":\"Data\",\"label\":\"Fields\"},{\"fieldname\":\"fields_config\",\"fieldtype\":\"Table\",\"label\":\"Field Comparison Rules\"},{\"default\":0.8,\"fieldname\":\"overall_threshold\",\"fieldtype\":\"Float\",\"label\":\"Overall Threshold\"},{\"default\":1,\"fieldname\":\"minimum_fields_matched\",\"fieldtype\":\"Int\",\"label\":\"Minimum Fields Matched\"},{\"fieldname\":\"candidate_doctype\",\"fieldtype\":\"Link\",\"label\":\"Candidate DocType\",\"options\":\"DocType\"},{\"default\":1000,\"fieldname\":\"candidate_limit\",\"fieldtype\":\"Int\",\"label\":\"Candidate Limit\"}]},\"policy\":{\"allowed_mutations\":[\"Set Context Variable\",\"Update Context Variable\"],\"allowed_return_types\":[\"Single Record\"],\"default_return_type\":\"Single Record\",\"require_return_type\":false,\"require_return_variable\":false},\"result_schema\":{\"additionalProperties\":false,\"properties\":{\"best_match\":{\"type\":[\"object\",\"null\"]},\"candidate_count\":{\"type\":\"integer\"},\"criteria\":{\"type\":\"object\"},\"has_match\":{\"type\":\"boolean\"},\"match_count\":{\"type\":\"integer\"},\"matches\":{\"items\":{\"type\":\"object\"},\"type\":\"array\"}},\"required\":[\"has_match\",\"match_count\",\"candidate_count\",\"matches\",\"criteria\"],\"type\":\"object\"}}}",
+			"action_overrides": "{\"contract_v2\": {\"adapter_key\": \"dedupe\", \"capabilities\": {\"allows_async\": false, \"can_stop_save\": false, \"has_side_effect\": false, \"requires_doc\": true, \"transactional\": false, \"writes_to\": \"Context\"}, \"config_schema\": {\"additionalProperties\": false, \"properties\": {\"blocking_prefix_length\": {\"default\": 3, \"minimum\": 1, \"type\": \"integer\"}, \"candidate_doctype\": {\"type\": [\"string\", \"null\"]}, \"candidate_fields\": {\"items\": {\"type\": \"string\"}, \"type\": [\"string\", \"array\"]}, \"candidate_filters\": {\"type\": \"object\"}, \"candidate_limit\": {\"default\": 1000, \"minimum\": 1, \"type\": \"integer\"}, \"candidate_order_by\": {\"type\": [\"string\", \"null\"]}, \"exclude_current_document\": {\"default\": true, \"type\": \"boolean\"}, \"fields\": {\"items\": {\"type\": \"string\"}, \"type\": [\"string\", \"array\"]}, \"fields_config\": {\"items\": {\"additionalProperties\": false, \"properties\": {\"algorithm\": {\"enum\": [\"Exact\", \"Fuzzy\", \"Contains\", \"Phonetic\", \"Numeric Range\", \"Date Distance\"], \"type\": \"string\"}, \"fieldname\": {\"type\": \"string\"}, \"included_in_filters\": {\"type\": \"boolean\"}, \"normalize\": {\"type\": \"boolean\"}, \"threshold\": {\"maximum\": 1, \"minimum\": 0, \"type\": \"number\"}, \"tolerance\": {\"minimum\": 0, \"type\": \"number\"}, \"weight\": {\"minimum\": 0, \"type\": \"number\"}}, \"required\": [\"fieldname\"], \"type\": \"object\"}, \"type\": \"array\"}, \"ignore_cancelled\": {\"default\": true, \"type\": \"boolean\"}, \"minimum_fields_matched\": {\"default\": 1, \"minimum\": 1, \"type\": \"integer\"}, \"overall_threshold\": {\"default\": 0.8, \"maximum\": 1, \"minimum\": 0, \"type\": \"number\"}, \"stop_after_first_match\": {\"default\": false, \"type\": \"boolean\"}}, \"type\": \"object\", \"ui_schema\": [{\"fieldname\": \"fields\", \"fieldtype\": \"Data\", \"label\": \"Fields\"}, {\"fieldname\": \"fields_config\", \"fieldtype\": \"Table\", \"label\": \"Field Comparison Rules\", \"fields\": [{\"fieldname\": \"fieldname\", \"fieldtype\": \"DocField\", \"options\": \"vars.document_type\", \"label\": \"Field\", \"reqd\": 1, \"in_list_view\": 1}, {\"fieldname\": \"algorithm\", \"fieldtype\": \"Select\", \"label\": \"Algorithm\", \"options\": \"Exact\\nFuzzy\\nPhonetic\\nContains\\nNumeric Range\\nDate Distance\", \"reqd\": 1, \"default\": \"Fuzzy\", \"in_list_view\": 1}, {\"fieldname\": \"weight\", \"fieldtype\": \"Float\", \"label\": \"Weight\", \"default\": 0.5, \"in_list_view\": 1}, {\"fieldname\": \"threshold\", \"fieldtype\": \"Float\", \"label\": \"Threshold\", \"default\": 0.8, \"in_list_view\": 1, \"depends_on\": \"eval:doc.algorithm !== 'Exact'\"}, {\"fieldname\": \"tolerance\", \"fieldtype\": \"Int\", \"label\": \"Tolerance\", \"default\": 30, \"in_list_view\": 1, \"depends_on\": \"eval:doc.algorithm in ['Numeric Range', 'Date Distance']\", \"description\": \"Allowed deviation (plus/minus)\"}, {\"fieldname\": \"normalize\", \"fieldtype\": \"Check\", \"label\": \"Normalize Values\", \"default\": 1, \"in_list_view\": 1}, {\"fieldname\": \"included_in_filters\", \"fieldtype\": \"Check\", \"label\": \"Use for Blocking\", \"default\": 1, \"in_list_view\": 1}]}, {\"default\": 0.8, \"fieldname\": \"overall_threshold\", \"fieldtype\": \"Float\", \"label\": \"Overall Threshold\"}, {\"default\": 1, \"fieldname\": \"minimum_fields_matched\", \"fieldtype\": \"Int\", \"label\": \"Minimum Fields Matched\"}, {\"fieldname\": \"candidate_doctype\", \"fieldtype\": \"Link\", \"label\": \"Candidate DocType\", \"options\": \"DocType\"}, {\"default\": 1000, \"fieldname\": \"candidate_limit\", \"fieldtype\": \"Int\", \"label\": \"Candidate Limit\"}]}, \"policy\": {\"allowed_mutations\": [\"Set Context Variable\", \"Update Context Variable\"], \"allowed_return_types\": [\"Single Record\"], \"default_return_type\": \"Single Record\", \"require_return_type\": false, \"require_return_variable\": false}, \"result_schema\": {\"additionalProperties\": false, \"properties\": {\"best_match\": {\"type\": [\"object\", \"null\"]}, \"candidate_count\": {\"type\": \"integer\"}, \"criteria\": {\"type\": \"object\"}, \"has_match\": {\"type\": \"boolean\"}, \"match_count\": {\"type\": \"integer\"}, \"matches\": {\"items\": {\"type\": \"object\"}, \"type\": \"array\"}}, \"required\": [\"has_match\", \"match_count\", \"candidate_count\", \"matches\", \"criteria\"], \"type\": \"object\"}}}",
 			"allows_async": 0,
 			"can_stop_save": 0,
 			"color": "#f59e0a",
diff --git a/flexirule/ruleflow/process/enrichment/enrichment.js b/flexirule/ruleflow/process/enrichment/enrichment.js
index e767087d..2bb73a65 100644
--- a/flexirule/ruleflow/process/enrichment/enrichment.js
+++ b/flexirule/ruleflow/process/enrichment/enrichment.js
@@ -172,8 +172,8 @@ flexirule.processes["Enrichment"] = {
 				const fields = Array.isArray(config.field_list)
 					? config.field_list
 					: typeof config.field_list === "string"
-					? config.field_list.split("\n").filter((f) => f.trim())
-					: [];
+						? config.field_list.split("\n").filter((f) => f.trim())
+						: [];
 
 				return fields.map((field) => {
 					return {

From b9f1336915bebec82710f93dd0c99a535cec812f Mon Sep 17 00:00:00 2001
From: abdoruzaqi <245876665+abdoruzaqi@users.noreply.github.com>
Date: Sun, 24 May 2026 17:15:17 +0000
Subject: [PATCH 3/4] refactor: use FlexiGrid for AssignmentConfig and reorder
 columns

- Refactored `AssignmentConfig.vue` to use `FlexiGrid` for managing assignments.
- Reordered columns to: Run If, Target Field, Operator, Value Expression.
- Added `Button` fieldtype support to `ControlFactory.vue`.
- Enhanced `FlexiGrid.vue` to emit `cell-click` events.
- Preserved dynamic logic for operator filtering and structured value context.
- Fixed linting issues and removed redundant row management code.
---
 .../rule_config/types/AssignmentConfig.vue    | 506 ++++++------------
 .../rule_builder/controls/ControlFactory.vue  | 113 ++--
 .../rule_builder/controls/FlexiGrid.vue       |  33 +-
 3 files changed, 238 insertions(+), 414 deletions(-)

diff --git a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/AssignmentConfig.vue b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/AssignmentConfig.vue
index 96e97ac4..e19f87ae 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/AssignmentConfig.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/AssignmentConfig.vue
@@ -4,7 +4,7 @@
 			<div class="d-flex align-items-center justify-content-between">
 				<div class="d-flex align-items-center fxr-gap-3">
 					<div class="header-icon-box">
-						<i class="fa fa-list-ol"></i>
+						<i class="fa fa-list-ol" />
 					</div>
 					<div class="d-flex flex-column">
 						<h5 class="mb-0 fw-bold">{{ __("Batch Assignments") }}</h5>
@@ -15,172 +15,20 @@
 						</span>
 					</div>
 				</div>
-				<button
-					v-if="assignments.length > 1"
-					class="fxr-btn fxr-btn--ghost fxr-btn--sm text-danger"
-					@click="clearAssignments"
-					:disabled="isReadOnly"
-				>
-					<i class="fa fa-eraser me-1"></i>
-					{{ __("Clear All") }}
-				</button>
 			</div>
 		</div>
 
-		<!-- Horizontal Table Grid Header -->
-		<div v-if="assignments.length" class="assignment-grid-header">
-			<div class="grid-col-target">{{ __("Target Field") }}</div>
-			<div class="grid-col-operator">{{ __("Operator") }}</div>
-			<div class="grid-col-value">{{ __("Value Expression") }}</div>
-			<div class="grid-col-when">{{ __("Run If") }}</div>
-			<div class="grid-col-actions"></div>
+		<div class="assignment-grid-wrap mt-2">
+			<FlexiGrid
+				:df="gridDf"
+				:model-value="assignments"
+				:engine="assignmentEngine"
+				:read_only="isReadOnly"
+				@update:model-value="onAssignmentsUpdate"
+				@cell-click="onCellClick"
+			/>
 		</div>
 
-		<div class="assignments-list">
-			<div
-				v-for="(assignment, index) in assignments"
-				:key="assignment.name"
-				class="assignment-grid-row align-items-center mb-2"
-			>
-				<!-- Target ComboBox with Type Badge support -->
-				<div class="grid-col-target">
-					<ComboBoxControl
-						:df="{ fieldtype: 'FieldPicker', label: '' }"
-						:modelValue="assignment.target"
-						:options="targetOptions"
-						:read_only="isReadOnly"
-						:hideLabel="true"
-						:trigger="'button'"
-						:placeholder="__('Target field/variable...')"
-						:allowCustomValue="false"
-						@update:modelValue="(val) => onTargetChange(index, val)"
-					/>
-				</div>
-
-				<!-- Operator Selector -->
-				<div class="grid-col-operator">
-					<ComboBoxControl
-						:df="{ fieldtype: 'Select', label: '' }"
-						:options="getAvailableOperators(assignment.target)"
-						:modelValue="assignment.operator"
-						:read_only="isReadOnly"
-						:hideLabel="true"
-						:trigger="'button'"
-						@update:modelValue="(val) => onOperatorChange(index, val)"
-					/>
-				</div>
-
-				<!-- Value Expression Editor -->
-				<div class="grid-col-value">
-					<template v-if="needsValue(assignment.operator)">
-						<div class="value-mode-wrap">
-							<FlexValueControl
-								class="flex-1 min-w-0"
-								:context="{
-									df:
-										targetOptions.find((o) => o.value === assignment.target) ||
-										{},
-									operator: assignment.operator,
-									referenceDoctype: getTargetDoctype(assignment.target),
-								}"
-								:modelValue="assignment.value"
-								:read_only="isReadOnly"
-								:engine="store"
-								:doc="store.rule_doc"
-								:variableOptions="variable_options"
-								:placeholder="__('Type value...')"
-								@update:modelValue="(val) => updateTemplate(index, val)"
-							/>
-						</div>
-					</template>
-					<div v-else class="operator-hint-text text-muted small">
-						<i class="fa fa-info-circle me-1"></i>
-						{{ operatorNoValueHint(assignment.operator) }}
-					</div>
-				</div>
-
-				<div class="grid-col-when">
-					<div class="when-editor-cell">
-						<button
-							class="fxr-btn fxr-btn--sm w-100 when-toggle-btn"
-							:class="hasWhenCondition(assignment) ? 'is-active' : 'is-default'"
-							:disabled="isReadOnly"
-							@click="openWhenConditionEditor(index)"
-						>
-							<i
-								:class="
-									hasWhenCondition(assignment)
-										? 'fa fa-filter'
-										: 'fa fa-play-circle-o'
-								"
-								class="me-2"
-							></i>
-							<span class="truncate">
-								{{
-									hasWhenCondition(assignment)
-										? __("Condition Set")
-										: __("Always Run")
-								}}
-							</span>
-						</button>
-					</div>
-				</div>
-
-				<!-- Row Actions -->
-				<div
-					class="grid-col-actions d-flex align-items-center justify-content-end fxr-gap-1"
-				>
-					<button
-						class="fxr-btn fxr-btn--icon fxr-btn--sm fxr-btn--ghost"
-						@click="moveAssignment(index, -1)"
-						:disabled="isReadOnly || index === 0"
-						:title="__('Move Up')"
-						aria-label="Move Up"
-					>
-						<i class="fa fa-chevron-up"></i>
-					</button>
-					<button
-						class="fxr-btn fxr-btn--icon fxr-btn--sm fxr-btn--ghost"
-						@click="moveAssignment(index, 1)"
-						:disabled="isReadOnly || index === assignments.length - 1"
-						:title="__('Move Down')"
-						aria-label="Move Down"
-					>
-						<i class="fa fa-chevron-down"></i>
-					</button>
-					<button
-						class="fxr-btn fxr-btn--icon fxr-btn--sm fxr-btn--ghost text-danger"
-						@click="removeAssignment(index)"
-						:disabled="isReadOnly"
-						:title="__('Remove')"
-						aria-label="Remove Assignment"
-					>
-						<i class="fa fa-trash"></i>
-					</button>
-				</div>
-			</div>
-		</div>
-
-		<div
-			v-if="!assignments.length"
-			class="empty-state d-flex flex-column align-items-center justify-content-center py-5"
-		>
-			<div class="empty-state-icon mb-3">
-				<i class="fa fa-list-ol fa-3x text-muted opacity-25"></i>
-			</div>
-			<div class="text-center px-4">
-				<h6 class="mb-1 fw-bold text-muted">{{ __("No Assignments Yet") }}</h6>
-				<p class="small text-muted mb-0">
-					{{ __("Add an assignment to start mutating document fields or variables.") }}
-				</p>
-			</div>
-		</div>
-
-		<button class="add-assignment-btn mt-2" @click="addAssignment" :disabled="isReadOnly">
-			<i class="fa fa-plus"></i>
-			<span>{{ __("Add Assignment") }}</span>
-		</button>
-
 		<Teleport to="body">
 			<div
 				v-if="whenEditor.open"
@@ -194,16 +42,16 @@
 							class="fxr-btn fxr-btn--icon fxr-btn--sm fxr-btn--ghost"
 							@click="closeWhenConditionEditor"
 						>
-							<i class="fa fa-times"></i>
+							<i class="fa fa-times" />
 						</button>
 					</div>
 					<div class="condition-builder-wrap">
 						<ConditionBuilder
-							:modelValue="whenEditor.draft"
-							:docFields="whenConditionDocFields"
-							:variableOptions="variable_options"
-							:readOnly="false"
-							@update:modelValue="(val) => (whenEditor.draft = val)"
+							:model-value="whenEditor.draft"
+							:doc-fields="whenConditionDocFields"
+							:variable-options="variable_options"
+							:read-only="false"
+							@update:model-value="(val) => (whenEditor.draft = val)"
 						/>
 					</div>
 					<div class="d-flex justify-content-between mt-3">
@@ -235,12 +83,10 @@
 </template>
 
 <script setup>
-import { computed, watch, ref } from "vue";
+import { computed, watch, ref, reactive } from "vue";
 import { useActionConfig } from "../../../composables/useActionConfig";
-import ComboBoxControl from "../../../controls/ComboBoxControl.vue";
-import FlexValueControl from "../../../controls/FlexValueControl.vue";
+import FlexiGrid from "../../../controls/FlexiGrid.vue";
 import ConditionBuilder from "../../condition_builder/ConditionBuilder.vue";
-import { compileSegmentsToJinja } from "../../../utils/text_generator";
 import { ASSIGNMENT_OPERATOR_METADATA } from "../../../../core/contracts.js";
 
 const props = defineProps({
@@ -252,19 +98,134 @@ const props = defineProps({
 const isReadOnly = computed(() => !!props.readOnly || !!props.read_only);
 
 const { doctype_fields, variable_options, update_action_field, store } = useActionConfig(props);
-const supportedTemplateModes = [
-	"formula",
-	"resolver",
-	"link",
-	"dynamic-link",
-	"select",
-	"boolean",
-	"multiselect",
-	"json",
-	"add-key",
-];
+
 const whenEditor = ref({ open: false, index: -1, draft: null });
 
+// ── FlexiGrid Configuration ──────────────────────────────────────────────────
+
+const gridDf = computed(() => ({
+	fieldname: "assignments",
+	fieldtype: "FlexiGrid",
+	label: "",
+	fields: [
+		{
+			fieldname: "when_label",
+			label: __("Run If"),
+			fieldtype: "Button",
+			btn_class: "when-toggle-btn",
+			icon: "fa fa-play-circle-o",
+			in_list_view: 1,
+			width: "120px",
+		},
+		{
+			fieldname: "target",
+			label: __("Target Field"),
+			fieldtype: "FieldPicker",
+			options: targetOptions.value,
+			placeholder: __("Target field/variable..."),
+			in_list_view: 1,
+			width: "200px",
+			default: "",
+		},
+		{
+			fieldname: "operator",
+			label: __("Operator"),
+			fieldtype: "Select",
+			options: [], // Dynamic options handled by getEffectiveDf
+			in_list_view: 1,
+			width: "120px",
+			default: "set",
+		},
+		{
+			fieldname: "value",
+			label: __("Value Expression"),
+			fieldtype: "Structured Value",
+			in_list_view: 1,
+			width: "300px",
+			default: { mode: "static", value: "" },
+		},
+	],
+}));
+
+/**
+ * assignmentEngine: Provides dynamic dependency handling for FlexiGrid.
+ */
+const assignmentEngine = reactive({
+	rule_doc: store.rule_doc,
+	dependency_states: {},
+
+	handleFieldChange(fieldname, value, row) {
+		const index = assignments.value.findIndex((a) => a.name === row.name);
+		if (index === -1) return;
+
+		if (fieldname === "target") {
+			onTargetChange(index, value);
+		} else if (fieldname === "operator") {
+			onOperatorChange(index, value);
+		} else if (fieldname === "value") {
+			updateTemplate(index, value);
+		}
+	},
+
+	getNormalizedDf(df, rowName) {
+		const row = assignments.value.find((a) => a.name === rowName);
+		if (!row) return df;
+
+		const normalized = { ...df };
+
+		if (df.fieldname === "when_label") {
+			const hasCond = hasWhenCondition(row);
+			normalized.label = hasCond ? __("Condition Set") : __("Always Run");
+			normalized.icon = hasCond ? "fa fa-filter" : "fa fa-play-circle-o";
+			normalized.btn_class = hasCond ? "when-toggle-btn is-active" : "when-toggle-btn is-default";
+		}
+
+		if (df.fieldname === "operator") {
+			normalized.options = getAvailableOperators(row.target);
+		}
+
+		if (df.fieldname === "value") {
+			if (!needsValue(row.operator)) {
+				normalized.hidden = true;
+				// normalized.description = operatorNoValueHint(row.operator);
+			} else {
+				normalized.hidden = false;
+				normalized.target_fieldtype = getTargetFieldtype(row.target);
+				normalized.target_options = getTargetOptions(row.target);
+				normalized.target_doctype = getTargetDoctype(row.target);
+				normalized.context = {
+					df: targetOptions.value.find((o) => o.value === row.target) || {},
+					operator: row.operator,
+					referenceDoctype: getTargetDoctype(row.target),
+				};
+			}
+		}
+
+		return normalized;
+	},
+
+	getFieldState(df, rowName) {
+		const row = assignments.value.find((a) => a.name === rowName);
+		if (!row) return {};
+
+		if (df.fieldname === "value" && !needsValue(row.operator)) {
+			return { hidden: true };
+		}
+		return { hidden: false };
+	},
+});
+
+function onAssignmentsUpdate(newAssignments) {
+	assignments.value = newAssignments;
+	syncToNode();
+}
+
+function onCellClick({ fieldname, rowIndex }) {
+	if (fieldname === "when_label") {
+		openWhenConditionEditor(rowIndex);
+	}
+}
+
 // ─── Operator Helpers ────────────────────────────────────────────────────────
 
 const OPERATOR_HINTS = {
@@ -480,59 +441,28 @@ function syncToNode() {
 	store.mark_dirty();
 }
 
-function addAssignment() {
-	assignments.value.push({
-		name: makeRandomString(9),
-		target: "",
-		operator: "set",
-		when_condition: null,
-		when_expression: "",
-		pythonExpression: "",
-		value: { mode: "static", value: "" },
-	});
-	syncToNode();
-}
-
-function removeAssignment(index) {
-	assignments.value.splice(index, 1);
-	syncToNode();
-}
-
-function moveAssignment(index, direction) {
-	const newIndex = index + direction;
-	if (newIndex < 0 || newIndex >= assignments.value.length) return;
-	const item = assignments.value.splice(index, 1)[0];
-	assignments.value.splice(newIndex, 0, item);
-	syncToNode();
-}
-
-function clearAssignments() {
-	frappe.confirm(__("Are you sure you want to clear all assignments?"), () => {
-		assignments.value = [];
-		syncToNode();
-	});
-}
 
 function onTargetChange(index, value) {
-	assignments.value[index].target = value;
+	const assignment = assignments.value[index];
+	assignment.target = value;
 
 	// Intelligent defaulting for resolver kind based on target
-	if (assignments.value[index].value?.mode === "resolver") {
-		const config = assignments.value[index].value.config || {};
+	if (assignment.value?.mode === "resolver") {
+		const config = assignment.value.config || {};
 		if (!config.kind || config.kind === "resolver") {
 			config.kind = getDefaultResolverKind(value);
-			assignments.value[index].value.config = config;
+			assignment.value.config = config;
 		}
 	}
 
 	// Reset operator if it's no longer compatible with new target type
 	const available = getAvailableOperators(value).map((o) => o.value);
-	if (!available.includes(assignments.value[index].operator)) {
+	if (!available.includes(assignment.operator)) {
 		const fieldtype = getTargetFieldtype(value);
 		if (fieldtype === "Check") {
-			assignments.value[index].operator = "toggle";
+			assignment.operator = "toggle";
 		} else {
-			assignments.value[index].operator = "set";
+			assignment.operator = "set";
 		}
 	}
 	syncToNode();
@@ -662,34 +592,7 @@ defineExpose({ validate });
 	font-size: 18px;
 }
 
-/* Horizontal Table Grid Styling */
-.assignment-grid-header,
-.assignment-grid-row {
-	display: grid;
-	grid-template-columns:
-		minmax(160px, 1.2fr) minmax(100px, 0.7fr) minmax(240px, 2fr) minmax(120px, 0.8fr)
-		80px;
-	gap: 12px;
-	align-items: center;
-}
-
-.assignment-grid-header {
-	padding: 10px 16px;
-	font-size: 10px;
-	font-weight: 700;
-	color: var(--fxr-text-muted, #64748b);
-	text-transform: uppercase;
-	letter-spacing: 0.05em;
-	border-bottom: 1px solid var(--fxr-border, #e2e8f0);
-	margin-bottom: 8px;
-}
-
-.when-editor-cell {
-	display: flex;
-	flex-direction: column;
-}
-
-.when-toggle-btn {
+:deep(.when-toggle-btn) {
 	justify-content: flex-start;
 	padding: 6px 10px;
 	font-weight: 600;
@@ -697,25 +600,26 @@ defineExpose({ validate });
 	border-radius: var(--fxr-radius-md, 6px);
 	border: 1px solid transparent;
 	transition: all 0.2s ease;
+	text-align: left;
 }
 
-.when-toggle-btn.is-default {
+:deep(.when-toggle-btn.is-default) {
 	background: var(--fxr-bg-muted, #f1f5f9);
 	color: var(--fxr-text-secondary, #475569);
 }
 
-.when-toggle-btn.is-default:hover {
+:deep(.when-toggle-btn.is-default:hover) {
 	background: var(--fxr-bg-hover, #f8fafc);
 	border-color: var(--fxr-border-strong, #cbd5e1);
 }
 
-.when-toggle-btn.is-active {
+:deep(.when-toggle-btn.is-active) {
 	background: var(--fxr-badge-var, #f3e8ff);
 	color: var(--fxr-badge-var-text, #7c3aed);
 	border-color: rgba(124, 58, 237, 0.2);
 }
 
-.when-toggle-btn.is-active:hover {
+:deep(.when-toggle-btn.is-active:hover) {
 	background: #ede9fe;
 	border-color: rgba(124, 58, 237, 0.3);
 }
@@ -748,98 +652,4 @@ defineExpose({ validate });
 	border-radius: 8px;
 	padding: 8px;
 }
-
-/* Value mode toggle + control wrapper */
-.value-mode-wrap {
-	display: flex;
-	align-items: center;
-	gap: 8px;
-	width: 100%;
-}
-
-.value-mode-toggle {
-	flex-shrink: 0;
-	width: 30px;
-	height: 30px;
-	display: flex;
-	align-items: center;
-	justify-content: center;
-	border-radius: var(--fxr-radius-md, 6px);
-	color: var(--fxr-text-muted, #64748b);
-	border: 1px solid var(--fxr-border, #e2e8f0);
-	background: var(--fxr-bg-input, #ffffff);
-	transition: all 0.2s ease;
-	cursor: pointer;
-}
-
-.value-mode-toggle:hover:not(:disabled) {
-	color: var(--fxr-accent, #2490ef);
-	border-color: var(--fxr-accent, #2490ef);
-	background: var(--fxr-bg-hover, #f8fafc);
-}
-
-.assignment-grid-row {
-	background: var(--fxr-bg-card, #ffffff);
-	border: 1px solid var(--fxr-border, #e2e8f0);
-	border-radius: var(--fxr-radius-lg, 8px);
-	padding: 10px 16px;
-	transition: all 0.2s ease;
-	box-shadow: var(--fxr-shadow-sm);
-}
-
-.assignment-grid-row:hover {
-	border-color: var(--fxr-accent, #2490ef);
-	box-shadow: var(--fxr-shadow-md);
-	transform: translateY(-1px);
-}
-
-.operator-hint-text {
-	display: flex;
-	align-items: center;
-	padding: 6px 12px;
-	background: #f8fafc;
-	border: 1px solid #e2e8f0;
-	border-radius: 6px;
-	height: 32px;
-	white-space: nowrap;
-	overflow: hidden;
-	text-overflow: ellipsis;
-}
-
-.empty-state {
-	border: 2px dashed var(--fxr-border, #e2e8f0);
-	border-radius: var(--fxr-radius-lg, 12px);
-	background-color: var(--fxr-bg-muted, #f8fafc);
-	transition: all 0.2s ease;
-	flex: 0 0 auto;
-}
-
-.empty-state:hover {
-	border-color: var(--fxr-border-strong);
-	background-color: var(--fxr-bg-hover);
-}
-
-.add-assignment-btn {
-	display: flex;
-	align-items: center;
-	justify-content: center;
-	gap: 8px;
-	background: var(--fxr-bg-page, #f8fafc);
-	border: 1px dashed var(--fxr-border-strong, #cbd5e1);
-	border-radius: var(--fxr-radius-lg, 8px);
-	padding: 12px;
-	width: 100%;
-	color: var(--fxr-text-secondary, #475569);
-	font-weight: 600;
-	font-size: 13px;
-	transition: all 0.2s ease;
-	cursor: pointer;
-	margin-top: 12px;
-}
-
-.add-assignment-btn:hover:not(:disabled) {
-	background: var(--fxr-accent-light, #e0f2fe);
-	border-color: var(--fxr-accent, #2490ef);
-	color: var(--fxr-accent, #2490ef);
-}
 </style>
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/ControlFactory.vue b/flexirule/public/js/flexirule/rule_builder/controls/ControlFactory.vue
index c42f06f3..361c464c 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/ControlFactory.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/ControlFactory.vue
@@ -10,7 +10,7 @@
 		>
 			<ComboBoxControl
 				:df="df"
-				:modelValue="modelValue"
+				:model-value="modelValue"
 				:rule="engine?.rule_doc"
 				:doctype="comboDoctype"
 				:options="comboOptions"
@@ -23,10 +23,10 @@
 						: null
 				"
 				:trigger="df?.fieldtype === 'FieldPicker' ? 'button' : 'input'"
-				:hideLabel="hideLabel"
-				:hideDescription="hideDescription"
+				:hide-label="hideLabel"
+				:hide-description="hideDescription"
 				:read_only="df?.read_only"
-				@update:modelValue="$emit('update:modelValue', $event)"
+				@update:model-value="$emit('update:modelValue', $event)"
 			/>
 		</template>
 
@@ -34,19 +34,19 @@
 		<SelectControl
 			v-else-if="df?.fieldtype === 'Select'"
 			:df="df"
-			:modelValue="modelValue"
-			:hideLabel="hideLabel"
-			:hideDescription="hideDescription"
-			@update:modelValue="$emit('update:modelValue', $event)"
+			:model-value="modelValue"
+			:hide-label="hideLabel"
+			:hide-description="hideDescription"
+			@update:model-value="$emit('update:modelValue', $event)"
 		/>
 
 		<!-- Check -->
 		<CheckControl
 			v-else-if="df?.fieldtype === 'Check'"
 			:df="df"
-			:modelValue="Boolean(modelValue)"
-			:hideLabel="hideLabel"
-			@update:modelValue="$emit('update:modelValue', $event ? 1 : 0)"
+			:model-value="Boolean(modelValue)"
+			:hide-label="hideLabel"
+			@update:model-value="$emit('update:modelValue', $event ? 1 : 0)"
 		/>
 
 		<!-- Number (Int, Float, Currency, Percent) -->
@@ -70,7 +70,7 @@
 				@input="$emit('update:modelValue', $event.target.value)"
 				@blur="evaluateMath($event, df.fieldtype)"
 				@keydown.enter="evaluateMath($event, df.fieldtype)"
-			/>
+			>
 			<div v-if="df.description" class="description text-muted mt-1">
 				{{ __(df.description) }}
 			</div>
@@ -80,10 +80,10 @@
 		<TimePickerControl
 			v-else-if="['Date', 'Datetime'].includes(df?.fieldtype)"
 			:df="df"
-			:modelValue="modelValue"
-			:hideLabel="hideLabel"
-			:hideDescription="hideDescription"
-			@update:modelValue="$emit('update:modelValue', $event)"
+			:model-value="modelValue"
+			:hide-label="hideLabel"
+			:hide-description="hideDescription"
+			@update:model-value="$emit('update:modelValue', $event)"
 		/>
 
 		<!-- Time -->
@@ -103,7 +103,7 @@
 				:disabled="df.read_only"
 				:aria-label="__(df.label)"
 				@input="$emit('update:modelValue', $event.target.value)"
-			/>
+			>
 			<div v-if="df.description" class="description text-muted mt-1">
 				{{ __(df.description) }}
 			</div>
@@ -141,7 +141,7 @@
 				@input="$emit('update:modelValue', $event.target.value)"
 				@dragover.prevent
 				@drop="onDrop"
-			></textarea>
+			/>
 			<div v-if="df.description" class="description text-muted mt-1">
 				{{ __(df.description) }}
 			</div>
@@ -151,10 +151,10 @@
 		<FlexiGrid
 			v-else-if="['Table', 'FlexiGrid', 'flexigrid'].includes(df?.fieldtype)"
 			:df="df"
-			:modelValue="modelValue"
+			:model-value="modelValue"
 			:engine="engine"
 			:read_only="df.read_only"
-			@update:modelValue="$emit('update:modelValue', $event)"
+			@update:model-value="$emit('update:modelValue', $event)"
 		/>
 
 		<!-- MultiSelect / MultiCheck / MultiFieldPicker -->
@@ -164,53 +164,66 @@
 					df?.fieldtype
 				)
 			"
-			:displayMode="getMultiListDisplayMode(df)"
+			:display-mode="getMultiListDisplayMode(df)"
 			:columns="df?.fieldtype === 'MultiCheck' ? 2 : undefined"
 			:df="df"
-			:modelValue="modelValue"
+			:model-value="modelValue"
 			:get_data="get_data || df?.get_data"
-			:documentType="
+			:document-type="
 				df?.fieldtype === 'MultiFieldPicker'
 					? df?.target_doctype || engine?.rule_doc?.document_type
 					: undefined
 			"
 			:read_only="df.read_only"
-			:hideLabel="hideLabel"
+			:hide-label="hideLabel"
 			:expanded="df?.fieldtype === 'MultiCheck' ? !hideLabel : undefined"
-			@update:modelValue="$emit('update:modelValue', $event)"
+			@update:model-value="$emit('update:modelValue', $event)"
 		/>
 
+		<!-- Button -->
+		<div v-else-if="df?.fieldtype === 'Button'" class="control fxr-control">
+			<button
+				class="fxr-btn fxr-btn--sm w-100"
+				:class="df.btn_class || 'fxr-btn--secondary'"
+				:disabled="df.read_only"
+				@click="$emit('click', $event)"
+			>
+				<i v-if="df.icon" :class="df.icon" class="me-1" />
+				{{ __(df.label) }}
+			</button>
+		</div>
+
 		<!-- Specialized / High-level controls -->
 		<ResourceMapperControl
 			v-else-if="df?.fieldtype === 'Resource Mapper'"
 			:df="df"
-			:modelValue="modelValue"
-			:targetDoctype="df?.target_doctype || ''"
-			:targetFields="df?.target_fields || []"
-			:sourceOptions="df?.source_options || []"
+			:model-value="modelValue"
+			:target-doctype="df?.target_doctype || ''"
+			:target-fields="df?.target_fields || []"
+			:source-options="df?.source_options || []"
 			:read_only="df?.read_only"
-			:hideLabel="hideLabel"
-			:hideDescription="hideDescription"
-			@update:modelValue="$emit('update:modelValue', $event)"
+			:hide-label="hideLabel"
+			:hide-description="hideDescription"
+			@update:model-value="$emit('update:modelValue', $event)"
 		/>
 
 		<TextGeneratorControl
 			v-else-if="df?.fieldtype === 'Text Generator'"
 			:df="df"
-			:modelValue="modelValue"
+			:model-value="modelValue"
 			:read_only="df?.read_only"
-			:variableOptions="df?.variable_options || injectedVariableOptions"
-			:docFieldOptions="df?.doc_field_options || injectedDocFields"
-			:hideLabel="hideLabel"
-			:hideDescription="hideDescription"
-			@update:modelValue="$emit('update:modelValue', $event)"
+			:variable-options="df?.variable_options || injectedVariableOptions"
+			:doc-field-options="df?.doc_field_options || injectedDocFields"
+			:hide-label="hideLabel"
+			:hide-description="hideDescription"
+			@update:model-value="$emit('update:modelValue', $event)"
 		/>
 
 		<FlexValueControl
 			v-else-if="df?.fieldtype === 'Structured Value'"
-			:modelValue="modelValue"
+			:model-value="modelValue"
 			:read_only="df?.read_only"
-			:variableOptions="df?.variable_options || injectedVariableOptions"
+			:variable-options="df?.variable_options || injectedVariableOptions"
 			:compact="df?.compact || false"
 			:placeholder="df?.placeholder || ''"
 			:disabled="df?.read_only"
@@ -228,27 +241,27 @@
 					df?.target_doctype ||
 					engine?.rule_doc?.document_type,
 			}"
-			@update:modelValue="$emit('update:modelValue', $event)"
+			@update:model-value="$emit('update:modelValue', $event)"
 		/>
 
 		<!-- Attach / Attach Image fallback (using DataControl for now) -->
 		<DataControl
 			v-else-if="['Attach', 'Attach Image'].includes(df?.fieldtype)"
 			:df="df"
-			:modelValue="modelValue"
-			:hideLabel="hideLabel"
-			:hideDescription="hideDescription"
-			@update:modelValue="$emit('update:modelValue', $event)"
+			:model-value="modelValue"
+			:hide-label="hideLabel"
+			:hide-description="hideDescription"
+			@update:model-value="$emit('update:modelValue', $event)"
 		/>
 
 		<!-- Default (Data, Duration, Valid types defaulting to text) -->
 		<DataControl
 			v-else-if="!['Table', 'Signature', 'Button', 'Heading'].includes(df?.fieldtype)"
 			:df="df || { fieldtype: 'Data' }"
-			:modelValue="modelValue"
-			:hideLabel="hideLabel"
-			:hideDescription="hideDescription"
-			@update:modelValue="$emit('update:modelValue', $event)"
+			:model-value="modelValue"
+			:hide-label="hideLabel"
+			:hide-description="hideDescription"
+			@update:model-value="$emit('update:modelValue', $event)"
 		/>
 
 		<!-- Fallback for unsupported/unsafe types -->
@@ -288,7 +301,7 @@ const props = defineProps({
 	get_data: { type: Function, default: null },
 });
 
-const emit = defineEmits(["update:modelValue"]);
+const emit = defineEmits(["update:modelValue", "click"]);
 
 // ── DocField / FieldPicker helpers ────────────────────────────────────────────
 
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/FlexiGrid.vue b/flexirule/public/js/flexirule/rule_builder/controls/FlexiGrid.vue
index 330398a3..bd2e47f4 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/FlexiGrid.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/FlexiGrid.vue
@@ -7,7 +7,7 @@
 		</div>
 
 		<div v-if="df.reqd && !localRows.length" class="text-danger small mb-2">
-			<i class="fa fa-exclamation-circle"></i> {{ __("{0} is mandatory", [df.label]) }}
+			<i class="fa fa-exclamation-circle" /> {{ __("{0} is mandatory", [df.label]) }}
 		</div>
 
 		<div class="grid-container">
@@ -21,7 +21,7 @@
 								:checked="isAllSelected"
 								:indeterminate="isAnySelected && !isAllSelected"
 								@change="toggleAll"
-							/>
+							>
 						</div>
 
 						<div class="header-cell static-col">
@@ -39,11 +39,11 @@
 							<div
 								class="resize-handle"
 								@mousedown="startResize($event, col.fieldname)"
-							></div>
+							/>
 						</div>
 
 						<div v-if="!read_only" class="header-cell static-col">
-							<i class="fa fa-cog text-muted"></i>
+							<i class="fa fa-cog text-muted" />
 						</div>
 					</div>
 				</div>
@@ -56,7 +56,7 @@
 								type="checkbox"
 								:checked="selectedRows.has(row.name)"
 								@change="toggleRow(row.name)"
-							/>
+							>
 						</div>
 
 						<div
@@ -66,7 +66,7 @@
 							<i
 								v-if="isRowInvalid(row)"
 								class="fa fa-exclamation-circle text-danger mr-1"
-							></i>
+							/>
 							{{ rowIndex + 1 }}
 						</div>
 
@@ -86,12 +86,13 @@
 							<ControlFactory
 								v-if="!isCellHidden(row, col.fieldname)"
 								:df="getEffectiveDf(row, col)"
-								:modelValue="row[col.fieldname]"
+								:model-value="row[col.fieldname]"
 								:doc="row"
 								:engine="engine"
-								hideLabel
-								hideDescription
-								@update:modelValue="updateCell(rowIndex, col.fieldname, $event)"
+								hide-label
+								hide-description
+								@update:model-value="updateCell(rowIndex, col.fieldname, $event)"
+								@click="$emit('cell-click', { row, rowIndex, col, fieldname: col.fieldname, event: $event })"
 							/>
 						</div>
 
@@ -102,7 +103,7 @@
 								:disabled="rowIndex === 0"
 								@click="moveRow(rowIndex, -1)"
 							>
-								<i class="fa fa-chevron-up"></i>
+								<i class="fa fa-chevron-up" />
 							</button>
 							<button
 								class="btn btn-xs btn-link text-muted p-0 ml-1"
@@ -110,14 +111,14 @@
 								:disabled="rowIndex === localRows.length - 1"
 								@click="moveRow(rowIndex, 1)"
 							>
-								<i class="fa fa-chevron-down"></i>
+								<i class="fa fa-chevron-down" />
 							</button>
 							<button
 								class="btn btn-xs btn-link text-danger p-0 ml-2"
 								:title="__('Remove Row')"
 								@click="removeRow(rowIndex)"
 							>
-								<i class="fa fa-trash"></i>
+								<i class="fa fa-trash" />
 							</button>
 						</div>
 					</div>
@@ -133,14 +134,14 @@
 		<div v-if="!read_only" class="grid-footer">
 			<div class="footer-actions">
 				<button class="btn btn-xs btn-default" @click="addRow">
-					<i class="fa fa-plus"></i> {{ __("Add Row") }}
+					<i class="fa fa-plus" /> {{ __("Add Row") }}
 				</button>
 				<button
 					v-if="isAnySelected"
 					class="btn btn-xs btn-danger-light ml-2"
 					@click="removeSelectedRows"
 				>
-					<i class="fa fa-trash"></i> {{ __("Delete Selected") }} ({{
+					<i class="fa fa-trash" /> {{ __("Delete Selected") }} ({{
 						selectedRows.size
 					}})
 				</button>
@@ -160,7 +161,7 @@ const props = defineProps({
 	read_only: Boolean,
 });
 
-const emit = defineEmits(["update:modelValue"]);
+const emit = defineEmits(["update:modelValue", "cell-click"]);
 
 const localRows = ref([]);
 const selectedRows = ref(new Set());

From d381f0c83edb295706665e402a960dfc187663f6 Mon Sep 17 00:00:00 2001
From: Abdo Ruzaqi <ruzaqi@gmail.com>
Date: Wed, 27 May 2026 01:19:27 +0300
Subject: [PATCH 4/4] style: fix code formatting and indentation across
 frontend and backend

---
 .../components/ActionFieldProperties.vue      |   2 +-
 .../rule_builder/components/ActionPopover.vue |   4 +-
 .../condition_builder/SimpleCondition.vue     |   6 +-
 .../components/nodes/ConditionNode.vue        |   2 +-
 .../components/nodes/StartNode.vue            |   4 +-
 .../components/nodes/StopNode.vue             |   4 +-
 .../components/rule_config/FilterGroup.vue    |  14 +-
 .../rule_config/RuleConfigModal.vue           |   8 +-
 .../rule_config/types/AssignmentConfig.vue    |   5 +-
 .../rule_config/types/QueryRecordsConfig.vue  |   6 +-
 .../rule_config/types/SubRuleConfig.vue       |   2 +-
 .../composables/useAsyncOptionsSource.js      |   2 +-
 .../composables/useFieldNormalization.js      |  21 +++
 .../rule_builder/composables/useRuleGraph.js  |   4 +-
 .../rule_builder/controls/ComboBoxControl.vue |   3 +-
 .../rule_builder/controls/ControlFactory.vue  |  22 +++-
 .../controls/FlexValueControl.vue             |  12 +-
 .../rule_builder/controls/FlexiGrid.vue       | 124 ++++++++----------
 .../rule_builder/controls/MentionList.vue     |   4 +-
 .../rule_builder/controls/MultiSelectList.vue |   8 +-
 .../controls/ResourceMapperControl.vue        |   2 +-
 .../rule_builder/controls/TextControl.vue     |   4 +-
 .../controls/TextGeneratorControl.vue         |  10 ++
 .../controls/TransformControl.vue             |   8 +-
 .../controls/ValueResolverControl.vue         |   8 +-
 .../rule_builder/stores/useGraphStore.js      |   8 +-
 .../rule_builder/stores/useRuleStore.js       |   8 +-
 flexirule/ruleflow/doctype/rule/rule.py       |   4 +-
 .../ruleflow/process/enrichment/enrichment.js |   4 +-
 29 files changed, 163 insertions(+), 150 deletions(-)

diff --git a/flexirule/public/js/flexirule/rule_builder/components/ActionFieldProperties.vue b/flexirule/public/js/flexirule/rule_builder/components/ActionFieldProperties.vue
index c38e3f88..774826db 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/ActionFieldProperties.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/ActionFieldProperties.vue
@@ -61,7 +61,7 @@ const doc_fields = computed(() => {
 				? getFieldLabel(actionType, df.fieldname, {
 						operation: props.nodeData?.operation,
 						processName: props.nodeData?.process_name,
-					})
+				  })
 				: null;
 			if (resolved.fieldname === "action_type") {
 				resolved = {
diff --git a/flexirule/public/js/flexirule/rule_builder/components/ActionPopover.vue b/flexirule/public/js/flexirule/rule_builder/components/ActionPopover.vue
index a124138f..e0b0f502 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/ActionPopover.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/ActionPopover.vue
@@ -518,9 +518,7 @@ onUnmounted(() => {
 	background: #fff;
 	border: 1px solid var(--border-color, #dfe3e8);
 	border-radius: 8px;
-	box-shadow:
-		0 10px 15px -3px rgba(0, 0, 0, 0.1),
-		0 4px 6px -2px rgba(0, 0, 0, 0.05);
+	box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
 	z-index: 2147483647; /* Maximum possible z-index */
 	display: flex;
 	flex-direction: column;
diff --git a/flexirule/public/js/flexirule/rule_builder/components/condition_builder/SimpleCondition.vue b/flexirule/public/js/flexirule/rule_builder/components/condition_builder/SimpleCondition.vue
index f34cfee8..0a8c07c7 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/condition_builder/SimpleCondition.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/condition_builder/SimpleCondition.vue
@@ -63,7 +63,7 @@ const operators = computed(() => {
 		Array.isArray(fieldOps) && fieldOps.length
 			? fieldOps
 			: config.fieldtype_operators?.[ft] ||
-				config.fieldtype_operators?.["_default"] || ["==", "!=", "is_set", "is_not_set"];
+			  config.fieldtype_operators?.["_default"] || ["==", "!=", "is_set", "is_not_set"];
 	const labels = config.operator_labels || {};
 
 	return validOps.map((op) => ({
@@ -380,9 +380,7 @@ watch(
 	border: 1px solid var(--fxr-border);
 	border-radius: var(--fxr-radius-md);
 	padding: var(--fxr-space-1) var(--fxr-space-2);
-	transition:
-		border-color var(--fxr-transition-fast),
-		background-color var(--fxr-transition-fast);
+	transition: border-color var(--fxr-transition-fast), background-color var(--fxr-transition-fast);
 }
 
 .simple-condition:hover {
diff --git a/flexirule/public/js/flexirule/rule_builder/components/nodes/ConditionNode.vue b/flexirule/public/js/flexirule/rule_builder/components/nodes/ConditionNode.vue
index d00c3e77..c283a6c5 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/nodes/ConditionNode.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/nodes/ConditionNode.vue
@@ -44,7 +44,7 @@ const conditionSummary = computed(() => {
 		const op = first.op;
 		const right = first.right?.ref
 			? first.right.ref.replace("doc.", "")
-			: (first.right?.value ?? "?");
+			: first.right?.value ?? "?";
 		return `${left} ${op} ${right}${count > 1 ? ` (+${count - 1})` : ""}`;
 	}
 	return `${count} ${__("conditions")}`;
diff --git a/flexirule/public/js/flexirule/rule_builder/components/nodes/StartNode.vue b/flexirule/public/js/flexirule/rule_builder/components/nodes/StartNode.vue
index 20b3e3f0..1074c589 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/nodes/StartNode.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/nodes/StartNode.vue
@@ -119,9 +119,7 @@ function openConfig() {
 	align-items: center;
 	padding: 8px 16px 8px 10px;
 	border-radius: 4px 40px 40px 4px; /* Reflected D-Shape */
-	box-shadow:
-		0 2px 4px -1px rgba(0, 0, 0, 0.1),
-		0 1px 2px -1px rgba(0, 0, 0, 0.06);
+	box-shadow: 0 2px 4px -1px rgba(0, 0, 0, 0.1), 0 1px 2px -1px rgba(0, 0, 0, 0.06);
 	transition: all 0.2s ease;
 	border: 1px solid rgba(255, 255, 255, 0.2);
 }
diff --git a/flexirule/public/js/flexirule/rule_builder/components/nodes/StopNode.vue b/flexirule/public/js/flexirule/rule_builder/components/nodes/StopNode.vue
index 16319690..01ca393d 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/nodes/StopNode.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/nodes/StopNode.vue
@@ -104,9 +104,7 @@ function openConfig() {
 }
 
 .stop-node-card.selected {
-	box-shadow:
-		0 0 0 2px #fff,
-		0 0 0 4px #dc3545;
+	box-shadow: 0 0 0 2px #fff, 0 0 0 4px #dc3545;
 }
 
 .stop-node-card.test-executed {
diff --git a/flexirule/public/js/flexirule/rule_builder/components/rule_config/FilterGroup.vue b/flexirule/public/js/flexirule/rule_builder/components/rule_config/FilterGroup.vue
index ada53d1b..c4098ef8 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/rule_config/FilterGroup.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/rule_config/FilterGroup.vue
@@ -225,7 +225,7 @@ const timespanOptions = frappe.ui?.filter_utils?.get_timespan_options
 			"Tomorrow",
 			"This",
 			"Next",
-		])
+	  ])
 	: [
 			{ label: __("Last 7 Days"), value: "last 7 days" },
 			{ label: __("Last 14 Days"), value: "last 14 days" },
@@ -251,7 +251,7 @@ const timespanOptions = frappe.ui?.filter_utils?.get_timespan_options
 			{ label: __("Next Quarter"), value: "next quarter" },
 			{ label: __("Next 6 Months"), value: "next 6 months" },
 			{ label: __("Next Year"), value: "next year" },
-		];
+	  ];
 
 const BASE_QUERY_OPERATORS = [
 	"=",
@@ -886,7 +886,7 @@ const updateBetweenValue = (idx, arrayIndex, val) => {
 		: [
 				{ mode: "static", value: "" },
 				{ mode: "static", value: "" },
-			];
+		  ];
 	list[arrayIndex] = val;
 	merged.value = list;
 	filters.value[idx] = merged;
@@ -936,9 +936,7 @@ onMounted(async () => {
 	border: 1px solid var(--fxr-border);
 	border-radius: var(--fxr-radius-lg);
 	padding: var(--fxr-space-4) var(--fxr-space-5);
-	transition:
-		border-color var(--fxr-transition-fast),
-		box-shadow var(--fxr-transition-fast);
+	transition: border-color var(--fxr-transition-fast), box-shadow var(--fxr-transition-fast);
 }
 
 .filter-row:hover {
@@ -1173,9 +1171,7 @@ onMounted(async () => {
 	font-size: var(--fxr-input-font-size) !important;
 	border: 1px solid var(--fxr-border) !important;
 	border-radius: var(--fxr-radius-md) !important;
-	transition:
-		border-color var(--fxr-transition-fast),
-		box-shadow var(--fxr-transition-fast) !important;
+	transition: border-color var(--fxr-transition-fast), box-shadow var(--fxr-transition-fast) !important;
 }
 
 .filter-row-main :deep(.fxr-control),
diff --git a/flexirule/public/js/flexirule/rule_builder/components/rule_config/RuleConfigModal.vue b/flexirule/public/js/flexirule/rule_builder/components/rule_config/RuleConfigModal.vue
index 3b150b6b..65dd8fe0 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/rule_config/RuleConfigModal.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/rule_config/RuleConfigModal.vue
@@ -370,10 +370,10 @@
 																		collapseInputPanel
 																			? __(
 																					'Expand Input Panel'
-																				)
+																			  )
 																			: __(
 																					'Collapse Input Panel'
-																				)
+																			  )
 																	"
 																>
 																	<i
@@ -1523,9 +1523,7 @@ onUnmounted(() => {
 .fxr-overflow-dropdown {
 	background: #fff;
 	border-radius: 12px;
-	box-shadow:
-		0 10px 25px -5px rgba(0, 0, 0, 0.1),
-		0 8px 10px -6px rgba(0, 0, 0, 0.1);
+	box-shadow: 0 10px 25px -5px rgba(0, 0, 0, 0.1), 0 8px 10px -6px rgba(0, 0, 0, 0.1);
 	border: 1px solid #e2e8f0;
 	overflow: hidden;
 	animation: dropdown-slide 0.2s cubic-bezier(0, 0, 0.2, 1);
diff --git a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/AssignmentConfig.vue b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/AssignmentConfig.vue
index e19f87ae..285f7b83 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/AssignmentConfig.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/AssignmentConfig.vue
@@ -177,7 +177,9 @@ const assignmentEngine = reactive({
 			const hasCond = hasWhenCondition(row);
 			normalized.label = hasCond ? __("Condition Set") : __("Always Run");
 			normalized.icon = hasCond ? "fa fa-filter" : "fa fa-play-circle-o";
-			normalized.btn_class = hasCond ? "when-toggle-btn is-active" : "when-toggle-btn is-default";
+			normalized.btn_class = hasCond
+				? "when-toggle-btn is-active"
+				: "when-toggle-btn is-default";
 		}
 
 		if (df.fieldname === "operator") {
@@ -441,7 +443,6 @@ function syncToNode() {
 	store.mark_dirty();
 }
 
-
 function onTargetChange(index, value) {
 	const assignment = assignments.value[index];
 	assignment.target = value;
diff --git a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/QueryRecordsConfig.vue b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/QueryRecordsConfig.vue
index 4ab17e90..50864997 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/QueryRecordsConfig.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/QueryRecordsConfig.vue
@@ -1004,7 +1004,7 @@ function load_local_config(val) {
 					field: parts[0],
 					direction: (parts[1] || "asc").toLowerCase(),
 				};
-			})
+		  })
 		: [];
 	const current_order_by_rows = order_by_rows.value.map((r) => ({
 		field: r.field,
@@ -1165,9 +1165,7 @@ defineExpose({
 	font-size: var(--fxr-input-font-size) !important;
 	border: 1px solid var(--fxr-border) !important;
 	border-radius: var(--fxr-radius-md) !important;
-	transition:
-		border-color var(--fxr-transition-fast),
-		box-shadow var(--fxr-transition-fast) !important;
+	transition: border-color var(--fxr-transition-fast), box-shadow var(--fxr-transition-fast) !important;
 }
 
 :deep(.form-control:focus) {
diff --git a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/SubRuleConfig.vue b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/SubRuleConfig.vue
index ab427b8b..fd0d7d90 100644
--- a/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/SubRuleConfig.vue
+++ b/flexirule/public/js/flexirule/rule_builder/components/rule_config/types/SubRuleConfig.vue
@@ -239,7 +239,7 @@ function load_local_config() {
 		? mappings.map((m) => ({
 				source: m.source || m.source_expression || "",
 				target: m.target || "",
-			}))
+		  }))
 		: [];
 }
 
diff --git a/flexirule/public/js/flexirule/rule_builder/composables/useAsyncOptionsSource.js b/flexirule/public/js/flexirule/rule_builder/composables/useAsyncOptionsSource.js
index 4f08bfa8..a80c3ee5 100644
--- a/flexirule/public/js/flexirule/rule_builder/composables/useAsyncOptionsSource.js
+++ b/flexirule/public/js/flexirule/rule_builder/composables/useAsyncOptionsSource.js
@@ -40,7 +40,7 @@ export function useAsyncOptionsSource(fetcher, config = {}) {
 							start: nextPage * pageSize,
 							page: nextPage,
 							pageSize,
-						})
+					  })
 					: []) || [];
 
 			if (token !== requestId) return options.value;
diff --git a/flexirule/public/js/flexirule/rule_builder/composables/useFieldNormalization.js b/flexirule/public/js/flexirule/rule_builder/composables/useFieldNormalization.js
index c67bffa6..82d62d59 100644
--- a/flexirule/public/js/flexirule/rule_builder/composables/useFieldNormalization.js
+++ b/flexirule/public/js/flexirule/rule_builder/composables/useFieldNormalization.js
@@ -7,6 +7,17 @@ import { computed } from "vue";
  */
 export function useFieldNormalization(engine) {
 	function getFieldState(field, contextId = "root") {
+		if (engine && typeof engine.getFieldState === "function") {
+			return (
+				engine.getFieldState(field, contextId) || {
+					reqd: field.reqd,
+					read_only: field.read_only,
+					hidden: field.hidden,
+					options: field.options,
+				}
+			);
+		}
+
 		if (!engine)
 			return {
 				reqd: field.reqd,
@@ -26,6 +37,16 @@ export function useFieldNormalization(engine) {
 	}
 
 	function getNormalizedDf(field, contextId = "root", globalReadOnly = false) {
+		if (engine && typeof engine.getNormalizedDf === "function") {
+			const customDf = engine.getNormalizedDf(field, contextId);
+			if (customDf) {
+				return {
+					...customDf,
+					read_only: customDf.read_only || globalReadOnly,
+				};
+			}
+		}
+
 		const state = getFieldState(field, contextId);
 		return {
 			...field,
diff --git a/flexirule/public/js/flexirule/rule_builder/composables/useRuleGraph.js b/flexirule/public/js/flexirule/rule_builder/composables/useRuleGraph.js
index 49d31bc9..78e16334 100644
--- a/flexirule/public/js/flexirule/rule_builder/composables/useRuleGraph.js
+++ b/flexirule/public/js/flexirule/rule_builder/composables/useRuleGraph.js
@@ -209,8 +209,8 @@ export function useRuleGraph() {
 						? "bottom"
 						: "left" // Side exit for return path (on the left to avoid After Last branch)
 					: isHorizontal
-						? "right"
-						: "bottom", // Standard flow exit
+					? "right"
+					: "bottom", // Standard flow exit
 				targetPosition: isHorizontal ? "left" : "top",
 			};
 		});
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/ComboBoxControl.vue b/flexirule/public/js/flexirule/rule_builder/controls/ComboBoxControl.vue
index 6f975ac1..a7b055f5 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/ComboBoxControl.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/ComboBoxControl.vue
@@ -833,8 +833,7 @@ onBeforeUnmount(() => {
 /* Dropdown Animation */
 .dropdown-fade-enter-active,
 .dropdown-fade-leave-active {
-	transition:
-		opacity 0.2s cubic-bezier(0.4, 0, 0.2, 1),
+	transition: opacity 0.2s cubic-bezier(0.4, 0, 0.2, 1),
 		transform 0.2s cubic-bezier(0.4, 0, 0.2, 1);
 }
 
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/ControlFactory.vue b/flexirule/public/js/flexirule/rule_builder/controls/ControlFactory.vue
index 361c464c..43873d49 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/ControlFactory.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/ControlFactory.vue
@@ -70,7 +70,7 @@
 				@input="$emit('update:modelValue', $event.target.value)"
 				@blur="evaluateMath($event, df.fieldtype)"
 				@keydown.enter="evaluateMath($event, df.fieldtype)"
-			>
+			/>
 			<div v-if="df.description" class="description text-muted mt-1">
 				{{ __(df.description) }}
 			</div>
@@ -103,7 +103,7 @@
 				:disabled="df.read_only"
 				:aria-label="__(df.label)"
 				@input="$emit('update:modelValue', $event.target.value)"
-			>
+			/>
 			<div v-if="df.description" class="description text-muted mt-1">
 				{{ __(df.description) }}
 			</div>
@@ -212,8 +212,8 @@
 			:df="df"
 			:model-value="modelValue"
 			:read_only="df?.read_only"
-			:variable-options="df?.variable_options || injectedVariableOptions"
-			:doc-field-options="df?.doc_field_options || injectedDocFields"
+			:variable-options="variableOptions"
+			:doc-field-options="docFields"
 			:hide-label="hideLabel"
 			:hide-description="hideDescription"
 			@update:model-value="$emit('update:modelValue', $event)"
@@ -223,7 +223,7 @@
 			v-else-if="df?.fieldtype === 'Structured Value'"
 			:model-value="modelValue"
 			:read_only="df?.read_only"
-			:variable-options="df?.variable_options || injectedVariableOptions"
+			:variable-options="variableOptions"
 			:compact="df?.compact || false"
 			:placeholder="df?.placeholder || ''"
 			:disabled="df?.read_only"
@@ -301,6 +301,18 @@ const props = defineProps({
 	get_data: { type: Function, default: null },
 });
 
+const variableOptions = computed(() => {
+	const opt = props.df?.variable_options;
+	if (opt !== undefined && opt !== null) return opt;
+	return injectedVariableOptions?.value || [];
+});
+
+const docFields = computed(() => {
+	const opt = props.df?.doc_field_options;
+	if (opt !== undefined && opt !== null) return opt;
+	return injectedDocFields?.value || [];
+});
+
 const emit = defineEmits(["update:modelValue", "click"]);
 
 // ── DocField / FieldPicker helpers ────────────────────────────────────────────
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/FlexValueControl.vue b/flexirule/public/js/flexirule/rule_builder/controls/FlexValueControl.vue
index 9d5bbb45..2d969672 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/FlexValueControl.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/FlexValueControl.vue
@@ -802,6 +802,16 @@ const editor = new Editor({
 	},
 });
 
+watch(
+	() => [isReadOnly.value, props.disabled],
+	([readOnlyVal, disabledVal]) => {
+		if (editor) {
+			editor.setEditable(!readOnlyVal && !disabledVal);
+		}
+	},
+	{ immediate: true }
+);
+
 const isEditorEmpty = computed(() => editor.isEmpty);
 
 // ── Serialization ──
@@ -1060,7 +1070,7 @@ function handleBuilderUpdate(config) {
 					fieldType: fieldType.value,
 					referenceDoctype: referenceDoctype.value,
 					context: props.context,
-				})
+			  })
 			: props.context?.resolverDefaults;
 	const mergedConfig =
 		defaults && typeof defaults === "object" ? { ...defaults, ...config } : config;
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/FlexiGrid.vue b/flexirule/public/js/flexirule/rule_builder/controls/FlexiGrid.vue
index bd2e47f4..fb45de3e 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/FlexiGrid.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/FlexiGrid.vue
@@ -21,7 +21,7 @@
 								:checked="isAllSelected"
 								:indeterminate="isAnySelected && !isAllSelected"
 								@change="toggleAll"
-							>
+							/>
 						</div>
 
 						<div class="header-cell static-col">
@@ -56,7 +56,7 @@
 								type="checkbox"
 								:checked="selectedRows.has(row.name)"
 								@change="toggleRow(row.name)"
-							>
+							/>
 						</div>
 
 						<div
@@ -92,7 +92,15 @@
 								hide-label
 								hide-description
 								@update:model-value="updateCell(rowIndex, col.fieldname, $event)"
-								@click="$emit('cell-click', { row, rowIndex, col, fieldname: col.fieldname, event: $event })"
+								@click="
+									$emit('cell-click', {
+										row,
+										rowIndex,
+										col,
+										fieldname: col.fieldname,
+										event: $event,
+									})
+								"
 							/>
 						</div>
 
@@ -141,9 +149,7 @@
 					class="btn btn-xs btn-danger-light ml-2"
 					@click="removeSelectedRows"
 				>
-					<i class="fa fa-trash" /> {{ __("Delete Selected") }} ({{
-						selectedRows.size
-					}})
+					<i class="fa fa-trash" /> {{ __("Delete Selected") }} ({{ selectedRows.size }})
 				</button>
 			</div>
 		</div>
@@ -193,7 +199,9 @@ const gridTemplateColumns = computed(() => {
 });
 
 function getColumnWidth(fieldname) {
-	return columnWidths[fieldname] || "180px";
+	if (columnWidths[fieldname]) return columnWidths[fieldname];
+	const col = columns.value.find((c) => c.fieldname === fieldname);
+	return col?.width || "180px";
 }
 
 /* ---------------- Sticky ---------------- */
@@ -390,11 +398,12 @@ function isValueEmpty(val) {
 /* ---------- Container ---------- */
 
 .flexi-grid .grid-container {
-	border: 1px solid var(--border-color, #d1d8dd);
+	border: 1px solid var(--border-color, #e2e8f0);
 	border-radius: 8px;
 	background: #fff;
 	overflow-x: auto;
 	position: relative;
+	box-shadow: 0 1px 2px rgba(0, 0, 0, 0.03);
 }
 
 /* ---------- Table ---------- */
@@ -411,26 +420,29 @@ function isValueEmpty(val) {
 	position: sticky;
 	top: 0;
 	z-index: 100;
-	background: #f8f9fa;
-	border-bottom: 1px solid var(--border-color, #e5e7eb);
+	background: var(--fxr-bg-page, #f8fafc);
+	border-bottom: 1px solid var(--border-color, #e2e8f0);
 }
 
 .flexi-grid .header-row {
-	display: flex;
+	display: grid;
+	grid-template-columns: var(--grid-cols);
 	height: 40px;
 }
 
 /* ---------- Rows ---------- */
 
 .flexi-grid .grid-row {
-	display: flex;
+	display: grid;
+	grid-template-columns: var(--grid-cols);
 	height: 40px;
-	border-bottom: 1px solid var(--border-color, #f0f0f0);
+	border-bottom: 1px solid var(--border-color, #f1f5f9);
 	background: #fff;
+	transition: background 0.15s ease;
 }
 
 .flexi-grid .grid-row:hover {
-	background: #fafafb;
+	background: #f8fafc;
 }
 
 .flexi-grid .grid-row:last-child {
@@ -443,13 +455,18 @@ function isValueEmpty(val) {
 .flexi-grid .grid-cell {
 	flex: 0 0 auto !important; /* NEVER grow or shrink */
 	box-sizing: border-box;
-	border-right: 1px solid var(--border-color, #f0f0f0);
+	border-right: 1px solid var(--border-color, #f1f5f9);
 	display: flex;
 	align-items: center;
 	height: 100%;
-	padding: 0 8px; /* Frappe-style padding */
+	padding: 0 12px; /* Enhanced padding */
 	position: relative;
-	overflow: hidden;
+	min-width: 0; /* Prevent grid blowout */
+	overflow: visible;
+}
+
+.flexi-grid .header-cell {
+	overflow: hidden; /* Keep text truncation for headers */
 }
 
 .flexi-grid .header-cell:last-child,
@@ -461,8 +478,11 @@ function isValueEmpty(val) {
 
 .flexi-grid .header-cell {
 	font-weight: 600;
-	color: var(--text-color);
-	background: #f8f9fa;
+	color: var(--text-muted, #64748b);
+	background: var(--fxr-bg-page, #f8fafc);
+	font-size: 11.5px;
+	text-transform: uppercase;
+	letter-spacing: 0.4px;
 	z-index: 50;
 }
 
@@ -478,7 +498,7 @@ function isValueEmpty(val) {
 .flexi-grid .static-col {
 	justify-content: center;
 	padding: 0;
-	background: #fafafa;
+	background: var(--fxr-bg-muted, #f8fafc);
 }
 
 /* ---------- Sticky Columns ---------- */
@@ -516,6 +536,7 @@ function isValueEmpty(val) {
 
 .flexi-grid .grid-cell .control-factory,
 .flexi-grid .grid-cell .frappe-control,
+.flexi-grid .grid-cell .fxr-control,
 .flexi-grid .grid-cell .form-group {
 	margin: 0 !important;
 	padding: 0 !important;
@@ -523,7 +544,9 @@ function isValueEmpty(val) {
 }
 
 /* Inputs must NOT fill height */
-.flexi-grid .grid-cell .form-control {
+.flexi-grid .grid-cell .form-control,
+.flexi-grid .grid-cell .fxr-select,
+.flexi-grid .grid-cell .fxr-input {
 	height: 28px !important; /* Frappe default */
 	min-height: 28px !important;
 	padding: 4px 8px !important;
@@ -536,9 +559,11 @@ function isValueEmpty(val) {
 }
 
 /* Focus behavior */
-.flexi-grid .grid-cell .form-control:focus {
+.flexi-grid .grid-cell .form-control:focus,
+.flexi-grid .grid-cell .fxr-select:focus,
+.flexi-grid .grid-cell .fxr-input:focus {
 	background: #fff !important;
-	border-color: var(--fxr-accent) !important;
+	border-color: var(--fxr-accent, #2490ef) !important;
 	box-shadow: none !important;
 }
 
@@ -552,25 +577,29 @@ function isValueEmpty(val) {
 
 .flexi-grid .grid-cell .combobox-wrapper:hover,
 .flexi-grid .grid-cell .combobox-wrapper.is-focused {
-	border-color: var(--fxr-accent) !important;
+	border-color: var(--fxr-accent, #2490ef) !important;
 	background: #fff !important;
 }
 
 .flexi-grid .grid-cell .combobox-input-group {
 	height: 100% !important;
+	padding: 0 4px !important;
 }
 
 .flexi-grid .grid-cell .combobox-input {
 	height: 100% !important;
+	padding: 0 4px !important;
 }
 
 /* Selects */
-.flexi-grid .grid-cell select.form-control {
+.flexi-grid .grid-cell select.form-control,
+.flexi-grid .grid-cell select.fxr-select {
 	padding-right: 24px !important;
 }
 
 /* Textarea stays controlled */
-.flexi-grid .grid-cell textarea.form-control {
+.flexi-grid .grid-cell textarea.form-control,
+.flexi-grid .grid-cell textarea.fxr-input {
 	height: 28px !important;
 	resize: none;
 }
@@ -692,47 +721,4 @@ function isValueEmpty(val) {
 .flexi-grid .grid-container::-webkit-scrollbar-thumb:hover {
 	background: #d1d5db;
 }
-.flexi-grid .header-row,
-.flexi-grid .grid-row {
-	display: grid;
-	grid-template-columns: var(--grid-cols);
-}
-
-.header-cell,
-.grid-cell {
-	height: 40px;
-	display: flex;
-	align-items: center;
-	padding: 0 8px;
-	border-right: 1px solid #e5e7eb;
-	box-sizing: border-box;
-}
-
-.header-cell {
-	font-weight: 600;
-	background: #f8f9fa;
-}
-
-.grid-row:hover {
-	background: #fafafb;
-}
-
-.static-col {
-	justify-content: center;
-}
-
-.sticky-col {
-	position: sticky;
-	z-index: 20;
-	background: inherit;
-}
-
-.resize-handle {
-	position: absolute;
-	right: -3px;
-	top: 0;
-	bottom: 0;
-	width: 6px;
-	cursor: col-resize;
-}
 </style>
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/MentionList.vue b/flexirule/public/js/flexirule/rule_builder/controls/MentionList.vue
index 8f521227..d55f72ef 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/MentionList.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/MentionList.vue
@@ -139,9 +139,7 @@ export default {
 	background: #fff;
 	border: 1px solid #e2e8f0;
 	border-radius: 12px;
-	box-shadow:
-		0 10px 15px -3px rgba(0, 0, 0, 0.1),
-		0 4px 6px -2px rgba(0, 0, 0, 0.05);
+	box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
 	padding: 4px;
 	min-width: 220px;
 	overflow: hidden;
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/MultiSelectList.vue b/flexirule/public/js/flexirule/rule_builder/controls/MultiSelectList.vue
index 1228b235..b2dfdb33 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/MultiSelectList.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/MultiSelectList.vue
@@ -742,9 +742,7 @@ onBeforeUnmount(() => {
 	align-items: center;
 	gap: 8px;
 	cursor: pointer;
-	transition:
-		border-color 0.15s ease,
-		box-shadow 0.15s ease;
+	transition: border-color 0.15s ease, box-shadow 0.15s ease;
 }
 
 .multi-select-trigger.invalid {
@@ -1049,9 +1047,7 @@ onBeforeUnmount(() => {
 
 .dropdown-fade-enter-active,
 .dropdown-fade-leave-active {
-	transition:
-		opacity 0.2s ease,
-		transform 0.2s ease;
+	transition: opacity 0.2s ease, transform 0.2s ease;
 }
 
 .dropdown-fade-enter-from,
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/ResourceMapperControl.vue b/flexirule/public/js/flexirule/rule_builder/controls/ResourceMapperControl.vue
index 31b57a73..f2a9115d 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/ResourceMapperControl.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/ResourceMapperControl.vue
@@ -746,7 +746,7 @@ function normalizeModel(val) {
 						mappings: Array.isArray(table?.mappings)
 							? table.mappings.map((m) => ({ ...m, _id: m._id || generateId() }))
 							: [],
-					}))
+				  }))
 				: [],
 		};
 	}
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/TextControl.vue b/flexirule/public/js/flexirule/rule_builder/controls/TextControl.vue
index 457b6c6c..2a719e0d 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/TextControl.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/TextControl.vue
@@ -64,9 +64,7 @@ textarea.form-control {
 	padding: var(--fxr-input-padding-y) var(--fxr-input-padding-x);
 	border: 1px solid var(--fxr-border);
 	border-radius: var(--fxr-radius-md);
-	transition:
-		border-color var(--fxr-transition-fast),
-		box-shadow var(--fxr-transition-fast);
+	transition: border-color var(--fxr-transition-fast), box-shadow var(--fxr-transition-fast);
 }
 
 textarea.form-control:focus {
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/TextGeneratorControl.vue b/flexirule/public/js/flexirule/rule_builder/controls/TextGeneratorControl.vue
index ae5c3ca7..41d3bc2e 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/TextGeneratorControl.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/TextGeneratorControl.vue
@@ -573,6 +573,16 @@ const editor = new Editor({
 	},
 });
 
+watch(
+	() => readOnly.value,
+	(readOnlyVal) => {
+		if (editor) {
+			editor.setEditable(!readOnlyVal);
+		}
+	},
+	{ immediate: true }
+);
+
 function createSuggestionRenderer() {
 	let component;
 	let popup;
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/TransformControl.vue b/flexirule/public/js/flexirule/rule_builder/controls/TransformControl.vue
index 74352889..fc851daa 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/TransformControl.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/TransformControl.vue
@@ -209,9 +209,7 @@ watch(
 	border-radius: 12px;
 	position: relative;
 	overflow: hidden;
-	box-shadow:
-		0 4px 6px -1px rgba(0, 0, 0, 0.1),
-		0 2px 4px -1px rgba(0, 0, 0, 0.06);
+	box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);
 }
 
 .transform-header {
@@ -283,9 +281,7 @@ watch(
 	stroke-width: 2.5;
 	pointer-events: stroke;
 	cursor: pointer;
-	transition:
-		stroke 0.2s,
-		stroke-width 0.2s;
+	transition: stroke 0.2s, stroke-width 0.2s;
 }
 
 .mapping-line:hover,
diff --git a/flexirule/public/js/flexirule/rule_builder/controls/ValueResolverControl.vue b/flexirule/public/js/flexirule/rule_builder/controls/ValueResolverControl.vue
index 00e94b07..b70292c4 100644
--- a/flexirule/public/js/flexirule/rule_builder/controls/ValueResolverControl.vue
+++ b/flexirule/public/js/flexirule/rule_builder/controls/ValueResolverControl.vue
@@ -491,8 +491,8 @@
 									v-for="opt in localState.fmt_op === 'fmt_money'
 										? numericFieldOptions
 										: localState.fmt_op === 'format_date'
-											? dateFieldOptions
-											: stringFieldOptions"
+										? dateFieldOptions
+										: stringFieldOptions"
 									:key="opt.value"
 									:value="opt.value"
 								>
@@ -505,8 +505,8 @@
 								localState.fmt_op === "fmt_money"
 									? __("Currency (Field or Code)")
 									: localState.fmt_op === "format_date"
-										? __("Date Format (e.g. YYYY-MM-DD)")
-										: __("Template")
+									? __("Date Format (e.g. YYYY-MM-DD)")
+									: __("Template")
 							}}</label>
 							<input
 								type="text"
diff --git a/flexirule/public/js/flexirule/rule_builder/stores/useGraphStore.js b/flexirule/public/js/flexirule/rule_builder/stores/useGraphStore.js
index ce5086c0..5f9bde06 100644
--- a/flexirule/public/js/flexirule/rule_builder/stores/useGraphStore.js
+++ b/flexirule/public/js/flexirule/rule_builder/stores/useGraphStore.js
@@ -1046,8 +1046,8 @@ export const useGraphStore = defineStore("rule-builder-graph", () => {
 				source.field_b_type === "constant"
 					? String(source.constant_b ?? 0)
 					: source.field_b
-						? `frappe.utils.flt(${toDocExpression(source.field_b)})`
-						: "0";
+					? `frappe.utils.flt(${toDocExpression(source.field_b)})`
+					: "0";
 			const op = source.math_op || "+";
 			const precision = Number.isFinite(Number(source.precision))
 				? Number(source.precision)
@@ -1380,14 +1380,14 @@ export const useGraphStore = defineStore("rule-builder-graph", () => {
 							actionType: "Process",
 							processName: action.process_name,
 							operation: action.operation,
-						}) || {}
+					  }) || {}
 					: rawConfigData;
 			const conditionPayload =
 				actionTypeRaw === "Condition"
 					? getConditionPayload({
 							config: configData,
 							condition_json: action.condition_json,
-						})
+					  })
 					: null;
 			const effectiveConfig =
 				actionTypeRaw === "Condition"
diff --git a/flexirule/public/js/flexirule/rule_builder/stores/useRuleStore.js b/flexirule/public/js/flexirule/rule_builder/stores/useRuleStore.js
index 6d25e142..b83d86d1 100644
--- a/flexirule/public/js/flexirule/rule_builder/stores/useRuleStore.js
+++ b/flexirule/public/js/flexirule/rule_builder/stores/useRuleStore.js
@@ -312,7 +312,7 @@ export const useRuleStore = defineStore("rule-builder-rule", () => {
 						? getConditionPayload({
 								config: node.data?.config,
 								condition_json: node.data?.condition_json,
-							})
+						  })
 						: null;
 
 				const finalInputMapping =
@@ -678,7 +678,7 @@ export const useRuleStore = defineStore("rule-builder-rule", () => {
 						istable: doctype_meta.istable,
 						is_submittable: doctype_meta.is_submittable,
 						track_changes: doctype_meta.track_changes,
-					}
+				  }
 				: null,
 		});
 	}
@@ -723,8 +723,8 @@ export const useRuleStore = defineStore("rule-builder-rule", () => {
 		let breadcrumbs = `
 			<li><a href="/app/rule">${__("Rule")}</a></li>
 			<li><a href="/app/rule/${rule_name.value}">${__(
-				rule_doc.value?.rule_name || rule_name.value
-			)}</a></li>
+			rule_doc.value?.rule_name || rule_name.value
+		)}</a></li>
 			<li class="disabled"><a href="#">${__("Builder")}</a></li>
 		`;
 		frappe.breadcrumbs.clear();
diff --git a/flexirule/ruleflow/doctype/rule/rule.py b/flexirule/ruleflow/doctype/rule/rule.py
index 0fb4786a..6b710a9e 100644
--- a/flexirule/ruleflow/doctype/rule/rule.py
+++ b/flexirule/ruleflow/doctype/rule/rule.py
@@ -1657,7 +1657,9 @@ def _check_template_variables(self, action, available_vars):
 				assignments = []
 			for i, a in enumerate(assignments or []):
 				tpl = (a.get("value_template") or a.get("value")) if isinstance(a, dict) else None
-				if tpl:
+				if isinstance(tpl, dict):
+					tpl = tpl.get("value")
+				if tpl and isinstance(tpl, str):
 					templates_to_check.append((f"assignment[{i}].value_template", tpl))
 		elif action.action_type == "Stop" and getattr(action, "operation", None) == "Error":
 			templates_to_check.append(("value_template", getattr(action, "value_template", "")))
diff --git a/flexirule/ruleflow/process/enrichment/enrichment.js b/flexirule/ruleflow/process/enrichment/enrichment.js
index 2bb73a65..e767087d 100644
--- a/flexirule/ruleflow/process/enrichment/enrichment.js
+++ b/flexirule/ruleflow/process/enrichment/enrichment.js
@@ -172,8 +172,8 @@ flexirule.processes["Enrichment"] = {
 				const fields = Array.isArray(config.field_list)
 					? config.field_list
 					: typeof config.field_list === "string"
-						? config.field_list.split("\n").filter((f) => f.trim())
-						: [];
+					? config.field_list.split("\n").filter((f) => f.trim())
+					: [];
 
 				return fields.map((field) => {
 					return {