revert: remove @description injection from fetch script

The @description injection is not needed since we're keeping the
generated schemas as reference and using manual types.ts for production.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: ochafik

scripts/fetch-spec-types.ts

@@ -1,11 +1,3 @@
-/**
- * Fetches the MCP specification types from the official repository and
- * post-processes them to add @description JSDoc tags for Zod schema generation.
- *
- * The spec uses multiline JSDoc comments where the first paragraph is the description.
- * ts-to-zod requires explicit @description tags to generate .describe() calls in schemas.
- * This script automatically converts the first paragraph to a @description tag.
- */
 import { writeFileSync } from 'node:fs';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -45,128 +37,6 @@ async function fetchSpecTypes(sha: string): Promise<string> {
     return await response.text();
 }
 
-/**
- * Injects @description tags into JSDoc comments that don't already have them.
- *
- * Converts:
- * ```
- * /**
- *  * A progress token, used to associate progress notifications.
- *  *
- *  * @category Common Types
- *  *\/
- * ```
- *
- * To:
- * ```
- * /**
- *  * A progress token, used to associate progress notifications.
- *  *
- *  * @description A progress token, used to associate progress notifications.
- *  * @category Common Types
- *  *\/
- * ```
- */
-function injectDescriptionTags(content: string): string {
-    // Match JSDoc comments: /** ... */
-    const jsdocPattern = /\/\*\*[\s\S]*?\*\//g;
-
-    return content.replace(jsdocPattern, (comment) => {
-        // Skip if already has @description
-        if (/@description\s/.test(comment)) {
-            return comment;
-        }
-
-        // Skip single-line comments like /** @internal */
-        if (!comment.includes('\n')) {
-            return comment;
-        }
-
-        // Extract the description: text after /** and before any @tag or empty line
-        // Split into lines for processing
-        const lines = comment.split('\n');
-
-        // Find description lines (between /** and first @tag or blank line)
-        const descLines: string[] = [];
-        let foundDescContent = false;
-        let firstTagIndex = -1;
-
-        for (let i = 0; i < lines.length; i++) {
-            const line = lines[i];
-            // Clean the line: remove leading *, spaces
-            const cleaned = line.replace(/^\s*\*\s?/, '').trim();
-
-            // Skip the opening /**
-            if (line.includes('/**')) {
-                // Check if there's content after /**
-                const afterOpening = line.replace(/.*\/\*\*\s*/, '').trim();
-                if (afterOpening && !afterOpening.startsWith('@') && afterOpening !== '*') {
-                    descLines.push(afterOpening);
-                    foundDescContent = true;
-                }
-                continue;
-            }
-
-            // Skip the closing */
-            if (cleaned === '/' || line.includes('*/')) {
-                continue;
-            }
-
-            // Stop at first @tag
-            if (cleaned.startsWith('@')) {
-                firstTagIndex = i;
-                break;
-            }
-
-            // Stop at empty line (paragraph break)
-            if (cleaned === '') {
-                if (foundDescContent) {
-                    firstTagIndex = i;
-                    break;
-                }
-                continue;
-            }
-
-            // Accumulate description content
-            descLines.push(cleaned);
-            foundDescContent = true;
-        }
-
-        // No description found or no @tag to insert before
-        if (descLines.length === 0) {
-            return comment;
-        }
-
-        // Join description into a single line (for @description tag)
-        const description = descLines.join(' ').trim();
-
-        // Skip very short or empty descriptions
-        if (description.length < 5) {
-            return comment;
-        }
-
-        // Find where to insert the @description tag
-        // Insert before the first @tag, or before the closing */
-        if (firstTagIndex === -1) {
-            // No @tag found, insert before */
-            const closingIndex = lines.findIndex(l => l.includes('*/'));
-            if (closingIndex === -1) return comment;
-            firstTagIndex = closingIndex;
-        }
-
-        // Insert @description tag
-        // Get the indentation from the next line, ensuring proper " * " prefix
-        const lineMatch = lines[firstTagIndex].match(/^(\s*\*)/);
-        const indent = lineMatch ? lineMatch[1] + ' ' : ' * ';
-        const descriptionLine = `${indent}@description ${description}`;
-
-        // Insert the description line
-        lines.splice(firstTagIndex, 0, descriptionLine);
-
-        return lines.join('\n');
-    });
-}
-
 async function main() {
     try {
         // Check if SHA is provided as command line argument
@@ -183,11 +53,7 @@ async function main() {
 
         console.log(`Fetching spec.types.ts from commit: ${latestSHA}`);
 
-        let specContent = await fetchSpecTypes(latestSHA);
-
-        // Inject @description tags for ts-to-zod schema generation
-        console.log('Injecting @description tags for Zod schema generation...');
-        specContent = injectDescriptionTags(specContent);
+        const specContent = await fetchSpecTypes(latestSHA);
 
         // Read header template
         const headerTemplate = `/**
@@ -197,9 +63,6 @@ async function main() {
  * Pulled from: https://raw.githubusercontent.com/modelcontextprotocol/modelcontextprotocol/main/schema/draft/schema.ts
  * Last updated from commit: {SHA}
  *
- * Post-processed to add @description JSDoc tags for Zod schema generation.
- * These tags are automatically extracted from the first paragraph of each JSDoc comment.
- *
  * DO NOT EDIT THIS FILE MANUALLY. Changes will be overwritten by automated updates.
  * To update this file, run: npm run fetch:spec-types
  */`;