Add daily documentation sync from gh-aw repository

[Copilot]

The MCP Gateway specification lives in the githubnext/gh-aw repository (as Astro documentation), but this repository needs a local markdown copy for offline reference and reduced external dependencies.

Changes

• Sync script (scripts/sync-docs.sh): Fetches mcp-gateway.md from gh-aw, strips Astro frontmatter, adds source attribution
• Daily workflow (.github/workflows/sync-docs.yml): Scheduled sync at 2:00 AM UTC, creates PR when changes detected
• Documentation (docs/mcp-gateway.md): Full specification synced from gh-aw (1,416 lines)
• Updated references: README.md and AGENTS.md now link to local docs instead of gh-aw URLs

Implementation details

The sync script is idempotent and adds this notice to synced docs:

> **Note**: This documentation is automatically synced from the [githubnext/gh-aw repository](https://github.com/githubnext/gh-aw/blob/main/docs/src/content/docs/reference/mcp-gateway.md) daily. 
> The official specification is maintained in the gh-aw project and is the authoritative source for compliance testing.

Manual sync: ./scripts/sync-docs.sh

Existing documentation (DIFC_INTEGRATION_PROPOSAL.md, HTTP_BACKEND_SESSION_ID.md) remains unchanged.

Original prompt

Import and adapt daily documentation updated from githubnext/gh-aw

• there is no astro here, just markdown files in /docs

---

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

[pelikhan]

@copilot import technical doc writer as well (optimized for flat markdown docs)

[Copilot]

@copilot import technical doc writer as well (optimized for flat markdown docs)

Are you asking me to also sync the markdown.md guide from gh-aw (the guide for writing effective workflow markdown instructions)? Or is there a different technical doc writer guide you'd like me to import?

I found docs/src/content/docs/reference/markdown.md in gh-aw which contains guidelines for writing effective agentic workflow documentation. Should I add this to the sync script?

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/repos/githubnext/gh-aw/contents/docs/src/content/docs
  • Triggering command: /usr/bin/curl curl -fsSL REDACTED (http 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)