feat(graph): add plantuml output format

[jongio]

What

Adds plantuml as an output format for azd app graph.

azd app graph --output plantuml emits a PlantUML component diagram you can paste into docs or render with any PlantUML tool.

Why

The command already produces Mermaid and Graphviz DOT. PlantUML is a common choice for architecture docs and is supported by many wikis and IDE plugins. This adds it alongside the existing diagram formats without changing any of them.

Details

• New plantuml value for --output (-o).
• Output is wrapped in @startuml / @enduml.
• Services render as component, resources render as database, so the two are easy to tell apart.
• Dependency edges use --> with sanitized aliases, reusing the same alias generator as the Mermaid renderer.
• A title line is emitted from the project name and omitted when the project is empty.
• Works with --output-file and --focus, same as the other formats.

Tests

• TestRenderGraphPlantUML, TestRenderGraphPlantUMLNoProject, and TestEscapePlantUMLLabel cover the rendered structure, the empty-project case, and label escaping.
• go build ./..., the commands package tests, and golangci-lint all pass.

Closes #525

[github-actions]

🚀 Website Preview

Your PR preview is ready!

📎 Preview URL: https://jongio.github.io/azd-app/pr/528/

This preview will be automatically cleaned up when the PR is closed.

[codecov]

Codecov Report

❌ Patch coverage is 89.18919% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 61.81%. Comparing base (c0083e6) to head (745ced9).
⚠️ Report is 2 commits behind head on main.

Files with missing lines	Patch %	Lines
cli/src/cmd/app/commands/graph.go	89.18%	3 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #528      +/-   ##
==========================================
+ Coverage   61.78%   61.81%   +0.02%     
==========================================
  Files         224      224              
  Lines       29382    29414      +32     
==========================================
+ Hits        18154    18182      +28     
- Misses       9980     9983       +3     
- Partials     1248     1249       +1     

Flag	Coverage Δ
unittests	61.81% <89.18%> (+0.02%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
cli/src/cmd/app/commands/graph.go	86.81% <89.18%> (+0.05%)	⬆️

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

🚀 Test This PR

A preview build (0.20.0-pr528) is ready for testing!

🌐 Website Preview

Live Preview: https://jongio.github.io/azd-app/pr/528/

One-Line Install (Recommended)

PowerShell (Windows):

iex "& { $(irm https://raw.githubusercontent.com/jongio/azd-app/main/cli/scripts/install-pr.ps1) } -PrNumber 528 -Version 0.20.0-pr528"

Bash (macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/jongio/azd-app/main/cli/scripts/install-pr.sh | bash -s 528 0.20.0-pr528

Uninstall

When you're done testing:

PowerShell (Windows):

iex "& { $(irm https://raw.githubusercontent.com/jongio/azd-app/main/cli/scripts/uninstall-pr.ps1) } -PrNumber 528"

Bash (macOS/Linux):

curl -fsSL https://raw.githubusercontent.com/jongio/azd-app/main/cli/scripts/uninstall-pr.sh | bash -s 528

---

Build Info:

• Version: 0.20.0-pr528
• Commit: 745ced9
• Release: View pre-release

What to Test:
Please review the PR description and test the changes described there.

[wbreza]

Code Review — Approved

Overall assessment: Clean, purely additive change that adds a plantuml output format to azd app graph, faithfully mirroring the existing mermaid, dot, and d2 renderers. No blocking findings.

What was verified

• Wiring is complete and consistent: new graphOutputPlantUML constant, flag help, --help Long text, examples block, validation switch in runGraph, and the renderGraph dispatch are all updated together.
• Renderer follows the established pattern: renderGraphPlantUML reuses mermaidNodeIDs (alias constraints are compatible, and the comment documents why), renders resources as database and services as component — matching how sibling formats distinguish resources — and guards edges with the same okFrom/okTo check.
• Escaping is correct and documented: escapePlantUMLLabel maps " to ' (PlantUML has no escape for a literal quote inside a quoted name) and \n to the \n line-break sequence.
• Tests are adequate: TestRenderGraphPlantUML, TestRenderGraphPlantUMLNoProject, and TestEscapePlantUMLLabel cover the renderer, the empty-project title path, and the escaper.
• No regressions: the updated invalid-format error message does not break TestRunGraphInvalidFormat (it asserts only the invalid output format substring). No documentation drift — there is no graph.md; the --help Long text is the source of truth and was updated.

Severity summary

• Critical: 0 · High: 0 · Medium: 0 · Low: 0

Result: Zero Critical/High/Medium findings — approving.