feat(core): support resource-scoped custom docs grouped by type

[thorthelegend99]

Summary

Adds v1 support for resource-scoped custom docs under resource folders (e.g. domains/<id>/docs/**) with sidebar grouping by type.

What shipped

• New resourceDocs Astro content collection
  • Scans docs under resource folders for:
    • domains, services, events, commands, queries, flows, channels, entities, containers, data-products
  • Requires frontmatter: id, version, type
• New utility layer: resource-docs.ts
  • Resolves resource ownership by file path
  • Builds grouped docs by type
  • Uses first-match behavior for duplicate collisions
• New resource docs route:
  • /docs/:type/:id/:version/docs/:docType/:docId/:docVersion
• Sidebar integration
  • Adds grouped custom-doc sections (group title = type) on resource pages in left nav
• Included changeset for @eventcatalog/core

Notes

• No search indexing yet (intentional)
• No generator/SDK support yet (intentional)

Validation

• pnpm --filter @eventcatalog/core format
• pnpm --filter @eventcatalog/core check (0 errors)

[changeset-bot]

🦋 Changeset detected

Latest commit: 3269ae6

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@eventcatalog/core	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[CLAassistant]

All committers have signed the CLA.

[boyney123]

Be good to add support for our [[]] syntax in the docs to highlight docs etc.