Skip to content

Downgrade Mermaider to 0.12.2 to fix Mermaid rendering - #4308

Merged
theletterf merged 2 commits into
mainfrom
fix/revert-mermaider-0.14.0
Oct 5, 2026
Merged

theletterf merged 2 commits into
mainfrom
fix/revert-mermaider-0.14.0

Conversation

@reakaleek

Copy link
Copy Markdown
Member

This downgrades Mermaider from 0.14.0 back to 0.12.2. It reverts #4307, which makes Codex builds fail on Mermaid diagrams.

Affects: Codex builds, Authoring

Prompt summary: The codex-environments build broke after the latest docs-builder release. The ask is to downgrade Mermaider and ship the downgrade as a fix release.

Why

Since the upgrade to Mermaider 0.14.0, the codex-environments build fails. Two diagrams that rendered with 0.12.2 now fail to render, and each failure is reported as an error:

Error: Failed to render Mermaid diagram: The operation was canceled.
Error: Failed to render Mermaid diagram: The given key 'AUT' was not present in the dictionary.

What

Mermaider pinned back to 0.12.2

The Mermaider version in Directory.Packages.props goes back to 0.12.2, the version before #4307. Nothing else changes. The upgrade can come back once upstream fixes these rendering errors.

Verify

dotnet build
./build.sh unit-test

🤖 Generated with Claude Code

Mermaider 0.14.0 fails to render diagrams that 0.12.2 handled, which
breaks the codex-environments build. This reverts #4307 until the
upstream rendering errors are fixed.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@reakaleek
reakaleek requested a review from a team as a code owner October 5, 2026 15:34
@reakaleek
reakaleek requested a review from theletterf October 5, 2026 15:34
@reakaleek reakaleek added the bug label Oct 5, 2026
@github-actions

github-actions Bot commented Oct 5, 2026

Copy link
Copy Markdown
Contributor

Docs preview (local build)

Handbook preview: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/4308/

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved — no actionable issues found.


What is this? | From workflow: PR Review

Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.

@theletterf

Copy link
Copy Markdown
Member

@copilot resolve the merge conflicts in this pull request

Keep Mermaider at 0.12.2 while including the latest main history.

Co-Authored-By: Claude <noreply@anthropic.com>

Copilot AI commented Oct 5, 2026

Copy link
Copy Markdown
Contributor

@copilot resolve the merge conflicts in this pull request

Merged the latest main and resolved the conflict while keeping Mermaider at 0.12.2. Merge commit: 7d83f61.

@theletterf
theletterf merged commit 036a375 into main Oct 5, 2026
37 checks passed
@theletterf
theletterf deleted the fix/revert-mermaider-0.14.0 branch October 5, 2026 17:19
theletterf pushed a commit that referenced this pull request Oct 7, 2026
Mermaider 0.14.0/0.14.1 broke diagram rendering for some internal docs
repos (#4308), so the version was pinned back to
0.12.2. This re-attempts the upgrade with 0.15.1, which includes fixes
for the rendering regressions. Verified locally with a full
codex clone/build of the internal environment (84 documentation sets,
551 diagrams) including isomer/docs/reference/okf-map.md, the diagram
that previously failed with "The given key 'AUT' was not present in
the dictionary" — it now renders cleanly.

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants