feat: add txc data model convert command (#7)

- Rename DataVisualizer → DataModelConverter, move into TALXIS.CLI.Data project
- Command: txc data model convert --input --target --output
- Smart input resolution: project folder (.csproj/.cdsproj + SolutionRootPath), declarations folder, or .zip
- Fix bug: Relationships dir may not exist → add Directory.Exists() guard
- Fix bug: TableRow.ParseXElement returns null for unknown/missing <Type>
- Fix bug: SQLTranslator optionset lookup used RowType name instead of OptionSetName
- Fix DBML output: column types now reference enum names for dbdiagram.io linking
- Fix MCP SDK v1.x breaking change: IMcpClient removed → use McpClient directly
- Add integration tests: TempWorkspaceFixture + 8 DataModelConvertTests
- Bring in master-only files: ProjectCliCommand, ConfigCliCommand, updated ComponentParameterListCliCommand
- Remove SolutionCliCommand from Workspace (moved to Data as DataModelConvertCliCommand)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: TomProkop

src/TALXIS.CLI.Data/DataModelCliCommand.cs

@@ -4,7 +4,8 @@ namespace TALXIS.CLI.Data;
 
 [CliCommand(
     Name = "model",
-    Description = "Data modeling utilities"
+    Description = "Data modeling utilities",
+    Children = new[] { typeof(DataModelConvertCliCommand) }
 )]
 public class DataModelCliCommand
 {

src/TALXIS.CLI.Data/DataModelConvertCliCommand.cs

@@ -0,0 +1,88 @@
+using DotMake.CommandLine;
+using TALXIS.CLI.Data.DataModelConverter;
+
+namespace TALXIS.CLI.Data;
+
+[CliCommand(
+    Name = "convert",
+    Description = "Convert a Power Platform solution data model to various formats such as DBML, SQL, EDMX or Ribbon"
+)]
+public class DataModelConvertCliCommand
+{
+    private const string ExportsFolderName = "exports";
+
+    [CliOption(
+        Name = "--input",
+        Description = "Path to the input: a solution project folder (.cdsproj/.csproj with SolutionRootPath), a declarations folder, or a .zip solution file. Defaults to the current directory.",
+        Required = false
+    )]
+    public string? InputPath { get; set; }
+
+    [CliOption(
+        Name = "--target",
+        Description = "Target format for the conversion.",
+        AllowedValues = new[] { "dbml", "sql", "plainsql", "edmx", "ribbon" },
+        Required = true
+    )]
+    public string? TargetFormat { get; set; }
+
+    [CliOption(
+        Name = "--output",
+        Description = $"Directory to write the output file into. Defaults to the '{ExportsFolderName}/' folder in the current directory (auto-created and gitignored).",
+        Required = false
+    )]
+    public string? OutputDirectory { get; set; }
+
+    public int Run()
+    {
+        var inputPath = InputPath ?? Directory.GetCurrentDirectory();
+        var outputDir = OutputDirectory ?? Path.Combine(Directory.GetCurrentDirectory(), ExportsFolderName);
+
+        Directory.CreateDirectory(outputDir);
+        EnsureGitIgnored(outputDir);
+
+        var extension = TargetFormat!.ToLower() == "plainsql" ? "sql" : TargetFormat.ToLower();
+        var outputFilePath = Path.Combine(outputDir, $"solution.{extension}");
+
+        DataModelConverterService.ConvertModel(inputPath, TargetFormat!, outputFilePath);
+
+        Console.WriteLine($"Output written to: {outputFilePath}");
+        return 0;
+    }
+
+    /// <summary>
+    /// Ensures the exports folder is listed in the nearest .gitignore,
+    /// adding an entry if it is not already present.
+    /// </summary>
+    private static void EnsureGitIgnored(string exportsDirPath)
+    {
+        var gitIgnorePath = FindGitIgnore(exportsDirPath);
+        if (gitIgnorePath == null)
+            return;
+
+        var entry = $"{ExportsFolderName}/";
+        var lines = File.ReadAllLines(gitIgnorePath);
+        if (lines.Any(l => l.Trim() == entry))
+            return;
+
+        File.AppendAllText(gitIgnorePath, $"{Environment.NewLine}{entry}{Environment.NewLine}");
+    }
+
+    private static string? FindGitIgnore(string startPath)
+    {
+        var dir = new DirectoryInfo(startPath);
+        while (dir != null)
+        {
+            var candidate = Path.Combine(dir.FullName, ".gitignore");
+            if (File.Exists(candidate))
+                return candidate;
+
+            // Stop at the git root
+            if (Directory.Exists(Path.Combine(dir.FullName, ".git")))
+                break;
+
+            dir = dir.Parent;
+        }
+        return null;
+    }
+}

src/TALXIS.CLI.Data/DataModelConverter/DataModelConverterService.cs

@@ -0,0 +1,40 @@
+using System;
+using System.Collections.Generic;
+using System.Globalization;
+using System.Linq;
+using System.Text;
+
+namespace TALXIS.CLI.Data.DataModelConverter.Extensions;
+
+public static class StringExtension
+{
+    public static string FirstCharToUpper(this string input) => input switch
+    {
+        null => throw new ArgumentNullException(nameof(input)),
+        "" => throw new ArgumentException($"{nameof(input)} cannot be empty", nameof(input)),
+        _ => string.Concat(input.First().ToString().ToUpper(), input.AsSpan(1))
+    };
+
+    /// <summary>
+    /// Remove diacritics, pascal case, remove spaces and replace "-" with "_"
+    /// </summary>
+    /// <param name="text"></param>
+    /// <returns></returns>
+    public static string NormalizeString(this string text)
+    {
+        var normalizedString = text.Normalize(NormalizationForm.FormD);
+        var stringBuilder = new StringBuilder();
+
+        foreach (var c in normalizedString)
+        {
+            var unicodeCategory = CharUnicodeInfo.GetUnicodeCategory(c);
+            if (unicodeCategory != UnicodeCategory.NonSpacingMark)
+            {
+                stringBuilder.Append(c);
+            }
+        }
+
+        return CultureInfo.CurrentCulture.TextInfo.ToTitleCase(stringBuilder.ToString().Normalize(NormalizationForm.FormC)).Replace(" ", "").Replace("-", "_");
+
+    }
+}

src/TALXIS.CLI.Data/DataModelConverter/Extensions/StringExtension.cs

@@ -0,0 +1,27 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using TALXIS.CLI.Data.DataModelConverter.Model;
+
+namespace TALXIS.CLI.Data.DataModelConverter.Extensions;
+
+public static class TableExtension
+{
+    public static Table Find(this List<Table> list, string logicalName)
+    {
+        return list.FirstOrDefault(x => x.LogicalName.Equals(logicalName, StringComparison.InvariantCultureIgnoreCase));
+    }
+
+    public static Table CreateTable(string tableName, TableType type)
+    {
+        return new Table
+        {
+            Type = type,
+            LocalizedName = tableName,
+            LogicalName = tableName,
+            SetName = tableName + "s",
+            Rows = { new TableRow(tableName + "id", RowType.Primarykey) }
+        };
+    }
+}
+

src/TALXIS.CLI.Data/DataModelConverter/Extensions/TableExtension.cs

@@ -0,0 +1,27 @@
+using System.Collections.Generic;
+
+namespace TALXIS.CLI.Data.DataModelConverter.Model;
+
+public class DataverseToSqlTypeMapper
+{
+    private readonly Dictionary<string, string> translationTable = new Dictionary<string, string>()
+    {
+        { "nvarchar", "varchar" },
+        { "lookup", "uniqueidentifier" },
+        { "primarykey", "uniqueidentifier [primary key]"},
+        { "partylist", "varchar"},
+        { "file", "varchar" },
+        { "customer", "uniqueidentifier" },
+        { "ntext", "varchar" }
+    };
+
+    public string this[string key]
+    {
+        get
+        {
+            if (translationTable.ContainsKey(key)) return translationTable[key];
+            return key;
+        }
+    }
+
+}

src/TALXIS.CLI.Data/DataModelConverter/Model/DataverseToSqlTypeMapper.cs

@@ -0,0 +1,39 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using System.Xml.Linq;
+
+namespace TALXIS.CLI.Data.DataModelConverter.Model;
+
+public class Module
+{
+    public Module()
+    {
+        var random = new Random();
+        Colorhex = string.Format("#{0:X6}", random.Next(0x1000000));
+    }
+
+    public Module(string module, XDocument xml)
+    {
+        ModuleName = module;
+        XmlDoc = xml;
+
+        var random = new Random();
+        Colorhex = string.Format("#{0:X6}", random.Next(0x1000000));
+
+        entities = XmlDoc.Descendants().Where(x => x.Name == "Entity").ToList();
+        relationships = XmlDoc.Descendants().Where(x => x.Name == "EntityRelationship").ToList();
+        optionsets = XmlDoc.Descendants().Where(x => x.Name == "optionset").ToList();
+    }
+
+    public string ModuleName { get; set; } = "";
+    public XDocument XmlDoc { get; set; } = new XDocument();
+
+    public List<XElement> entities = [];
+    public List<XElement> relationships = [];
+    public List<XElement> optionsets = [];
+
+    public string Colorhex { get; }
+}

src/TALXIS.CLI.Data/DataModelConverter/Model/Module.cs

@@ -0,0 +1,47 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace TALXIS.CLI.Data.DataModelConverter.Model;
+
+public class OptionsetEnum
+{
+    public string LocalizedName { get; set; }
+
+    public List<OptionsetRow> Values = [];
+
+    public OptionsetEnum(string localizedName, List<OptionsetRow> values)
+    {
+        LocalizedName = localizedName;
+        Values = values;
+    }
+
+    public void Add(string label, int value)
+    {
+        Values.Add(new OptionsetRow(label, value));
+    }
+
+    public void MergeOptions(List<OptionsetRow> options)
+    {
+        foreach (var newoption in options)
+        {
+            OptionsetRow optionsetRow = Values.FirstOrDefault(x => x.Value == newoption.Value);
+            if (optionsetRow == default)
+            {
+                Values.Add(newoption);
+            }
+            else
+            {
+                if (optionsetRow.Label != newoption.Label) optionsetRow.Label = $"{newoption.Label}";
+            }
+        }
+    }
+
+    public override string ToString()
+    {
+        return LocalizedName;
+    }
+
+}

src/TALXIS.CLI.Data/DataModelConverter/Model/OptionsetEnum.cs

@@ -0,0 +1,19 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace TALXIS.CLI.Data.DataModelConverter.Model;
+
+public class OptionsetRow
+{
+    public OptionsetRow(string label, int value)
+    {
+        Label = label;
+        Value = value;
+    }
+
+    public string Label { get; set; }
+    public int Value { get; set; }
+
+
+}

src/TALXIS.CLI.Data/DataModelConverter/Model/OptionsetRow.cs

@@ -0,0 +1,13 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace TALXIS.CLI.Data.DataModelConverter.Model;
+
+public class ParsedModel
+{
+    public List<Table> tables = [];
+    public List<Relationship> relationships = [];
+    public List<OptionsetEnum> optionSets = [];
+
+}