@nguyenphp/antigravity-marketing 1.0.18 → 1.0.19

package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/EditContentCommand.cs

@@ -0,0 +1,487 @@
+using System.CommandLine;
+using System.Text.RegularExpressions;
+using DocumentFormat.OpenXml;
+using DocumentFormat.OpenXml.Packaging;
+using DocumentFormat.OpenXml.Wordprocessing;
+using MiniMaxAIDocx.Core.OpenXml;
+
+namespace MiniMaxAIDocx.Core.Commands;
+
+/// <summary>
+/// Scenario B: Surgical content editing operations on existing DOCX files.
+/// Preserves all existing formatting and minimizes XML changes.
+/// </summary>
+public static class EditContentCommand
+{
+    public static Command Create()
+    {
+        var cmd = new Command("edit", "Edit existing DOCX content");
+
+        cmd.Add(CreateReplaceTextCommand());
+        cmd.Add(CreateFillTableCommand());
+        cmd.Add(CreateInsertParagraphCommand());
+        cmd.Add(CreateUpdateFieldCommand());
+        cmd.Add(CreateListPlaceholdersCommand());
+        cmd.Add(CreateFillPlaceholdersCommand());
+
+        return cmd;
+    }
+
+    private static Command CreateReplaceTextCommand()
+    {
+        var inputOpt = new Option<string>("--input") { Description = "Input DOCX file", Required = true };
+        var outputOpt = new Option<string>("--output") { Description = "Output file path (defaults to overwriting input)" };
+        var searchOpt = new Option<string>("--search") { Description = "Text to search for", Required = true };
+        var replaceOpt = new Option<string>("--replace") { Description = "Replacement text", Required = true };
+        var regexOpt = new Option<bool>("--regex") { Description = "Treat search as a regex pattern" };
+
+        var cmd = new Command("replace-text", "Replace text while preserving formatting")
+        {
+            inputOpt, outputOpt, searchOpt, replaceOpt, regexOpt
+        };
+
+        cmd.SetAction((parseResult) =>
+        {
+            var input = parseResult.GetValue(inputOpt)!;
+            var output = parseResult.GetValue(outputOpt) ?? input;
+            var search = parseResult.GetValue(searchOpt)!;
+            var replace = parseResult.GetValue(replaceOpt)!;
+            var useRegex = parseResult.GetValue(regexOpt);
+
+            if (output != input) File.Copy(input, output, overwrite: true);
+
+            using var doc = WordprocessingDocument.Open(output, true);
+            var body = doc.MainDocumentPart?.Document.Body;
+            if (body == null) { Console.Error.WriteLine("No document body found."); return; }
+
+            int count = 0;
+            foreach (var paragraph in body.Descendants<Paragraph>())
+            {
+                count += ReplaceInParagraph(paragraph, search, replace, useRegex);
+            }
+
+            doc.MainDocumentPart!.Document.Save();
+            Console.WriteLine($"Replaced {count} occurrence(s) in {output}");
+        });
+
+        return cmd;
+    }
+
+    private static Command CreateFillTableCommand()
+    {
+        var inputOpt = new Option<string>("--input") { Description = "Input DOCX file", Required = true };
+        var outputOpt = new Option<string>("--output") { Description = "Output file path" };
+        var tableIndexOpt = new Option<int>("--table-index") { Description = "Zero-based index of the table to fill" };
+        tableIndexOpt.DefaultValueFactory = _ => 0;
+        var csvOpt = new Option<string>("--csv") { Description = "CSV file with data to fill", Required = true };
+        var appendOpt = new Option<bool>("--append") { Description = "Append rows instead of replacing existing data rows" };
+
+        var cmd = new Command("fill-table", "Fill a table with data from CSV")
+        {
+            inputOpt, outputOpt, tableIndexOpt, csvOpt, appendOpt
+        };
+
+        cmd.SetAction((parseResult) =>
+        {
+            var input = parseResult.GetValue(inputOpt)!;
+            var output = parseResult.GetValue(outputOpt) ?? input;
+            var tableIndex = parseResult.GetValue(tableIndexOpt);
+            var csvPath = parseResult.GetValue(csvOpt)!;
+            var append = parseResult.GetValue(appendOpt);
+
+            if (output != input) File.Copy(input, output, overwrite: true);
+
+            if (!File.Exists(csvPath)) { Console.Error.WriteLine($"CSV file not found: {csvPath}"); return; }
+
+            using var doc = WordprocessingDocument.Open(output, true);
+            var body = doc.MainDocumentPart?.Document.Body;
+            if (body == null) { Console.Error.WriteLine("No document body found."); return; }
+
+            var tables = body.Elements<Table>().ToList();
+            if (tableIndex >= tables.Count)
+            {
+                Console.Error.WriteLine($"Table index {tableIndex} out of range (found {tables.Count} tables).");
+                return;
+            }
+
+            var table = tables[tableIndex];
+            var csvLines = File.ReadAllLines(csvPath);
+            if (csvLines.Length == 0) { Console.WriteLine("CSV is empty, nothing to fill."); return; }
+
+            // Get template row properties from the first data row (second row, after header)
+            var existingRows = table.Elements<TableRow>().ToList();
+            TableRow? templateRow = existingRows.Count > 1 ? existingRows[1] : existingRows.FirstOrDefault();
+            var templateTrPr = templateRow?.TableRowProperties?.CloneNode(true) as TableRowProperties;
+
+            if (!append)
+            {
+                // Remove all rows except the header row
+                for (int i = existingRows.Count - 1; i >= 1; i--)
+                    existingRows[i].Remove();
+            }
+
+            int rowsAdded = 0;
+            // Skip header line in CSV (index 0)
+            for (int i = 1; i < csvLines.Length; i++)
+            {
+                var values = ParseCsvLine(csvLines[i]);
+                var newRow = new TableRow();
+                if (templateTrPr != null)
+                    newRow.Append(templateTrPr.CloneNode(true));
+
+                foreach (var val in values)
+                {
+                    var cell = new TableCell(
+                        new Paragraph(new Run(new Text(val))));
+                    newRow.Append(cell);
+                }
+
+                table.Append(newRow);
+                rowsAdded++;
+            }
+
+            doc.MainDocumentPart!.Document.Save();
+            Console.WriteLine($"Added {rowsAdded} rows to table {tableIndex} in {output}");
+        });
+
+        return cmd;
+    }
+
+    private static Command CreateInsertParagraphCommand()
+    {
+        var inputOpt = new Option<string>("--input") { Description = "Input DOCX file", Required = true };
+        var outputOpt = new Option<string>("--output") { Description = "Output file path" };
+        var textOpt = new Option<string>("--text") { Description = "Paragraph text", Required = true };
+        var styleOpt = new Option<string>("--style") { Description = "Paragraph style (e.g. Heading1, Normal)" };
+        var afterOpt = new Option<int>("--after-paragraph") { Description = "Insert after this paragraph index (0-based)" };
+        afterOpt.DefaultValueFactory = _ => -1; // -1 = append at end
+
+        var cmd = new Command("insert-paragraph", "Insert a new paragraph")
+        {
+            inputOpt, outputOpt, textOpt, styleOpt, afterOpt
+        };
+
+        cmd.SetAction((parseResult) =>
+        {
+            var input = parseResult.GetValue(inputOpt)!;
+            var output = parseResult.GetValue(outputOpt) ?? input;
+            var text = parseResult.GetValue(textOpt)!;
+            var style = parseResult.GetValue(styleOpt);
+            var afterIndex = parseResult.GetValue(afterOpt);
+
+            if (output != input) File.Copy(input, output, overwrite: true);
+
+            using var doc = WordprocessingDocument.Open(output, true);
+            var body = doc.MainDocumentPart?.Document.Body;
+            if (body == null) { Console.Error.WriteLine("No document body found."); return; }
+
+            var newPara = new Paragraph();
+            if (!string.IsNullOrEmpty(style))
+                newPara.Append(new ParagraphProperties(new ParagraphStyleId { Val = style }));
+            newPara.Append(new Run(new Text(text)));
+
+            var paragraphs = body.Elements<Paragraph>().ToList();
+            if (afterIndex >= 0 && afterIndex < paragraphs.Count)
+            {
+                paragraphs[afterIndex].InsertAfterSelf(newPara);
+            }
+            else
+            {
+                // Insert before sectPr if present, otherwise append
+                var sectPr = body.Elements<SectionProperties>().FirstOrDefault();
+                if (sectPr != null)
+                    sectPr.InsertBeforeSelf(newPara);
+                else
+                    body.Append(newPara);
+            }
+
+            doc.MainDocumentPart!.Document.Save();
+            Console.WriteLine($"Inserted paragraph in {output}");
+        });
+
+        return cmd;
+    }
+
+    private static Command CreateUpdateFieldCommand()
+    {
+        var inputOpt = new Option<string>("--input") { Description = "Input DOCX file", Required = true };
+        var outputOpt = new Option<string>("--output") { Description = "Output file path" };
+        var fieldNameOpt = new Option<string>("--field") { Description = "Document property field name (e.g. TITLE, AUTHOR)", Required = true };
+        var valueOpt = new Option<string>("--value") { Description = "New field value", Required = true };
+
+        var cmd = new Command("update-field", "Update a document property field value")
+        {
+            inputOpt, outputOpt, fieldNameOpt, valueOpt
+        };
+
+        cmd.SetAction((parseResult) =>
+        {
+            var input = parseResult.GetValue(inputOpt)!;
+            var output = parseResult.GetValue(outputOpt) ?? input;
+            var fieldName = parseResult.GetValue(fieldNameOpt)!;
+            var value = parseResult.GetValue(valueOpt)!;
+
+            if (output != input) File.Copy(input, output, overwrite: true);
+
+            using var doc = WordprocessingDocument.Open(output, true);
+
+            // Update core properties
+            var props = doc.PackageProperties;
+            switch (fieldName.ToUpperInvariant())
+            {
+                case "TITLE": props.Title = value; break;
+                case "AUTHOR": props.Creator = value; break;
+                case "SUBJECT": props.Subject = value; break;
+                case "KEYWORDS": props.Keywords = value; break;
+                case "DESCRIPTION": props.Description = value; break;
+                case "CATEGORY": props.Category = value; break;
+                default:
+                    Console.Error.WriteLine($"Unknown field: {fieldName}. Supported: TITLE, AUTHOR, SUBJECT, KEYWORDS, DESCRIPTION, CATEGORY");
+                    return;
+            }
+
+            Console.WriteLine($"Updated {fieldName} to \"{value}\" in {output}");
+        });
+
+        return cmd;
+    }
+
+    private static Command CreateListPlaceholdersCommand()
+    {
+        var inputOpt = new Option<string>("--input") { Description = "Input DOCX file", Required = true };
+        var patternOpt = new Option<string>("--pattern") { Description = "Placeholder pattern (regex)" };
+        patternOpt.DefaultValueFactory = _ => @"\{\{(\w+)\}\}"; // {{PLACEHOLDER}}
+
+        var cmd = new Command("list-placeholders", "List all placeholders found in the document")
+        {
+            inputOpt, patternOpt
+        };
+
+        cmd.SetAction((parseResult) =>
+        {
+            var input = parseResult.GetValue(inputOpt)!;
+            var pattern = parseResult.GetValue(patternOpt)!;
+
+            using var doc = WordprocessingDocument.Open(input, false);
+            var body = doc.MainDocumentPart?.Document.Body;
+            if (body == null) { Console.Error.WriteLine("No document body found."); return; }
+
+            var placeholders = new HashSet<string>();
+            var regex = new Regex(pattern);
+
+            foreach (var paragraph in body.Descendants<Paragraph>())
+            {
+                var fullText = string.Concat(paragraph.Descendants<Text>().Select(t => t.Text));
+                foreach (Match match in regex.Matches(fullText))
+                {
+                    placeholders.Add(match.Value);
+                }
+            }
+
+            if (placeholders.Count == 0)
+            {
+                Console.WriteLine("No placeholders found.");
+                return;
+            }
+
+            Console.WriteLine($"Found {placeholders.Count} unique placeholder(s):");
+            foreach (var p in placeholders.OrderBy(x => x))
+                Console.WriteLine($"  {p}");
+        });
+
+        return cmd;
+    }
+
+    private static Command CreateFillPlaceholdersCommand()
+    {
+        var inputOpt = new Option<string>("--input") { Description = "Input DOCX file", Required = true };
+        var outputOpt = new Option<string>("--output") { Description = "Output file path" };
+        var mappingOpt = new Option<string>("--mapping") { Description = "JSON file mapping placeholder names to values", Required = true };
+        var patternOpt = new Option<string>("--pattern") { Description = "Placeholder pattern with capture group for the name" };
+        patternOpt.DefaultValueFactory = _ => @"\{\{(\w+)\}\}";
+
+        var cmd = new Command("fill-placeholders", "Replace placeholders with values from a mapping file")
+        {
+            inputOpt, outputOpt, mappingOpt, patternOpt
+        };
+
+        cmd.SetAction((parseResult) =>
+        {
+            var input = parseResult.GetValue(inputOpt)!;
+            var output = parseResult.GetValue(outputOpt) ?? input;
+            var mappingPath = parseResult.GetValue(mappingOpt)!;
+            var pattern = parseResult.GetValue(patternOpt)!;
+
+            if (!File.Exists(mappingPath)) { Console.Error.WriteLine($"Mapping file not found: {mappingPath}"); return; }
+
+            var mappingJson = File.ReadAllText(mappingPath);
+            Dictionary<string, string> mapping;
+            try
+            {
+                mapping = System.Text.Json.JsonSerializer.Deserialize<Dictionary<string, string>>(mappingJson) ?? [];
+            }
+            catch (System.Text.Json.JsonException ex)
+            {
+                Console.Error.WriteLine($"Invalid mapping JSON: {ex.Message}");
+                return;
+            }
+
+            if (output != input) File.Copy(input, output, overwrite: true);
+
+            using var doc = WordprocessingDocument.Open(output, true);
+            var body = doc.MainDocumentPart?.Document.Body;
+            if (body == null) { Console.Error.WriteLine("No document body found."); return; }
+
+            int totalReplacements = 0;
+            var regex = new Regex(pattern);
+
+            foreach (var paragraph in body.Descendants<Paragraph>())
+            {
+                var fullText = string.Concat(paragraph.Descendants<Text>().Select(t => t.Text));
+                var matches = regex.Matches(fullText);
+                if (matches.Count == 0) continue;
+
+                foreach (Match match in matches)
+                {
+                    var placeholderName = match.Groups.Count > 1 ? match.Groups[1].Value : match.Value;
+                    if (mapping.TryGetValue(placeholderName, out var replacement))
+                    {
+                        totalReplacements += ReplaceInParagraph(paragraph, match.Value, replacement, false);
+                    }
+                }
+            }
+
+            doc.MainDocumentPart!.Document.Save();
+            Console.WriteLine($"Filled {totalReplacements} placeholder(s) in {output}");
+        });
+
+        return cmd;
+    }
+
+    /// <summary>
+    /// Replaces text within a paragraph while preserving run formatting.
+    /// Handles the case where search text may span multiple runs.
+    /// </summary>
+    private static int ReplaceInParagraph(Paragraph paragraph, string search, string replace, bool useRegex)
+    {
+        var runs = paragraph.Elements<Run>().ToList();
+        if (runs.Count == 0) return 0;
+
+        // Build the full paragraph text and a map from character index to (run, position within run)
+        var fullText = string.Concat(runs.SelectMany(r => r.Elements<Text>().Select(t => t.Text)));
+        if (string.IsNullOrEmpty(fullText)) return 0;
+
+        int count = 0;
+
+        if (!useRegex)
+        {
+            // Simple case: search within each run first
+            foreach (var run in runs)
+            {
+                foreach (var textElement in run.Elements<Text>().ToList())
+                {
+                    if (textElement.Text.Contains(search))
+                    {
+                        var newText = textElement.Text.Replace(search, replace);
+                        count += (textElement.Text.Length - newText.Length + replace.Length - search.Length) == 0 ? 0 :
+                                 CountOccurrences(textElement.Text, search);
+                        textElement.Text = newText;
+                        if (newText.StartsWith(' ') || newText.EndsWith(' '))
+                            textElement.Space = SpaceProcessingModeValues.Preserve;
+                    }
+                }
+            }
+
+            // Handle cross-run matches by concatenating all runs, replacing, and rebuilding
+            if (count == 0 && fullText.Contains(search))
+            {
+                var newFullText = fullText.Replace(search, replace);
+                count = CountOccurrences(fullText, search);
+                RebuildRunsWithText(paragraph, runs, newFullText);
+            }
+        }
+        else
+        {
+            var regex = new Regex(search);
+            if (regex.IsMatch(fullText))
+            {
+                count = regex.Matches(fullText).Count;
+                var newFullText = regex.Replace(fullText, replace);
+                RebuildRunsWithText(paragraph, runs, newFullText);
+            }
+        }
+
+        return count;
+    }
+
+    /// <summary>
+    /// Replaces the text content of existing runs with new text,
+    /// preserving the formatting of the first run.
+    /// </summary>
+    private static void RebuildRunsWithText(Paragraph paragraph, List<Run> runs, string newText)
+    {
+        if (runs.Count == 0) return;
+
+        // Keep the first run's formatting, set its text to the full new text
+        var firstRun = runs[0];
+        var firstText = firstRun.Elements<Text>().FirstOrDefault();
+        if (firstText != null)
+        {
+            firstText.Text = newText;
+            if (newText.StartsWith(' ') || newText.EndsWith(' '))
+                firstText.Space = SpaceProcessingModeValues.Preserve;
+        }
+
+        // Remove all other runs
+        for (int i = 1; i < runs.Count; i++)
+            runs[i].Remove();
+    }
+
+    private static int CountOccurrences(string text, string search)
+    {
+        int count = 0;
+        int index = 0;
+        while ((index = text.IndexOf(search, index, StringComparison.Ordinal)) != -1)
+        {
+            count++;
+            index += search.Length;
+        }
+        return count;
+    }
+
+    private static string[] ParseCsvLine(string line)
+    {
+        // Simple CSV parser (handles quoted fields)
+        var result = new List<string>();
+        bool inQuotes = false;
+        var current = new System.Text.StringBuilder();
+
+        for (int i = 0; i < line.Length; i++)
+        {
+            char c = line[i];
+            if (c == '"')
+            {
+                if (inQuotes && i + 1 < line.Length && line[i + 1] == '"')
+                {
+                    current.Append('"');
+                    i++;
+                }
+                else
+                {
+                    inQuotes = !inQuotes;
+                }
+            }
+            else if (c == ',' && !inQuotes)
+            {
+                result.Add(current.ToString());
+                current.Clear();
+            }
+            else
+            {
+                current.Append(c);
+            }
+        }
+        result.Add(current.ToString());
+        return result.ToArray();
+    }
+}

