@the_cfdude/productboard-mcp/scripts/extract-docs.ts

Model Context Protocol server for Productboard REST API with dynamic tool loading

#!/usr/bin/env node
/**
 * Extracts compressed documentation during build
 */
import fs from 'fs';
import path from 'path';
import { fileURLToPath } from 'url';
import * as tar from 'tar';

const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);

async function extractDocs() {
  const docsArchive = path.join(__dirname, '..', 'tool-docs.tar.gz');
  const outputDir = path.join(__dirname, '..', 'generated');

  // Check if archive exists
  if (!fs.existsSync(docsArchive)) {
    console.log(
      '⚠️  No tool-docs.tar.gz found. Run npm run generate-docs first.'
    );
    return;
  }

  // Create generated directory (clean it first if it exists)
  if (fs.existsSync(outputDir)) {
    // Remove only the documentation directories, preserve manifest.json and other files
    const items = fs.readdirSync(outputDir);
    items.forEach(item => {
      const itemPath = path.join(outputDir, item);
      if (fs.statSync(itemPath).isDirectory() && item !== 'tools') {
        fs.rmSync(itemPath, { recursive: true });
      } else if (item === 'README.md') {
        fs.unlinkSync(itemPath);
      }
    });
  } else {
    fs.mkdirSync(outputDir, { recursive: true });
  }

  console.log('📦 Extracting documentation...');

  try {
    // Extract archive
    await tar.extract({
      file: docsArchive,
      cwd: outputDir,
    });

    // Move contents up one level (from generated/tool-docs to generated/)
    const extractedDir = path.join(outputDir, 'tool-docs');
    if (fs.existsSync(extractedDir)) {
      const items = fs.readdirSync(extractedDir);
      items.forEach(item => {
        const src = path.join(extractedDir, item);
        const dest = path.join(outputDir, item);
        fs.renameSync(src, dest);
      });
      fs.rmdirSync(extractedDir);
    }

    console.log('✅ Documentation extracted to generated/');

    // Compile TypeScript documentation to JavaScript if it exists
    const tsDocPath = path.join(outputDir, 'tool-documentation.ts');
    const jsDocPath = path.join(outputDir, 'tool-documentation.js');

    if (fs.existsSync(tsDocPath)) {
      console.log('📝 Compiling documentation TypeScript to JavaScript...');
      const { execSync } = await import('child_process');
      try {
        execSync(
          `npx tsc "${tsDocPath}" --module esnext --target es2022 --moduleResolution node`,
          {
            stdio: 'inherit',
          }
        );
        console.log('✅ Documentation compiled to JavaScript');
      } catch (compileError) {
        console.error('❌ Failed to compile documentation:', compileError);
        // Create a minimal JS file if compilation fails
        fs.writeFileSync(
          jsDocPath,
          'export const generatedToolDocumentation = {};\n'
        );
      }
    }
  } catch (error) {
    console.error('❌ Failed to extract documentation:', error);
    process.exit(1);
  }
}

extractDocs().catch(console.error);