feat: add embedded documentation generation for AI agents

[nicknisi]

Summary

• Adds scripts/generate-docs.ts to generate machine-readable documentation for AI coding agents
• Generates artifacts in dist/docs/ during build via postbuild hook

Output Structure

dist/docs/
├── SKILL.md           # Entry point with YAML frontmatter
├── README.md          # Navigation overview
├── SOURCE_MAP.json    # Export → file → line number mapping (29 exports, 14 interfaces)
└── topics/
    ├── 01-getting-started.md
    ├── 02-setup.md
    ├── 03-middleware.md
    ├── 04-client-components.md
    ├── 05-session-management.md
    └── 06-api-reference.md

Notes

This follows the embedded docs pattern from Mastra. The docs are generated but discovery requires either:

• An MCP server that knows to look for dist/docs/
• Manual reference in consumer projects
• Future tooling adoption of this convention
• A custom skill that knows where to look