docs: add mermaid diagram rendering for Astro Starlight site

[Copilot]

Mermaid diagrams in the documentation were rendering as raw code blocks instead of visual diagrams.

Changes

• Added dependencies: astro-mermaid@1.1.0 and mermaid@11.12.1
• Configured integration: Added mermaid() before starlight() in astro.config.mjs (order matters)
• Fixed invalid syntax: Removed style directives from sequenceDiagram in security-architecture.md (style only works in flowcharts)

// astro.config.mjs
import mermaid from 'astro-mermaid';

export default defineConfig({
  integrations: [
    mermaid(),  // Must come before starlight
    starlight({ ... }),
  ],
});

Result

All 8 mermaid diagrams now render properly:

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com//advisories
  • Triggering command: /home/REDACTED/work/_temp/ghcca-node/node/bin/node /home/REDACTED/work/_temp/ghcca-node/node/bin/node --enable-source-maps /home/REDACTED/work/_temp/copilot-developer-action-main/dist/index.js (http block)
• telemetry.astro.build
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/gh-aw-firewall/gh-aw-firewall/docs-site/node_modules/.bin/astro build (dns block)
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/gh-aw-firewall/gh-aw-firewall/docs-site/node_modules/.bin/astro preview --port 4321 (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

Render the mermaid diagram properly in astro documentaiton site. Currently it's not rendered

Custom agent used: technical-doc-writer
AI technical documentation writer for awf library using Astro Starlight

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.