package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Core/Commands/FixOrderCommand.cs

@@ -0,0 +1,108 @@
+using System.CommandLine;
+using System.IO.Compression;
+using System.Xml.Linq;
+
+namespace MiniMaxAIDocx.Core.Commands;
+
+public static class FixOrderCommand
+{
+    private static readonly XNamespace W = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
+
+    // Canonical element ordering within common parent elements per ISO 29500
+    private static readonly Dictionary<string, List<string>> ElementOrder = new()
+    {
+        ["pPr"] = new() { "pStyle", "keepNext", "keepLines", "pageBreakBefore", "widowControl", "numPr", "suppressLineNumbers", "pBdr", "shd", "tabs", "suppressAutoHyphens", "spacing", "ind", "jc", "outlineLvl", "rPr" },
+        ["rPr"] = new() { "rStyle", "rFonts", "b", "bCs", "i", "iCs", "caps", "smallCaps", "strike", "dstrike", "vanish", "color", "spacing", "w", "kern", "position", "sz", "szCs", "highlight", "u", "effect", "vertAlign", "lang" },
+        ["tblPr"] = new() { "tblStyle", "tblpPr", "tblOverlap", "tblW", "jc", "tblInd", "tblBorders", "shd", "tblLayout", "tblCellMar", "tblLook" },
+        ["tcPr"] = new() { "cnfStyle", "tcW", "gridSpan", "hMerge", "vMerge", "tcBorders", "shd", "noWrap", "tcMar", "textDirection", "tcFitText", "vAlign" },
+        ["sectPr"] = new() { "headerReference", "footerReference", "footnotePr", "endnotePr", "type", "pgSz", "pgMar", "paperSrc", "pgBorders", "lnNumType", "pgNumType", "cols", "docGrid" },
+    };
+
+    public static Command Create()
+    {
+        var inputOption = new Option<string>("--input") { Description = "DOCX file to fix", Required = true };
+        var outputOption = new Option<string>("--output") { Description = "Output path (default: overwrite input)" };
+        var backupOption = new Option<bool>("--backup") { Description = "Create .bak before modifying", DefaultValueFactory = (_) => true };
+
+        var cmd = new Command("fix-order", "Fix OpenXML element ordering per ISO 29500")
+        {
+            inputOption, outputOption, backupOption
+        };
+
+        cmd.SetAction((parseResult) =>
+        {
+            var input = parseResult.GetValue(inputOption)!;
+            var output = parseResult.GetValue(outputOption) ?? input;
+            var backup = parseResult.GetValue(backupOption);
+
+            if (!File.Exists(input))
+            {
+                Console.Error.WriteLine($"File not found: {input}");
+                return;
+            }
+
+            if (backup && output == input)
+                File.Copy(input, input + ".bak", true);
+
+            var tempPath = Path.GetTempFileName();
+            File.Copy(input, tempPath, true);
+
+            using var zip = ZipFile.Open(tempPath, ZipArchiveMode.Update);
+            var entry = zip.GetEntry("word/document.xml");
+            if (entry == null)
+            {
+                Console.Error.WriteLine("Not a valid DOCX");
+                return;
+            }
+
+            XDocument doc;
+            using (var stream = entry.Open())
+                doc = XDocument.Load(stream);
+
+            int reorderedCount = 0;
+
+            foreach (var (parentName, order) in ElementOrder)
+            {
+                foreach (var parent in doc.Descendants(W + parentName))
+                {
+                    var children = parent.Elements().ToList();
+                    var sorted = children.OrderBy(e =>
+                    {
+                        var idx = order.IndexOf(e.Name.LocalName);
+                        return idx >= 0 ? idx : order.Count;
+                    }).ToList();
+
+                    bool changed = false;
+                    for (int i = 0; i < children.Count; i++)
+                    {
+                        if (children[i] != sorted[i])
+                        {
+                            changed = true;
+                            break;
+                        }
+                    }
+
+                    if (changed)
+                    {
+                        parent.ReplaceNodes(sorted);
+                        reorderedCount++;
+                    }
+                }
+            }
+
+            entry.Delete();
+            var newEntry = zip.CreateEntry("word/document.xml", CompressionLevel.Optimal);
+            using (var stream = newEntry.Open())
+                doc.Save(stream);
+
+            zip.Dispose();
+            File.Copy(tempPath, output, true);
+            File.Delete(tempPath);
+
+            Console.WriteLine($"Reordered {reorderedCount} element group(s)");
+            Console.WriteLine($"Written to: {output}");
+        });
+
+        return cmd;
+    }
+}