# ysoseri1224/fully-auto-docx-format-process architecture

> Architecture diagram of the GitHub repository ysoseri1224/fully-auto-docx-format-process, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ysoseri1224/fully-auto-docx-format-process
- Repository: https://github.com/ysoseri1224/fully-auto-docx-format-process

## Overview

WriteMaster formats Markdown or existing DOCX files into template-styled DOCX output, and provides a desktop workbench for template/profile management, AI review, and document comments. The primary workflow is user input through the CLI or Electron interface, optional Markdown-to-DOCX conversion with Pandoc, then OOXML review processing against a selected master. README-described features whose implementation was not sampled are included at their documented subsystem paths; edges are limited to documented or indexed relationships.

Main entry points: [`electron/main.js`](https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/electron/main.js) (Desktop process), [`src/cli.js`](https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/cli.js) (CLI), [`src/core/build.js`](https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/build.js) (Markdown build), [`src/core/review.js`](https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/review.js) (OOXML formatter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User interfaces"]
  node_cli["CLI<br/>[cli.js]"]
  node_desktop["Desktop process<br/>[main.js]"]
  node_renderer["Workbench UI<br/>[renderer.js]"]
  node_rust["Rust wrapper<br/>[main.rs]"]
end

subgraph group_format["Document formatting"]
  node_pandoc["Pandoc converter<br/>[pandoc.js]"]
  node_build["Markdown build<br/>[build.js]"]
  node_reviewcore["OOXML formatter<br/>[review.js]"]
  node_masters["Master templates"]
  node_pandocdownload["Pandoc download<br/>[pandoc.js]"]
end

subgraph group_workbench["Workbench features"]
  node_extract["Template extraction<br/>[extract.js]"]
  node_profiles["Style profiles"]
  node_comments["DOCX comments<br/>[comment.js]"]
end

subgraph group_review["AI review"]
  node_skills["Review skills"]
  node_report["Review report"]
  node_ccswitch[("CC Switch config<br/>[cc-switch.js]")]
end

node_user(("Writer"))
node_markdown["Markdown source"]
node_docx["DOCX document"]
node_ai["AI provider API"]

node_user -->|"runs"| node_cli
node_user -->|"uses"| node_desktop
node_user -->|"runs"| node_rust
node_rust -->|"launches Node"| node_cli
node_cli -->|"builds Markdown"| node_build
node_cli -->|"formats DOCX"| node_reviewcore
node_markdown -->|"supplies input"| node_cli
node_markdown -->|"supplies source"| node_build
node_build -->|"converts via"| node_pandoc
node_pandoc -->|"writes temporary DOCX"| node_build
node_build -->|"post-processes"| node_reviewcore
node_reviewcore -->|"applies styles"| node_masters
node_reviewcore -->|"writes output"| node_docx
node_docx -->|"supplies input"| node_cli
node_desktop -->|"runs build"| node_build
node_desktop -->|"runs formatting"| node_reviewcore
node_renderer -->|"invokes workbench"| node_desktop
node_desktop -->|"generates profiles"| node_extract
node_extract -->|"uses OOXML helpers"| node_reviewcore
node_desktop -->|"manages profiles"| node_profiles
node_desktop -->|"handles comments"| node_comments
node_renderer -->|"edits comments"| node_comments
node_desktop -->|"lists skills"| node_skills
node_desktop -->|"streams review requests"| node_ai
node_skills -->|"guides review"| node_desktop
node_ai -->|"generates report"| node_report
node_desktop -->|"exports report"| node_report
node_desktop -->|"loads API config"| node_ccswitch
node_desktop -->|"downloads converter"| node_pandocdownload
node_pandocdownload -->|"provides executable"| node_pandoc

click node_cli "https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/cli.js"
click node_desktop "https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/electron/main.js"
click node_renderer "https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/electron/renderer.js"
click node_rust "https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/rust-wrapper/src/main.rs"
click node_pandoc "https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/pandoc.js"
click node_build "https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/build.js"
click node_reviewcore "https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/review.js"
click node_masters "https://github.com/ysoseri1224/fully-auto-docx-format-process/tree/main/templates"
click node_extract "https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/extract.js"
click node_profiles "https://github.com/ysoseri1224/fully-auto-docx-format-process/tree/main/electron"
click node_comments "https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/comment.js"
click node_skills "https://github.com/ysoseri1224/fully-auto-docx-format-process/tree/main/ContRev"
click node_ccswitch "https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/cc-switch.js"
click node_pandocdownload "https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/pandoc.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_desktop,node_renderer,node_rust toneBlue
class node_pandoc,node_build,node_reviewcore,node_masters,node_pandocdownload toneAmber
class node_extract,node_profiles,node_comments,node_ai toneMint
class node_skills,node_report,node_ccswitch toneRose
class node_user,node_markdown,node_docx toneIndigo
```

## Components

### User interfaces

- [CLI](https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/cli.js): `src/cli.js`
- [Desktop process](https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/electron/main.js): `electron/main.js`
- [Workbench UI](https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/electron/renderer.js): `electron/renderer.js`
- [Rust wrapper](https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/rust-wrapper/src/main.rs): `rust-wrapper/src/main.rs`

### Document formatting

- [Pandoc converter](https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/pandoc.js): `src/core/pandoc.js`
- [Markdown build](https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/build.js): `src/core/build.js`
- [OOXML formatter](https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/review.js): `src/core/review.js`
- [Master templates](https://github.com/ysoseri1224/fully-auto-docx-format-process/tree/main/templates): `templates`
- [Pandoc download](https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/pandoc.js): `src/core/pandoc.js`

### Workbench features

- [Template extraction](https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/extract.js): `src/core/extract.js`
- [Style profiles](https://github.com/ysoseri1224/fully-auto-docx-format-process/tree/main/electron): `electron`
- [DOCX comments](https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/comment.js): `src/core/comment.js`

### AI review

- [Review skills](https://github.com/ysoseri1224/fully-auto-docx-format-process/tree/main/ContRev): `ContRev`
- **Review report**
- [CC Switch config](https://github.com/ysoseri1224/fully-auto-docx-format-process/blob/main/src/core/cc-switch.js): `src/core/cc-switch.js`

### Other components

- **Writer**
- **Markdown source**
- **DOCX document**
- **AI provider API**

## Connections

- Writer → CLI: runs (evidence: `README.md`)
- Writer → Desktop process: uses (evidence: `README.md`)
- Writer → Rust wrapper: runs (evidence: `README.md`)
- Rust wrapper → CLI: launches Node (evidence: `rust-wrapper/src/main.rs`)
- CLI → Markdown build: builds Markdown (evidence: `src/cli.js`)
- CLI → OOXML formatter: formats DOCX (evidence: `src/cli.js`)
- Markdown source → CLI: supplies input (evidence: `README.md`)
- Markdown source → Markdown build: supplies source (evidence: `src/core/build.js`)
- Markdown build → Pandoc converter: converts via (evidence: `src/core/build.js`)
- Pandoc converter → Markdown build: writes temporary DOCX (evidence: `src/core/build.js`)
- Markdown build → OOXML formatter: post-processes (evidence: `src/core/build.js`)
- OOXML formatter → Master templates: applies styles (evidence: `README.md`)
- OOXML formatter → DOCX document: writes output (evidence: `README.md`)
- DOCX document → CLI: supplies input (evidence: `README.md`)
- Desktop process → Markdown build: runs build (evidence: `electron/main.js`)
- Desktop process → OOXML formatter: runs formatting (evidence: `electron/main.js`)
- Workbench UI → Desktop process: invokes workbench (evidence: `README.md`)
- Desktop process → Template extraction: generates profiles (evidence: `electron/main.js`)
- Template extraction → OOXML formatter: uses OOXML helpers (evidence: `src/core/extract.js`)
- Desktop process → Style profiles: manages profiles (evidence: `README.md`)
- Desktop process → DOCX comments: handles comments (evidence: `electron/main.js`)
- Workbench UI → DOCX comments: edits comments (evidence: `README.md`)
- Desktop process → Review skills: lists skills (evidence: `electron/main.js`)
- Desktop process → AI provider API: streams review requests (evidence: `README.md`)
- Review skills → Desktop process: guides review (evidence: `README.md`)
- AI provider API → Review report: generates report (evidence: `README.md`)
- Desktop process → Review report: exports report (evidence: `README.md`)
- Desktop process → CC Switch config: loads API config (evidence: `README.md`)
- Desktop process → Pandoc download: downloads converter (evidence: `electron/main.js`)
- Pandoc download → Pandoc converter: provides executable (evidence: `src/core/pandoc.js`)
