chore: add improvements to MCP based on astryx library [AR-74236]

Author: mmurawski-dn

.changeset/mcp-manifest-quality.md

@@ -0,0 +1,6 @@
+---
+'@drivenets/design-system-mcp': patch
+'@drivenets/design-system': patch
+---
+
+Post process MCP data for better quality output.

docs/adr/0005-mcp-manifest-enrichment.md

@@ -0,0 +1,5 @@
+# MCP documentation from enriched Storybook manifests
+
+Agent docs are the published Storybook `components.json` after a post-build enricher, served through the existing three MCP tools.
+We post-process (and optionally overlay `ds-{name}.mcp.ts`) instead of adding tools, a second docs system, or generated consumer files.
+Guidelines MDX stays for humans; MCP instructions inline token, spacing, and layout rules and send agents to the component first.

knip.json

@@ -6,6 +6,7 @@
 		"./packages/design-system/**/*.figma.batch.ts",
 		"./packages/design-system/types/**/figma.d.ts",
 		"./packages/design-system/src/components/ds-file-upload/stories/adapters/simple-file-upload-adapter.ts",
+		"./packages/design-system/**/*.mcp.ts",
 		"./packages/eslint-plugin-internal/src/rules/__tests__/fixtures/*.ts"
 	],
 	"ignoreExportsUsedInFile": {

packages/design-system/package.json

@@ -29,7 +29,8 @@
 		"!**/__tests__",
 		"!./src/**/*.d.ts",
 		"!**/stories",
-		"!**/*.stories.*"
+		"!**/*.stories.*",
+		"!**/*.mcp.ts"
 	],
 	"repository": {
 		"url": "https://github.com/drivenets/design-system",
@@ -54,7 +55,7 @@
 		"test:storybook-docs": "vitest --project=storybook-docs",
 		"build": "tsdown",
 		"build:watch": "pnpm build --watch",
-		"build:storybook": "storybook build"
+		"build:storybook": "storybook build && node --experimental-strip-types scripts/enrich-mcp-manifest.ts"
 	},
 	"dependencies": {
 		"@ark-ui/react": "^5.37.2",