@rosetears/aili-pi 0.1.0

package/skills/minimax-docx/references/openxml_namespaces.md

@@ -0,0 +1,82 @@
+# OpenXML Namespaces, Relationship Types, and Content Types
+
+## Core Namespaces
+
+| Prefix | URI | Used In |
+|--------|-----|---------|
+| `w` | `http://schemas.openxmlformats.org/wordprocessingml/2006/main` | document.xml, styles.xml, numbering.xml, headers, footers |
+| `r` | `http://schemas.openxmlformats.org/officeDocument/2006/relationships` | Relationship references (r:id) |
+| `wp` | `http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing` | Image/drawing placement in document |
+| `a` | `http://schemas.openxmlformats.org/drawingml/2006/main` | DrawingML core (shapes, images, themes) |
+| `pic` | `http://schemas.openxmlformats.org/drawingml/2006/picture` | Picture element in DrawingML |
+| `v` | `urn:schemas-microsoft-com:vml` | VML (legacy shapes, watermarks) |
+| `o` | `urn:schemas-microsoft-com:office:office` | Office VML extensions |
+| `m` | `http://schemas.openxmlformats.org/officeDocument/2006/math` | Math equations (OMML) |
+| `mc` | `http://schemas.openxmlformats.org/markup-compatibility/2006` | Markup compatibility (Ignorable, AlternateContent) |
+
+## Extended Namespaces
+
+| Prefix | URI | Purpose |
+|--------|-----|---------|
+| `w14` | `http://schemas.microsoft.com/office/word/2010/wordml` | Word 2010 extensions (contentPart, etc.) |
+| `w15` | `http://schemas.microsoft.com/office/word/2012/wordml` | Word 2013 extensions (commentEx, etc.) |
+| `w16cid` | `http://schemas.microsoft.com/office/word/2016/wordml/cid` | Comment IDs (durable IDs) |
+| `w16cex` | `http://schemas.microsoft.com/office/word/2018/wordml/cex` | Comment extensible |
+| `w16se` | `http://schemas.microsoft.com/office/word/2015/wordml/symex` | Symbol extensions |
+| `wps` | `http://schemas.microsoft.com/office/word/2010/wordprocessingShape` | WordprocessingML shapes |
+| `wpc` | `http://schemas.microsoft.com/office/word/2010/wordprocessingCanvas` | Drawing canvas |
+
+## Relationship Types
+
+| Relationship | Type URI |
+|-------------|----------|
+| Document | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument` |
+| Styles | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles` |
+| Numbering | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/numbering` |
+| Font Table | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/fontTable` |
+| Settings | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/settings` |
+| Theme | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme` |
+| Image | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/image` |
+| Hyperlink | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink` |
+| Header | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/header` |
+| Footer | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer` |
+| Comments | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/comments` |
+| CommentsExtended | `http://schemas.microsoft.com/office/2011/relationships/commentsExtended` |
+| CommentsIds | `http://schemas.microsoft.com/office/2016/09/relationships/commentsIds` |
+| CommentsExtensible | `http://schemas.microsoft.com/office/2018/08/relationships/commentsExtensible` |
+| Footnotes | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/footnotes` |
+| Endnotes | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/endnotes` |
+| Glossary | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/glossaryDocument` |
+| Web Settings | `http://schemas.openxmlformats.org/officeDocument/2006/relationships/webSettings` |
+
+## Content Types (`[Content_Types].xml`)
+
+### Default Extensions
+
+```xml
+<Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml" />
+<Default Extension="xml" ContentType="application/xml" />
+<Default Extension="png" ContentType="image/png" />
+<Default Extension="jpeg" ContentType="image/jpeg" />
+<Default Extension="gif" ContentType="image/gif" />
+<Default Extension="emf" ContentType="image/x-emf" />
+```
+
+### Part Overrides
+
+| Part | Content Type |
+|------|-------------|
+| `/word/document.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml` |
+| `/word/styles.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.styles+xml` |
+| `/word/numbering.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.numbering+xml` |
+| `/word/settings.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.settings+xml` |
+| `/word/fontTable.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.fontTable+xml` |
+| `/word/theme/theme1.xml` | `application/vnd.openxmlformats-officedocument.theme+xml` |
+| `/word/header1.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.header+xml` |
+| `/word/footer1.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.footer+xml` |
+| `/word/comments.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml` |
+| `/word/commentsExtended.xml` | `application/vnd.ms-word.commentsExtended+xml` |
+| `/word/commentsIds.xml` | `application/vnd.ms-word.commentsIds+xml` |
+| `/word/commentsExtensible.xml` | `application/vnd.ms-word.commentsExtensible+xml` |
+| `/word/footnotes.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.footnotes+xml` |
+| `/word/endnotes.xml` | `application/vnd.openxmlformats-officedocument.wordprocessingml.endnotes+xml` |

