upgrade appium version for mobile, add page summary JSON for mobile which we will use later in LLM solutions

Author: angelovstanton

README_Research_Foundation_Notice.md

@@ -1,15 +1,17 @@
-## Research Foundation Notice
+## 🔬 Research Foundation Notice
 
 This repository is part of an academic research project on **AI-powered autonomous test automation agents**, integrating Large Language Models (LLMs), Semantic Kernel, and Retrieval-Augmented Generation (RAG).
 
 - The core architecture, prompt engineering, and agent logic are original contributions by [Anton Angelov](https://www.linkedin.com/in/angelovstanton/).
 - This work serves as the foundation for a PhD dissertation at the Technical University of Sofia.
 - The system demonstrates AI agent-based planning, execution, healing, and diagnostics in automated testing.
+- The AI agent logic, planning structure, prompt strategies, and memory integration were designed by the author.
+- Implementation of auxiliary components (e.g., PR automation, UI fixes) may involve contributions from collaborators under the author’s supervision. All core design and research aspects remain attributable to the author.
 
 **If you reuse or reference this project in academic, research, or commercial contexts, please provide appropriate attribution.**
 
 ---
 
-## License
+## 📄 License
 
 Licensed under the [Apache 2.0 License](http://www.apache.org/licenses/LICENSE-2.0).

src/Bellatrix.Api/LogWorkflowPlugin.cs

@@ -17,6 +17,7 @@ public class LogWorkflowPlugin : Plugin
 {
     protected override void PreTestInit(object sender, PluginEventArgs e)
     {
+        Logger.CurrentTestFullName.Value = e.TestFullName;
         Logger.LogInformation($"Start Test {e.TestClassType.Name}.{e.TestMethodMemberInfo.Name}");
     }
 }

src/Bellatrix.Desktop/llm/extensions/AppServiceExtensions.cs

@@ -0,0 +1,40 @@
+using Bellatrix.Desktop.Services;
+using HtmlAgilityPack;
+using Newtonsoft.Json;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace Bellatrix.Desktop;
+
+public static class AppServiceExtensions
+{
+    public static string GetPageSummaryJson(this AppService app)
+    {
+        var sourceXml = app.WrappedDriver.PageSource;
+
+        var doc = new HtmlDocument();
+        doc.LoadHtml(sourceXml);
+
+        var nodes = doc.DocumentNode.SelectNodes("//*");
+        if (nodes == null || nodes.Count == 0)
+        {
+            return "[]";
+        }
+
+        List<DesktopElementSummary> elements = nodes
+            .Select(node => new DesktopElementSummary
+            {
+                Tag = node.Name,
+                AutomationId = node.GetAttributeValue("AutomationId", null),
+                Name = node.GetAttributeValue("Name", null),
+                ClassName = node.GetAttributeValue("ClassName", null),
+                ControlType = node.GetAttributeValue("ControlType", null),
+                Value = node.GetAttributeValue("Value.Value", null),
+                HelpText = node.GetAttributeValue("HelpText", null)
+            })
+            .Where(x => !string.IsNullOrWhiteSpace(x.Name) || !string.IsNullOrWhiteSpace(x.AutomationId))
+            .ToList();
+
+        return JsonConvert.SerializeObject(elements, Formatting.None);
+    }
+}

src/Bellatrix.Desktop/llm/extensions/DesktopElementSummary.cs

@@ -0,0 +1,29 @@
+// <copyright file="DesktopElementSummary.cs" company="Automate The Planet Ltd.">
+// Copyright 2025 Automate The Planet Ltd.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// You may not use this file except in compliance with the License.
+// You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// </copyright>
+// <author>Anton Angelov</author>
+// <site>https://bellatrix.solutions/</site>
+// <note>This file is part of an academic research project exploring autonomous test agents using LLMs and Semantic Kernel.
+// The architecture and agent logic are original contributions by Anton Angelov, forming the foundation for a PhD dissertation.
+// Please cite or credit appropriately if reusing in academic or commercial work.</note>
+
+namespace Bellatrix.Desktop;
+public class DesktopElementSummary
+{
+    public string Tag { get; set; }
+    public string AutomationId { get; set; }
+    public string Name { get; set; }
+    public string ClassName { get; set; }
+    public string ControlType { get; set; }
+    public string Value { get; set; }
+    public string HelpText { get; set; }
+    public bool Enabled { get; set; }
+}

src/Bellatrix.Desktop/plugins/LogLifecyclePlugin.cs

@@ -20,6 +20,7 @@ public class LogLifecyclePlugin : Plugin
 {
     protected override void PreTestInit(object sender, PluginEventArgs e)
     {
+        Logger.CurrentTestFullName.Value = e.TestFullName;
         Logger.LogInformation($"Start Test {e.TestClassType.Name}.{e.TestMethodMemberInfo.Name}");
     }
 }

src/Bellatrix.Mobile/Bellatrix.Mobile.csproj

@@ -5,7 +5,7 @@
 	</PropertyGroup>
 
 	<ItemGroup>
-    <PackageReference Include="Appium.WebDriver" Version="5.0.0-rc.5" />
+    <PackageReference Include="Appium.WebDriver" Version="7.2.0" />
     <PackageReference Include="Microsoft.CSharp" Version="4.7.0" />
     <PackageReference Include="MSTest" Version="3.2.2" />
     <PackageReference Include="NUnit" Version="4.3.2" />

src/Bellatrix.Mobile/findstrategies/iOS/FindIOSUIAutomationStrategy.cs

@@ -25,22 +25,22 @@ public FindIOSUIAutomationStrategy(string name)
 
     public override AppiumElement FindElement(IOSDriver searchContext)
     {
-        return searchContext.FindElement(MobileBy.IosUIAutomation(Value));
+        return searchContext.FindElement(MobileBy.IosNSPredicate(Value));
     }
 
     public override IEnumerable<AppiumElement> FindAllElements(IOSDriver searchContext)
     {
-        return searchContext.FindElements(MobileBy.IosUIAutomation(Value));
+        return searchContext.FindElements(MobileBy.IosNSPredicate(Value));
     }
 
     public override AppiumElement FindElement(AppiumElement element)
     {
-        return element.FindElement(MobileBy.IosUIAutomation(Value));
+        return element.FindElement(MobileBy.IosNSPredicate(Value));
     }
 
     public override IEnumerable<AppiumElement> FindAllElements(AppiumElement element)
     {
-        return element.FindElements(MobileBy.IosUIAutomation(Value));
+        return element.FindElements(MobileBy.IosNSPredicate(Value));
     }
 
     public override string ToString()

src/Bellatrix.Mobile/llm/extensions/AppServiceExtensions.cs

@@ -0,0 +1,54 @@
+// <copyright file="AppServiceExtensions.cs" company="Automate The Planet Ltd.">
+// Copyright 2025 Automate The Planet Ltd.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// You may not use this file except in compliance with the License.
+// You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// </copyright>
+// <author>Anton Angelov</author>
+// <site>https://bellatrix.solutions/</site>
+// <note>This file is part of an academic research project exploring autonomous test agents using LLMs and Semantic Kernel.
+// The architecture and agent logic are original contributions by Anton Angelov, forming the foundation for a PhD dissertation.
+// Please cite or credit appropriately if reusing in academic or commercial work.</note>
+using Bellatrix.Mobile.Services;
+using HtmlAgilityPack;
+using Newtonsoft.Json;
+using System.Linq;
+
+namespace Bellatrix.Mobile;
+
+public static class AppServiceExtensions
+{
+    public static string GetPageSummaryJson<TDriver, TComponent>(this AppService<TDriver, TComponent> app)
+        where TDriver : AppiumDriver
+        where TComponent : AppiumElement
+    {
+        var xml = app.PageSource;
+        var doc = new HtmlDocument();
+        doc.LoadHtml(xml);
+
+        var nodes = doc.DocumentNode.SelectNodes("//*");
+        if (nodes == null || nodes.Count == 0)
+        {
+            return "[]";
+        }
+
+        var summary = nodes.Select(node => new MobileElementSummary
+        {
+            Tag = node.Name,
+            Id = node.GetAttributeValue("resource-id", node.GetAttributeValue("name", null)),
+            Text = node.GetAttributeValue("text", null),
+            Class = node.GetAttributeValue("class", null),
+            ContentDesc = node.GetAttributeValue("content-desc", node.GetAttributeValue("label", null)),
+            Type = node.GetAttributeValue("type", null)
+        })
+        .Where(e => !string.IsNullOrEmpty(e.Id) || !string.IsNullOrEmpty(e.Text) || !string.IsNullOrEmpty(e.ContentDesc))
+        .ToList();
+
+        return JsonConvert.SerializeObject(summary, Formatting.None);
+    }
+}

src/Bellatrix.Mobile/llm/extensions/MobileElementSummary.cs

@@ -0,0 +1,27 @@
+// <copyright file="MobileElementSummary.cs" company="Automate The Planet Ltd.">
+// Copyright 2025 Automate The Planet Ltd.
+// Licensed under the Apache License, Version 2.0 (the "License");
+// You may not use this file except in compliance with the License.
+// You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// </copyright>
+// <author>Anton Angelov</author>
+// <site>https://bellatrix.solutions/</site>
+// <note>This file is part of an academic research project exploring autonomous test agents using LLMs and Semantic Kernel.
+// The architecture and agent logic are original contributions by Anton Angelov, forming the foundation for a PhD dissertation.
+// Please cite or credit appropriately if reusing in academic or commercial work.</note>
+namespace Bellatrix.Mobile;
+
+public class MobileElementSummary
+{
+    public string Tag { get; set; }
+    public string Id { get; set; } // resource-id (Android) or name (iOS)
+    public string Text { get; set; }
+    public string Class { get; set; }
+    public string ContentDesc { get; set; } // Android: content-desc, iOS: label
+    public string Type { get; set; } // iOS only
+}

src/Bellatrix.Mobile/plugins/LogWorkflowPlugin.cs

@@ -20,6 +20,7 @@ public class LogWorkflowPlugin : Plugin
 {
     protected override void PreTestInit(object sender, PluginEventArgs e)
     {
+        Logger.CurrentTestFullName.Value = e.TestFullName;
         Logger.LogInformation($"Start Test {e.TestClassType.Name}.{e.TestMethodMemberInfo.Name}");
     }
 }