This release includes breaking changes for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Topics
+12 more
ReleasePort's take
Light signalThe release introduces a persistent, queryable architecture knowledge graph stored in .claude/architecture.md and adds `kg_*` CLI tools for managing it.
Why it matters: Enables architects to persistently store and programmatically query system design data via markdown and new kg_* commands, improving documentation consistency.
Summary
AI summaryArchitecture is now a persistent, queryable knowledge graph with multiple view capabilities.
Changes in this release
| Type | Severity | Summary | CVE |
|---|---|---|---|
| Feature | Medium |
Architecture is now a persistent, queryable knowledge graph stored in .claude/architecture.md markdown. Architecture is now a persistent, queryable knowledge graph stored in .claude/architecture.md markdown. Source: llm_adapter@2026-06-08 Confidence: high |
— |
| Feature | Medium |
Parallel edges render as distinct, labelled arrows for multiple communication modes between services. Parallel edges render as distinct, labelled arrows for multiple communication modes between services. Source: llm_adapter@2026-06-08 Confidence: high |
— |
| Feature | Medium |
Introduces new `kg_*` tools for initializing, modifying, querying, and exporting the architecture knowledge graph. Introduces new `kg_*` tools for initializing, modifying, querying, and exporting the architecture knowledge graph. Source: llm_adapter@2026-06-08 Confidence: high |
— |
| Feature | Low |
Adds new README section and `architecture-knowledge-graph` skill documentation. Adds new README section and `architecture-knowledge-graph` skill documentation. Source: llm_adapter@2026-06-08 Confidence: high |
— |
| Bugfix | Medium |
Edge labels no longer overlap arrows in SVG/PNG exports; lines are masked behind bound labels. Edge labels no longer overlap arrows in SVG/PNG exports; lines are masked behind bound labels. Source: llm_adapter@2026-06-08 Confidence: high |
— |
| Bugfix | Medium |
Fixed infinite loop in edge routing when two arrows share an endpoint. Fixed infinite loop in edge routing when two arrows share an endpoint. Source: llm_adapter@2026-06-08 Confidence: high |
— |
Full changelog
The big one: your architecture is now a living knowledge graph, not just a diagram. This release turns the project from a diagram generator into a persistent, queryable model of your system — diagrams become
views of it.
🧠 Architecture Knowledge Graph
Your services and dependencies now live in a single version-controlled markdown file (default .claude/architecture.md) that the AI builds once and reuses everywhere. It's human-readable, round-trips losslessly,
and diffs cleanly in PRs.
- One source of truth, many views — render the full system, a single domain, or everything within N hops of one service
- Queryable — "what breaks if payments goes down?" returns the real upstream blast radius
- Self-checking — lint for dependency cycles, single points of failure, orphans, and dangling references
- Bootstrap from what you have — import existing
.excalidrawdiagrams into the graph - Export anywhere — Mermaid, Graphviz DOT, or JSON
- Git-aware — diff how the architecture changed since any ref; generate onboarding docs; detect drift against actual Python imports
🔀 Parallel edges
Two communication modes between the same services (e.g. a solid REST /charge call and a dashed Kafka payment.requested event) now render as two distinct, labelled arrows instead of collapsing into one.
🛠️ New MCP tools (kg_*)
kg_init · kg_add_service · kg_remove_service · kg_link · kg_unlink · kg_set_domain · kg_info · kg_render · kg_render_view · kg_render_around · kg_render_domain · kg_import ·
whats_connected_to · kg_path · kg_lint · kg_export · kg_diff · kg_onboarding_doc · kg_drift
🐛 Fixes
- Edge labels no longer overlap arrows in SVG/PNG export — the line is now masked behind bound labels, matching Excalidraw's native rendering (improves every exported diagram)
- Fixed an infinite loop in edge routing when two arrows share an endpoint
📚 Docs
- New README section for the knowledge graph, with a
kg_*tool reference - New
architecture-knowledge-graphskill that teaches the AI how to read a codebase and build a clean graph
✅ Compatibility
Fully additive — the existing tools (create_diagram, mermaid_to_excalidraw, modify_diagram, get_diagram_info, export_diagram) are unchanged. No breaking changes.
📦 Install / upgrade
pip install -U excalidraw-architect-mcp
# or, no install:
uvx excalidraw-architect-mcp
Full changelog: https://github.com/BV-Venky/excalidraw-architect-mcp/compare/v0.3.0...v1.0.3Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About BV-Venky/excalidraw-architect-mcp
An MCP server that generates beautiful Excalidraw architecture diagrams with perfect auto-layout.
Beta — feedback welcome: [email protected]