wiki-ado-convert

# ADO Wiki Converter Generate a Node.js build script that transforms VitePress/GFM markdown documentation into Azure DevOps Wiki-compatible format. The source files remain untouched — the script produces transformed copies in `dist/ado-wiki/`. ## Source Repository Resolution (MUST DO FIRST) Before generating the build script, resolve the source repository context: 1. **Check for git remote**: Run `git remote get-url origin` 2. **Ask the user**: _"Is this a local-only repository, or do you have a source repository URL?"_ - Remote URL → store as `REPO_URL`, preserve linked citations in converted output - Local → preserve local citations as-is 3. **Do NOT proceed** until resolved ## Why This Is Needed Azure DevOps Wikis use a markdown dialect that differs from GFM and VitePress in several critical ways. Documentation that renders perfectly in VitePress will have broken diagrams, raw front matter, dead links, and rendering issues when published as an ADO Wiki. ## ADO Wiki Incompatibilities ### CRITICAL — Will Break Rendering | Issue | VitePress/GFM | ADO Wiki | Fix | |-------|--------------|----------|-----| | Mermaid code fences | ` ```mermaid ` ... ` ``` ` | `::: mermaid` ... `:::` | Convert opening/closing fences | | `flowchart` keyword | `flowchart TD` | `graph TD` | Replace `flowchart` with `graph` (preserve direction) | | `<br>` in Mermaid labels | `Node[Label<br>Text]` | Not supported | Strip `<br>` variants (replace with space) | | Long arrows `---->` | `A ...