package/skills/minimax-docx/references/openxml_units.md

@@ -0,0 +1,72 @@
+# OpenXML Unit Conversion Quick Reference
+
+## Master Conversion Table
+
+| Unit | 1 inch | 1 cm | 1 mm | 1 pt | Description |
+|------|--------|------|------|------|-------------|
+| DXA (twips) | 1440 | 567 | 56.7 | 20 | 1/20 of a point. Used for margins, indents, spacing, page size. |
+| EMU | 914400 | 360000 | 36000 | 12700 | English Metric Unit. Used for images, drawings, shapes. |
+| Half-points | 144 | 56.7 | 5.67 | 2 | Used for font sizes (`w:sz`, `w:szCs`). |
+| Points | 72 | 28.35 | 2.835 | 1 | Standard typographic unit. Not used directly in most attributes. |
+| Eighths of a point | 576 | 226.8 | 22.68 | 8 | Used for `w:spacing` character spacing. |
+
+## Common Page Sizes
+
+| Size | Width (DXA) | Height (DXA) | Width (mm) | Height (mm) |
+|------|-------------|--------------|------------|-------------|
+| A4 | 11906 | 16838 | 210 | 297 |
+| Letter | 12240 | 15840 | 215.9 | 279.4 |
+| Legal | 12240 | 20160 | 215.9 | 355.6 |
+| A3 | 16838 | 23811 | 297 | 420 |
+| A5 | 8391 | 11906 | 148 | 210 |
+
+## Common Margin Values
+
+| Margin | DXA | Inches | cm |
+|--------|-----|--------|----|
+| 0.5 inch | 720 | 0.5 | 1.27 |
+| 0.75 inch | 1080 | 0.75 | 1.91 |
+| 1 inch | 1440 | 1.0 | 2.54 |
+| 1.25 inch | 1800 | 1.25 | 3.18 |
+| 1.5 inch | 2160 | 1.5 | 3.81 |
+
+## Font Size Values (`w:sz`)
+
+| Display Size | w:sz value | Notes |
+|-------------|-----------|-------|
+| 8pt | 16 | |
+| 9pt | 18 | |
+| 10pt | 20 | |
+| 10.5pt | 21 | Common CJK body size |
+| 11pt | 22 | Default Calibri body |
+| 12pt | 24 | Default TNR body |
+| 14pt | 28 | Small heading |
+| 16pt | 32 | |
+| 18pt | 36 | |
+| 20pt | 40 | |
+| 24pt | 48 | |
+| 28pt | 56 | |
+| 36pt | 72 | |
+
+## Line Spacing Values
+
+Line spacing in `w:spacing` uses the `w:line` attribute in 240ths of a line (when `w:lineRule="auto"`):
+
+| Spacing | w:line value | w:lineRule |
+|---------|-------------|-----------|
+| Single | 240 | auto |
+| 1.15 (Word default) | 276 | auto |
+| 1.5 | 360 | auto |
+| Double | 480 | auto |
+| Exact 12pt | 240 | exact |
+| At least 12pt | 240 | atLeast |
+
+Note: When `lineRule="exact"` or `"atLeast"`, `w:line` is in **twips** (DXA), not 240ths. So `line="240"` with `lineRule="exact"` means exactly 12pt (240/20 = 12pt).
+
+## Conversion Formulas
+
+```
+DXA     = inches × 1440  = cm × 567     = pt × 20
+EMU     = inches × 914400 = cm × 360000 = pt × 12700
+sz      = pt × 2          (half-points)
+```

package/skills/minimax-docx/references/scenario_a_create.md

