@nguyenphp/antigravity-marketing 1.0.16 → 1.0.19

package/templates/.agent/skills/minimax-docx/references/typography_guide.md

@@ -0,0 +1,294 @@
+# Professional Document Design & Typography Guide
+
+## Table of Contents
+1. [Font Pairing](#font-pairing)
+2. [Font Sizes by Document Type](#font-sizes-by-document-type)
+3. [Line Spacing](#line-spacing)
+4. [Paragraph Spacing](#paragraph-spacing)
+5. [Page Layout](#page-layout)
+6. [Table Design](#table-design)
+7. [Color Schemes](#color-schemes)
+8. [Visual Hierarchy](#visual-hierarchy)
+9. [Quick Reference Defaults](#quick-reference-defaults)
+
+---
+
+## Font Pairing
+
+### Recommended Pairs
+
+| Headings | Body | Style | Best For |
+|----------|------|-------|----------|
+| Calibri Light | Calibri | Modern sans | Corporate reports |
+| Aptos | Aptos | Office 365 default | Modern business docs |
+| Cambria | Calibri | Serif + sans | Academic-corporate hybrid |
+| Times New Roman | Times New Roman | Traditional serif | Academic, legal |
+| Arial | Arial | Clean sans | Memos, internal docs |
+| Georgia | Garamond | Classical serif pair | Formal reports |
+
+### Rules
+
+- **Limit**: 2 font families max (3 if CJK mixed)
+- **Contrast**: Pair serif with sans-serif, OR use weight contrast within one family
+- **Consistency**: Same font for all body text, same font for all headings
+
+---
+
+## Font Sizes by Document Type
+
+| Document Type | Body | H1 | H2 | H3 | Footnotes |
+|--------------|------|----|----|----|----|
+| **Business report** | 11pt | 18-20pt | 14-16pt | 12-13pt bold | 9pt |
+| **Business letter** | 11-12pt | — | — | — | 9-10pt |
+| **Memo** | 11pt | 14pt bold | 12pt bold | 11pt bold | 9pt |
+| **Contract / Legal** | 12pt | 14pt bold caps | 12pt bold | 12pt bold | 10pt |
+| **Academic (APA 7)** | 12pt | 12pt bold center | 12pt bold left | 12pt bold italic | 10pt |
+| **Resume / CV** | 10-11pt | 14-16pt | 12pt bold | 11pt bold | 8-9pt |
+| **Chinese 公文** | 三号(16pt) | 二号(22pt) | 三号(16pt) | 四号(14pt) | 小四(12pt) |
+
+### OpenXML `w:sz` Values (half-points)
+
+| Point Size | `w:sz` Val | Common Use |
+|-----------|-----------|------------|
+| 9pt | 18 | Footnotes, captions |
+| 10pt | 20 | Compact body text |
+| 10.5pt (五号) | 21 | CJK body small |
+| 11pt | 22 | Standard body (Calibri) |
+| 12pt (小四) | 24 | Standard body (TNR), CJK |
+| 14pt (四号) | 28 | CJK body, subheading |
+| 16pt (三号) | 32 | CJK heading, western H2 |
+| 18pt (小二) | 36 | Western H1 |
+| 22pt (二号) | 44 | CJK document title |
+| 26pt (一号) | 52 | Large title |
+
+---
+
+## Line Spacing
+
+| Spacing | OpenXML `w:spacing line` | When to Use |
+|---------|--------------------------|-------------|
+| Single (1.0) | `line="240"` lineRule="auto" | Tables, footnotes, captions |
+| 1.08 (MS default) | `line="259"` lineRule="auto" | Modern Office documents |
+| 1.15 | `line="276"` lineRule="auto" | Business reports — best general default |
+| 1.5 | `line="360"` lineRule="auto" | Some academic, drafts for markup |
+| Double (2.0) | `line="480"` lineRule="auto" | APA/MLA manuscripts, legal briefs |
+| Fixed 28pt | `line="560"` lineRule="exact" | Chinese 公文 (GB/T 9704) |
+
+**`lineRule` values**: `auto` = proportional (240 = 1 line), `exact` = fixed height, `atLeast` = minimum.
+
+---
+
+## Paragraph Spacing
+
+| Element | Space Before (DXA) | Space After (DXA) |
+|---------|-------------------|-------------------|
+| Body paragraph | 0 | 120-160 (6-8pt) |
+| Heading 1 | 480 (24pt) | 120-240 |
+| Heading 2 | 360 (18pt) | 120 |
+| Heading 3 | 240 (12pt) | 80-120 |
+| List items | 0 | 40-80 (2-4pt) |
+| Block quote | 120-240 | 120-240 |
+| Table/Figure caption | 240 | 240 |
+
+**Principle**: Space before a heading > space after, so heading visually "belongs to" content below (2:1 or 3:1 ratio).
+
+---
+
+## Page Layout
+
+### Margins by Document Type
+
+| Document Type | Top | Bottom | Left | Right | DXA Values |
+|--------------|-----|--------|------|-------|------------|
+| **Standard business** | 1 in | 1 in | 1 in | 1 in | 1440 all |
+| **Academic (APA/MLA)** | 1 in | 1 in | 1 in | 1 in | 1440 all |
+| **Thesis (binding)** | 1 in | 1 in | 1.5 in | 1 in | T/B:1440 L:2160 R:1440 |
+| **Chinese 公文** | 37mm | 35mm | 28mm | 26mm | T:2098 B:1984 L:1588 R:1474 |
+| **Narrow modern** | 0.75 in | 0.75 in | 0.75 in | 0.75 in | 1080 all |
+| **Wide** | 1 in | 1 in | 2 in | 2 in | T/B:1440 L/R:2880 |
+
+### Page Sizes
+
+| Size | Width × Height | DXA Width × Height |
+|------|---------------|-------------------|
+| US Letter | 8.5 × 11 in | 12240 × 15840 |
+| A4 | 210 × 297 mm | 11906 × 16838 |
+| Legal | 8.5 × 14 in | 12240 × 20160 |
+| A3 | 297 × 420 mm | 16838 × 23811 |
+
+**Rule**: A4 for international audiences, Letter for US-only.
+
+### Page Numbers
+
+| Convention | Placement | Common In |
+|-----------|-----------|-----------|
+| Bottom center | Footer, centered | Academic, government |
+| Bottom right | Footer, right-aligned | Business reports |
+| "Page X of Y" | Footer, right-aligned | Contracts, legal |
+| Bottom outside | Alternating L/R for odd/even | Books, bound reports |
+| Chinese 公文 | Bottom center, format "-X-" | Government documents |
+
+---
+
+## Table Design
+
+### Style Patterns
+
+| Style | Description | When to Use |
+|-------|------------|-------------|
+| **Three-line (三线表)** | Top rule + header-bottom rule + bottom rule only, no vertical lines | Academic, scientific — gold standard |
+| **Banded rows** | Alternating white/light-gray, no borders | Modern corporate |
+| **Light grid** | Thin 0.5pt gray borders all cells | Business reports |
+| **Header-accent** | Dark/colored header row, no other borders | Modern templates |
+| **Full border** | All cells bordered | Financial tables, forms |
+
+### Border Weights (OpenXML `w:sz` in eighths of a point)
+
+| Visual | `Size` value | Points |
+|--------|-------------|--------|
+| Hairline | 2 | 0.25pt |
+| Thin | 4 | 0.5pt |
+| Medium | 8 | 1pt |
+| Thick | 12 | 1.5pt |
+
+### Cell Padding
+
+- **Minimum**: 0.05 in (28 DXA) — too tight for most uses
+- **Recommended**: 0.08-0.1 in (57-72 DXA) top/bottom, 0.1-0.15 in (72-108 DXA) left/right
+- **Spacious**: 0.12 in (86 DXA) top/bottom, 0.19 in (137 DXA) left/right
+
+### Header Row Best Practices
+
+- Bold text, optionally SMALL CAPS
+- Background: light gray (#F2F2F2) or dark with white text (#2F5496 + white)
+- Repeat header row on each page (`w:tblHeader` on `w:trPr`)
+- Right-align number columns, left-align text columns
+
+---
+
+## Color Schemes
+
+### Corporate / Business
+
+| Element | Hex | Notes |
+|---------|-----|-------|
+| Primary heading | #1F3864 | Dark navy, authoritative |
+| Secondary heading | #2E75B6 | Medium blue |
+| Body text | #333333 | Near-black (softer than #000) |
+| Table header bg | #4472C4 | With white #FFFFFF text |
+| Alternate row | #F2F2F2 | Subtle gray banding |
+| Hyperlink | #0563C1 | Standard blue |
+
+### Academic
+
+All text **#000000** (black). Color only in figures/charts.
+
+### Chinese Government (公文)
+
+| Element | Color |
+|---------|-------|
+| All body text | Black (required) |
+| 红头 agency name | Red #FF0000 |
+| 红线 separator | Red #FF0000 |
+| 公章 seal | Red |
+
+### Accessibility
+
+- Minimum contrast ratio 4.5:1 for normal text, 3:1 for large text (WCAG AA)
+- Never use color as sole means of conveying information
+- Ensure distinguishable in grayscale for printed documents
+
+---
+
+## Visual Hierarchy
+
+### Heading Levels by Document Length
+
+| Pages | Recommended Levels |
+|-------|-------------------|
+| 1-5 (memo, letter) | 1-2 levels |
+| 5-20 (report) | 2-3 levels |
+| 20-100 (long report) | 3-4 levels |
+| 100+ (thesis) | 4-5 levels max |
+
+### Numbering Systems
+
+**Decimal (ISO 2145)** — technical, international:
+```
+1 → 1.1 → 1.1.1 → 1.1.1.1
+```
+
+**Traditional outline (US legal):**
+```
+I. → A. → 1. → a. → (1) → (a)
+```
+
+**Chinese government (公文):**
+```
+一、(黑体) → （一）(楷体) → 1.(仿宋加粗) → (1)(仿宋)
+```
+
+### Typography Emphasis
+
+| Format | Use For | Avoid |
+|--------|---------|-------|
+| **Bold** | Key terms, headings, emphasis | Entire paragraphs |
+| *Italic* | Titles, foreign words, mild emphasis | Long passages (hard to read) |
+| Underline | Hyperlinks only (digital) | General emphasis (archaic) |
+| SMALL CAPS | Legal defined terms, acronyms | Body text |
+| ALL CAPS | Very short headings | Long text (reduces readability 15%) |
+
+**CJK note**: Chinese/Japanese have no true italic. Use bold for emphasis.
+
+### List Formatting
+
+**Bullets** (unordered): `•` → `○` → `■` by level
+
+**Numbers** (ordered): `1.` → `a.` → `i.` by level
+
+- Indent each level 0.25-0.5 in (360-720 DXA)
+- Hanging indent: number hangs, text aligns consistently
+- Spacing between items: 2-4pt (less than paragraph spacing)
+
+---
+
+## Quick Reference Defaults
+
+### Business Report (Safe Default)
+
+| Parameter | Value | OpenXML |
+|-----------|-------|---------|
+| Body font | Calibri 11pt | sz="22", RunFonts Ascii="Calibri" |
+| H1 | 18pt Bold Dark Blue | sz="36", Bold, Color="#1F3864" |
+| H2 | 14pt Bold Dark Blue | sz="28", Bold |
+| H3 | 12pt Bold Dark Blue | sz="24", Bold |
+| Line spacing | 1.15 | line="276" lineRule="auto" |
+| Para after | 8pt | after="160" |
+| Margins | 1 in all | 1440 DXA all |
+| Page size | Letter or A4 | 12240×15840 or 11906×16838 |
+| Page numbers | Bottom right, 10pt | |
+
+### Academic Paper (APA 7th)
+
+| Parameter | Value | OpenXML |
+|-----------|-------|---------|
+| Font | Times New Roman 12pt | sz="24" |
+| Line spacing | Double | line="480" lineRule="auto" |
+| First-line indent | 0.5 in | ind firstLine="720" |
+| Margins | 1 in all | 1440 DXA all |
+| Page numbers | Top right | Header, right-aligned |
+
+### Chinese Government (公文 GB/T 9704)
+
+| Parameter | Value | OpenXML |
+|-----------|-------|---------|
+| Body font | 仿宋_GB2312 三号 | sz="32", EastAsia="FangSong_GB2312" |
+| Title | 小标宋 二号 centered | sz="44" |
+| L1 heading | 黑体 三号 | sz="32", EastAsia="SimHei" |
+| L2 heading | 楷体 三号 | sz="32", EastAsia="KaiTi_GB2312" |
+| Line spacing | Fixed 28pt | line="560" lineRule="exact" |
+| Margins | T:37mm B:35mm L:28mm R:26mm | T:2098 B:1984 L:1588 R:1474 |
+| Page size | A4 | 11906×16838 |
+| Page numbers | Bottom center, 宋体 四号, "-X-" | sz="28" |
+| Chars/line | 28 | |
+| Lines/page | 22 | |

package/templates/.agent/skills/minimax-docx/references/xsd_validation_guide.md

@@ -0,0 +1,158 @@
+# XSD Validation Guide
+
+## Running Validation
+
+```bash
+# Validate against the WML subset schema
+dotnet run --project minimax-docx validate input.docx --xsd assets/xsd/wml-subset.xsd
+
+# Validate against business rules (REQUIRED for Scenario C gate-check)
+dotnet run --project minimax-docx validate input.docx --xsd assets/xsd/business-rules.xsd
+
+# Validate against both
+dotnet run --project minimax-docx validate input.docx --xsd assets/xsd/wml-subset.xsd --xsd assets/xsd/business-rules.xsd
+```
+
+---
+
+## What wml-subset.xsd Covers
+
+The subset schema validates the most common WordprocessingML elements:
+
+| Area | Elements Validated |
+|------|--------------------|
+| Document structure | `w:document`, `w:body`, `w:sectPr` |
+| Paragraphs | `w:p`, `w:pPr`, `w:r`, `w:rPr`, `w:t` |
+| Tables | `w:tbl`, `w:tblPr`, `w:tblGrid`, `w:tr`, `w:tc` |
+| Styles | `w:styles`, `w:style`, `w:docDefaults` |
+| Lists | `w:numbering`, `w:abstractNum`, `w:num` |
+| Headers/Footers | `w:hdr`, `w:ftr` |
+| Track Changes | `w:ins`, `w:del`, `w:rPrChange`, `w:pPrChange` |
+| Comments | `w:comment`, `w:commentRangeStart`, `w:commentRangeEnd` |
+
+### What It Does NOT Cover
+
+- DrawingML elements (`a:`, `pic:`, `wp:`) — image/shape internals
+- VML elements (`v:`, `o:`) — legacy shapes
+- Math elements (`m:`) — equations
+- Extended namespaces (`w14`, `w15`, `w16*`) — vendor extensions
+- Custom XML data parts
+- Relationship and content type validation (structural, not schema-based)
+
+---
+
+## Interpreting Errors
+
+### Element Ordering Error
+
+```
+ERROR: Element 'w:jc' is not expected at this position.
+Expected: w:spacing, w:ind, w:contextualSpacing, ...
+Location: /word/document.xml, line 45
+```
+
+**Cause**: Child elements are in wrong order. See `references/openxml_element_order.md`.
+**Fix**: Reorder children to match schema sequence.
+
+### Missing Required Element
+
+```
+ERROR: Element 'w:tbl' missing required child 'w:tblPr'.
+Location: /word/document.xml, line 102
+```
+
+**Cause**: A required child element is absent.
+**Fix**: Add the missing element. Tables require both `w:tblPr` and `w:tblGrid`.
+
+### Invalid Attribute Value
+
+```
+ERROR: Attribute 'w:val' has invalid value 'middle'.
+Expected: 'left', 'center', 'right', 'both', 'distribute'
+Location: /word/document.xml, line 78
+```
+
+**Cause**: An attribute value is not in the allowed enumeration.
+**Fix**: Use one of the valid values listed in the error.
+
+### Unexpected Element
+
+```
+ERROR: Element 'w:customTag' is not expected.
+Location: /word/document.xml, line 200
+```
+
+**Cause**: An element not defined in the subset schema. May be a vendor extension.
+**Fix**: Check if it's a known extension (w14/w15/w16). If so, it's likely safe. If unknown, investigate or remove.
+
+---
+
+## Business Rules XSD
+
+The `business-rules.xsd` schema enforces project-specific constraints beyond standard OpenXML validity:
+
+| Rule | What It Checks |
+|------|---------------|
+| Required styles | `Normal`, `Heading1`-`Heading3`, `TableGrid` must exist in `styles.xml` |
+| Font consistency | `w:docDefaults` fonts match expected values |
+| Margin ranges | Page margins within acceptable range (720-2160 DXA) |
+| Page size | Must be A4 or Letter |
+| Heading hierarchy | No gaps (e.g., H1 → H3 without H2) |
+| Style chain | `w:basedOn` references must resolve to existing styles |
+
+### Extending Business Rules
+
+To add project-specific rules, add `xs:assert` or `xs:restriction` elements:
+
+```xml
+<!-- Require minimum 1-inch margins -->
+<xs:element name="pgMar">
+  <xs:complexType>
+    <xs:attribute name="top" type="xs:integer">
+      <xs:restriction>
+        <xs:minInclusive value="1440" />
+      </xs:restriction>
+    </xs:attribute>
+  </xs:complexType>
+</xs:element>
+```
+
+---
+
+## Gate-Check: Scenario C Hard Gate
+
+In Scenario C (Apply Template), the output document **MUST** pass `business-rules.xsd` validation before delivery:
+
+```
+1. Apply template  →  output.docx
+2. Validate        →  dotnet run ... validate output.docx --xsd business-rules.xsd
+3. PASS?           →  Deliver to user
+4. FAIL?           →  Fix issues, re-validate, repeat until PASS
+```
+
+**This is a hard gate.** A document that fails business-rules validation is NOT deliverable, even if it opens correctly in Word.
+
+---
+
+## False Positives
+
+### Vendor Extensions
+
+Elements from extended namespaces (`w14`, `w15`, `w16*`) are not in the subset schema and may trigger warnings:
+
+```
+WARNING: Element '{http://schemas.microsoft.com/office/word/2010/wordml}shadow' is not expected.
+```
+
+These are generally safe to ignore — they are Microsoft extensions for newer features (e.g., advanced text effects, comment extensions).
+
+### Markup Compatibility
+
+Documents may contain `mc:AlternateContent` blocks with fallback content. The subset schema may not recognize the `mc:` namespace processing. These are safe if the document opens correctly in Word.
+
+### Recommended Approach
+
+1. Run validation
+2. Treat **errors** as must-fix
+3. Review **warnings** — ignore known vendor extensions, investigate unknown elements
+4. After fixing errors, re-validate to confirm

package/templates/.agent/skills/minimax-docx/scripts/doc_to_docx.sh

@@ -0,0 +1,40 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  echo "Usage: $(basename "$0") <file.doc> [output_directory]"
+  echo "Convert .doc to .docx using LibreOffice."
+  exit 1
+}
+
+if [ $# -lt 1 ]; then
+  usage
+fi
+
+INPUT="$1"
+OUTDIR="${2:-.}"
+
+if [ ! -f "$INPUT" ]; then
+  echo "Error: File not found: $INPUT"
+  exit 1
+fi
+
+if ! command -v soffice &>/dev/null; then
+  echo "Error: soffice (LibreOffice) is required for .doc conversion but not found."
+  echo "Install LibreOffice: brew install --cask libreoffice"
+  exit 1
+fi
+
+BASENAME=$(basename "$INPUT" .doc)
+mkdir -p "$OUTDIR"
+
+echo "Converting: $INPUT -> $OUTDIR/$BASENAME.docx"
+soffice --headless --convert-to docx --outdir "$OUTDIR" "$INPUT" >/dev/null 2>&1
+
+OUTPUT="$OUTDIR/$BASENAME.docx"
+if [ ! -f "$OUTPUT" ]; then
+  echo "Error: Conversion failed. Output file not created: $OUTPUT"
+  exit 1
+fi
+
+echo "Success: $OUTPUT"

package/templates/.agent/skills/minimax-docx/scripts/docx_preview.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  echo "Usage: $(basename "$0") <file.docx>"
+  echo "Preview DOCX content as plain text."
+  exit 1
+}
+
+if [ $# -lt 1 ]; then
+  usage
+fi
+
+INPUT="$1"
+
+if [ ! -f "$INPUT" ]; then
+  echo "Error: File not found: $INPUT"
+  exit 1
+fi
+
+FILE_SIZE=$(du -h "$INPUT" | cut -f1)
+echo "=== DOCX Preview: $(basename "$INPUT") ==="
+echo "File size: $FILE_SIZE"
+
+if command -v pandoc &>/dev/null; then
+  CONTENT=$(pandoc -f docx -t plain "$INPUT" 2>/dev/null)
+  WORD_COUNT=$(echo "$CONTENT" | wc -w | tr -d ' ')
+  EST_PAGES=$(( (WORD_COUNT + 249) / 250 ))
+  echo "Word count: $WORD_COUNT"
+  echo "Estimated pages: $EST_PAGES"
+  echo "---"
+  echo "$CONTENT"
+else
+  echo "(pandoc not available, falling back to raw XML extract)"
+  echo "---"
+  unzip -p "$INPUT" word/document.xml 2>/dev/null | head -100
+fi

package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Cli/MiniMaxAIDocx.Cli.csproj

@@ -0,0 +1,19 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <ItemGroup>
+    <ProjectReference Include="..\MiniMaxAIDocx.Core\MiniMaxAIDocx.Core.csproj" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="System.CommandLine" Version="2.0.5" />
+  </ItemGroup>
+
+  <PropertyGroup>
+    <OutputType>Exe</OutputType>
+    <TargetFramework>net8.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+    <NeutralLanguage>en</NeutralLanguage>
+  </PropertyGroup>
+
+</Project>

package/templates/.agent/skills/minimax-docx/scripts/dotnet/MiniMaxAIDocx.Cli/Program.cs

@@ -0,0 +1,18 @@
+using System.CommandLine;
+using MiniMaxAIDocx.Core.Commands;
+
+var rootCommand = new RootCommand("minimax-docx: OpenXML document generation and manipulation CLI");
+
+// Scenario commands
+rootCommand.Add(CreateCommand.Create());
+rootCommand.Add(EditContentCommand.Create());
+rootCommand.Add(ApplyTemplateCommand.Create());
+
+// Tool commands
+rootCommand.Add(ValidateCommand.Create());
+rootCommand.Add(MergeRunsCommand.Create());
+rootCommand.Add(FixOrderCommand.Create());
+rootCommand.Add(AnalyzeCommand.Create());
+rootCommand.Add(DiffCommand.Create());
+
+return rootCommand.Parse(args).Invoke();