@@ -0,0 +1,284 @@
+# Scenario A: Creating a New DOCX from Scratch
+
+## When to Use
+
+Use Scenario A when:
+- The user has no existing file and wants a brand new document
+- The user provides content (text, tables, images) and wants it assembled into a DOCX
+- The user specifies a document type (report, letter, memo, academic) or describes a custom layout
+
+Do NOT use when: the user already has a DOCX they want to modify (→ Scenario B) or wants to restyle an existing document (→ Scenario C).
+
+---
+
+## Step-by-Step Workflow
+
+### 1. Determine Document Type
+
+Ask or infer the document type from the user's request:
+
+| Type | Typical Signals |
+|------|----------------|
+| Report | "report", "analysis", "whitepaper", sections with headings |
+| Letter | "letter", "dear", address block, salutation |
+| Memo | "memo", "memorandum", To/From/Subject fields |
+| Academic | "paper", "essay", "thesis", APA/MLA/Chicago mention |
+| Custom | None of the above, or user specifies exact formatting |
+
+### 2. Gather Content Requirements
+
+Collect from the user:
+- Title and subtitle (if any)
+- Author / organization
+- Section structure (headings and nesting)
+- Body content per section
+- Tables (headers + rows)
+- Images (file paths or placeholders)
+- Special elements: TOC, page numbers, watermark, headers/footers
+
+### 3. Select Style Set
+
+Based on document type, load the matching styles XML asset:
+- Report → `assets/styles/default_styles.xml` or `assets/styles/corporate_styles.xml`
+- Academic → `assets/styles/academic_styles.xml`
+- Letter / Memo / Custom → `assets/styles/default_styles.xml` (with overrides)
+
+### 4. Configure Page Setup
+
+Set `w:sectPr` values based on document type defaults (see below) or user overrides.
+
+```xml
+<w:sectPr>
+  <w:pgSz w:w="11906" w:h="16838" />  <!-- A4 -->
+  <w:pgMar w:top="1440" w:right="1440" w:bottom="1440" w:left="1440"
+           w:header="720" w:footer="720" w:gutter="0" />
+</w:sectPr>
+```
+
+### 5. Build Document Structure
+
+Assemble `word/document.xml` with:
+1. `w:body` as root container
+2. Paragraphs (`w:p`) with heading styles for section titles
+3. Body paragraphs with `Normal` style
+4. Tables, images, and other elements as needed
+5. Final `w:sectPr` as last child of `w:body`
+
+### 6. Apply Typography Defaults
+
+Set document-level defaults in `styles.xml` under `w:docDefaults`:
+```xml
+<w:docDefaults>
+  <w:rPrDefault>
+    <w:rPr>
+      <w:rFonts w:ascii="Calibri" w:hAnsi="Calibri" w:eastAsia="SimSun" w:cs="Arial" />
+      <w:sz w:val="22" />  <!-- 11pt -->
+      <w:szCs w:val="22" />
+    </w:rPr>
+  </w:rPrDefault>
+  <w:pPrDefault>
+    <w:pPr>
+      <w:spacing w:after="160" w:line="259" w:lineRule="auto" />
+    </w:pPr>
+  </w:pPrDefault>
+</w:docDefaults>
+```
+
+### 7. Add Complex Elements
+
+See the Complex Elements Guide section below.
+
+### 8. Run Validation Pipeline
+
+```
+dotnet run ... validate --xsd wml-subset.xsd
+dotnet run ... validate --xsd business-rules.xsd   # if applying a template
+```
+
+---
+
+## Document Type Defaults
+
+### Report
+| Property | Value |
+|----------|-------|
+| Body font | Calibri 11pt |
+| Heading font | Calibri Light |
+| H1 / H2 / H3 / H4 size | 28pt / 24pt / 18pt / 14pt |
+| Heading color | #2F5496 (corporate blue) |
+| Margins | 1 inch (1440 DXA) all sides |
+| Page size | A4 (11906 × 16838 DXA) |
+| Line spacing | Single (line="240") |
+| Paragraph spacing | 0pt before, 8pt after body |
+
+### Letter
+| Property | Value |
+|----------|-------|
+| Font | Calibri 11pt |
+| Page size | Letter (12240 × 15840 DXA) |
+| Margins | 1 inch all sides |
+| Structure | Date → Address → Salutation → Body → Closing → Signature |
+| Line spacing | Single |
+
+### Memo
+| Property | Value |
+|----------|-------|
+| Font | Arial 11pt |
+| Page size | Letter |
+| Margins | 0.75 inch (1080 DXA) |
+| Header | "MEMO" centered, bold, 16pt |
+| Fields | To, From, Date, Subject (bold labels, tab-aligned values) |
+
+### Academic
+| Property | Value |
+|----------|-------|
+| Font | Times New Roman 12pt |
+| Line spacing | Double (line="480") |
+| Margins | 1 inch all sides |
+| Page size | Letter |
+| Headings | Bold, same font, 14/13/12pt for H1/H2/H3 |
+| First line indent | 0.5 inch (720 DXA) |
+| Heading color | Black (no color) |
+
+---
+
+## Content Configuration JSON Format
+
+The CLI `create` command accepts a JSON config:
+
+```json
+{
+  "type": "report",
+  "title": "Quarterly Revenue Analysis",
+  "subtitle": "Q1 2026",
+  "author": "Finance Team",
+  "pageSize": "A4",
+  "margins": { "top": 1440, "right": 1440, "bottom": 1440, "left": 1440 },
+  "sections": [
+    {
+      "heading": "Executive Summary",
+      "level": 1,
+      "content": [
+        { "type": "paragraph", "text": "Revenue grew 12% year-over-year..." },
+        {
+          "type": "table",
+          "headers": ["Region", "Revenue", "Growth"],
+          "rows": [
+            ["North America", "$4.2M", "+15%"],
+            ["Europe", "$2.8M", "+8%"],
+            ["Asia Pacific", "$1.9M", "+18%"]
+          ]
+        },
+        { "type": "image", "path": "charts/revenue.png", "width": "5in", "alt": "Revenue chart" }
+      ]
+    },
+    {
+      "heading": "Detailed Analysis",
+      "level": 1,
+      "content": [
+        { "type": "paragraph", "text": "Breaking down by product line..." }
+      ]
+    }
+  ]
+}
+```
+
+Supported content types:
+- `paragraph` — body text (applies Normal style)
+- `table` — headers + rows (applies TableGrid style)
+- `image` — inline image with width/height control
+- `list` — bulleted or numbered list items
+- `pageBreak` — forces a page break
+
+---
+
+## Complex Elements Guide
+
+### Table of Contents
+
+Insert a TOC field code. Word will update the actual entries when the file is opened:
+
+```xml
+<w:p>
+  <w:pPr><w:pStyle w:val="TOCHeading" /></w:pPr>
+  <w:r><w:t>Table of Contents</w:t></w:r>
+</w:p>
+<w:p>
+  <w:r>
+    <w:fldChar w:fldCharType="begin" />
+  </w:r>
+  <w:r>
+    <w:instrText xml:space="preserve"> TOC \o "1-3" \h \z \u </w:instrText>
+  </w:r>
+  <w:r>
+    <w:fldChar w:fldCharType="separate" />
+  </w:r>
+  <w:r>
+    <w:t>[Table of contents — update to populate]</w:t>
+  </w:r>
+  <w:r>
+    <w:fldChar w:fldCharType="end" />
+  </w:r>
+</w:p>
+```
+
+### Page Numbers in Footer
+
+Add a footer part (`word/footer1.xml`) and reference it in `w:sectPr`:
+
+```xml
+<!-- In footer1.xml -->
+<w:ftr xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">
+  <w:p>
+    <w:pPr><w:jc w:val="center" /></w:pPr>
+    <w:r>
+      <w:fldChar w:fldCharType="begin" />
+    </w:r>
+    <w:r>
+      <w:instrText>PAGE</w:instrText>
+    </w:r>
+    <w:r>
+      <w:fldChar w:fldCharType="separate" />
+    </w:r>
+    <w:r><w:t>1</w:t></w:r>
+    <w:r>
+      <w:fldChar w:fldCharType="end" />
+    </w:r>
+  </w:p>
+</w:ftr>
+
+<!-- In sectPr -->
+<w:footerReference w:type="default" r:id="rId8" />
+```
+
+### Watermark
+
+Add a header part with a shape behind the text:
+
+```xml
+<w:hdr>
+  <w:p>
+    <w:r>
+      <w:pict>
+        <v:shape style="position:absolute;margin-left:0;margin-top:0;width:468pt;height:180pt;
+                        z-index:-251657216;mso-position-horizontal:center;
+                        mso-position-vertical:center"
+                 fillcolor="silver" stroked="f">
+          <v:textpath style="font-family:'Calibri';font-size:1pt" string="DRAFT" />
+        </v:shape>
+      </w:pict>
+    </w:r>
+  </w:p>
+</w:hdr>
+```
+
+---
+
+## Post-Creation Checklist
+
+1. **Validate** against `wml-subset.xsd` — all elements in correct order, required attributes present
+2. **Merge adjacent runs** with identical formatting to keep XML clean
+3. **Verify relationships** — every `r:id` in document.xml has a matching entry in `document.xml.rels`
+4. **Check content types** — every part in the package is registered in `[Content_Types].xml`
+5. **Preview** — open in Word or LibreOffice to visually confirm layout
+6. **File size** — confirm images are reasonably sized (compress if > 2MB each)