@gala-chain/launchpad-mcp-server 5.0.1-beta.1 → 5.0.1

package/MCP_TEST_ANALYSIS.md

@@ -119,7 +119,7 @@
 
 ---
 
-## DEX (29 tools) - 27 PASS, 2 BUG
+## DEX (29 tools) - 29 PASS
 
 | Tool | Status | Notes |
 |------|--------|-------|

package/dist/generated/version.d.ts

@@ -3,5 +3,5 @@
  * This file is generated by scripts/inject-version.ts during build
  * DO NOT EDIT MANUALLY
  */
-export declare const MCP_SERVER_VERSION = "5.0.1-beta.1";
+export declare const MCP_SERVER_VERSION = "5.0.1";
 //# sourceMappingURL=version.d.ts.map

package/dist/generated/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,iBAAiB,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,kBAAkB,UAAU,CAAC"}

package/dist/generated/version.js

@@ -6,5 +6,5 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MCP_SERVER_VERSION = void 0;
-exports.MCP_SERVER_VERSION = '5.0.1-beta.1';
+exports.MCP_SERVER_VERSION = '5.0.1';
 //# sourceMappingURL=version.js.map

package/dist/generated/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEU,QAAA,kBAAkB,GAAG,cAAc,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/generated/version.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEU,QAAA,kBAAkB,GAAG,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gala-chain/launchpad-mcp-server",
-  "version": "5.0.1-beta.1",
+  "version": "5.0.1",
   "description": "MCP server for Gala Launchpad - 128 tools (pool management, event watchers, GSwap DEX trading, price history, token creation, wallet management, DEX pool discovery, liquidity positions, token locks/burns, locked token queries, composite pool data, cross-chain bridging, wrap/unwrap, key derivation) supporting optional wallet (read-only and full-access modes). Production-grade AI agent integration for Claude Desktop with comprehensive validation and 80%+ test coverage",
   "main": "dist/index.js",
   "bin": {
@@ -18,11 +18,13 @@
     "test:integration:coverage": "jest --config jest.integration.config.js --coverage",
     "test:prompts": "npm run build && node src/scripts/test-all-prompts.ts",
     "test:all": "npm run test && npm run test:integration && npm run test:prompts",
+    "validate:mcp-tests": "tsx scripts/validate-mcp-test-analysis.ts",
+    "prerelease": "npm run validate:mcp-tests && npm run test && npm run typecheck",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src --ext .ts",
     "lint:check": "eslint src --ext .ts",
     "lint:fix": "eslint src --ext .ts --fix",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run validate:mcp-tests && npm run build"
   },
   "keywords": [
     "mcp",
@@ -73,7 +75,7 @@
   "dependencies": {
     "@gala-chain/api": "^2.4.3",
     "@gala-chain/connect": "^2.4.3",
-    "@gala-chain/launchpad-sdk": "5.0.1-beta.1",
+    "@gala-chain/launchpad-sdk": "5.0.1",
     "@humanwhocodes/config-array": "^0.13.0",
     "@modelcontextprotocol/sdk": "^0.5.0",
     "axios": "^1.12.2",

package/scripts/validate-mcp-test-analysis.ts

@@ -0,0 +1,250 @@
+#!/usr/bin/env tsx
+/**
+ * MCP Test Analysis Validator
+ *
+ * This script parses MCP_TEST_ANALYSIS.md and FAILS if:
+ * 1. Any tools are marked as BUG or FAIL
+ * 2. The summary counts don't match the detailed tables
+ * 3. Pass rate is not 100% (excluding CONFIG-REQUIRED)
+ *
+ * Run this BEFORE any release to ensure no known bugs are shipped.
+ *
+ * Usage:
+ *   npm run validate:mcp-tests
+ *   npx tsx scripts/validate-mcp-test-analysis.ts
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+
+interface CategoryStats {
+  name: string;
+  total: number;
+  pass: number;
+  fail: number;
+  skip: number;
+  bug: number;
+  configRequired: number;
+}
+
+interface ValidationResult {
+  success: boolean;
+  errors: string[];
+  warnings: string[];
+  stats: {
+    totalTools: number;
+    totalPass: number;
+    totalFail: number;
+    totalBug: number;
+    totalSkip: number;
+    totalConfigRequired: number;
+    passRate: number;
+  };
+  categories: CategoryStats[];
+}
+
+function parseMarkdownFile(filePath: string): string {
+  if (!fs.existsSync(filePath)) {
+    throw new Error(`MCP_TEST_ANALYSIS.md not found at: ${filePath}`);
+  }
+  return fs.readFileSync(filePath, 'utf-8');
+}
+
+function extractSummaryTable(content: string): CategoryStats[] {
+  const categories: CategoryStats[] = [];
+
+  // Find the summary table
+  const summaryMatch = content.match(/\| Category \| Total \| Pass \| Fail \| Skip \| Config-Required \|[\s\S]*?\n\n/);
+  if (!summaryMatch) {
+    throw new Error('Could not find summary table in MCP_TEST_ANALYSIS.md');
+  }
+
+  const tableLines = summaryMatch[0].split('\n').filter(line => line.startsWith('|') && !line.includes('---'));
+
+  for (const line of tableLines) {
+    // Skip header row
+    if (line.includes('Category') || line.includes('TOTAL')) continue;
+
+    const cells = line.split('|').map(c => c.trim()).filter(Boolean);
+    if (cells.length >= 6) {
+      categories.push({
+        name: cells[0],
+        total: parseInt(cells[1], 10) || 0,
+        pass: parseInt(cells[2], 10) || 0,
+        fail: parseInt(cells[3], 10) || 0,
+        skip: parseInt(cells[4], 10) || 0,
+        bug: 0, // Not in summary table, check details
+        configRequired: parseInt(cells[5], 10) || 0,
+      });
+    }
+  }
+
+  return categories;
+}
+
+function countBugsInContent(content: string): number {
+  // Count explicit BUG markers in tool status column (| BUG | or | **BUG** |)
+  // Must be a standalone cell, not part of narrative text
+  const bugMatches = content.match(/\|\s*\*\*BUG\*\*\s*\||\|\s*BUG\s*\|/g);
+  return bugMatches ? bugMatches.length : 0;
+}
+
+function countFailsInContent(content: string): number {
+  // Count explicit FAIL markers in tool status column (| FAIL | or | **FAIL** |)
+  // Must be a standalone cell, not part of narrative text
+  const failMatches = content.match(/\|\s*\*\*FAIL\*\*\s*\||\|\s*FAIL\s*\|/g);
+  return failMatches ? failMatches.length : 0;
+}
+
+function countSkipsInContent(content: string): number {
+  // Count explicit SKIP markers in tool status column (| SKIP | or | **SKIP** |)
+  // Must be a standalone cell, not part of narrative text
+  const skipMatches = content.match(/\|\s*\*\*SKIP\*\*\s*\||\|\s*SKIP\s*\|/g);
+  return skipMatches ? skipMatches.length : 0;
+}
+
+function checkSectionHeaders(content: string): string[] {
+  const errors: string[] = [];
+
+  // Check for sections that mention BUG counts in headers
+  const sectionHeaders = content.match(/## [A-Z]+ \(\d+ tools?\).*(?:BUG|FAIL)/gi);
+  if (sectionHeaders) {
+    for (const header of sectionHeaders) {
+      errors.push(`Section header indicates bugs: "${header}"`);
+    }
+  }
+
+  return errors;
+}
+
+function validateMcpTestAnalysis(): ValidationResult {
+  const filePath = path.join(__dirname, '..', 'MCP_TEST_ANALYSIS.md');
+  const content = parseMarkdownFile(filePath);
+
+  const errors: string[] = [];
+  const warnings: string[] = [];
+
+  // Parse summary table
+  const categories = extractSummaryTable(content);
+
+  // Count bugs and fails in detail sections
+  const totalBugsInContent = countBugsInContent(content);
+  const totalFailsInContent = countFailsInContent(content);
+  const totalSkipsInContent = countSkipsInContent(content);
+
+  // Check section headers for bug indicators
+  const headerErrors = checkSectionHeaders(content);
+  errors.push(...headerErrors);
+
+  // Calculate totals from summary table
+  const stats = {
+    totalTools: categories.reduce((sum, c) => sum + c.total, 0),
+    totalPass: categories.reduce((sum, c) => sum + c.pass, 0),
+    totalFail: categories.reduce((sum, c) => sum + c.fail, 0) + totalFailsInContent,
+    totalBug: totalBugsInContent,
+    totalSkip: categories.reduce((sum, c) => sum + c.skip, 0) + totalSkipsInContent,
+    totalConfigRequired: categories.reduce((sum, c) => sum + c.configRequired, 0),
+    passRate: 0,
+  };
+
+  // Calculate pass rate (excluding config-required)
+  const testableTools = stats.totalTools - stats.totalConfigRequired;
+  stats.passRate = testableTools > 0 ? (stats.totalPass / testableTools) * 100 : 0;
+
+  // CRITICAL VALIDATION: No bugs allowed!
+  if (stats.totalBug > 0) {
+    errors.push(`RELEASE BLOCKER: ${stats.totalBug} tool(s) marked as BUG - fix before release!`);
+  }
+
+  // CRITICAL VALIDATION: No fails allowed!
+  if (stats.totalFail > 0) {
+    errors.push(`RELEASE BLOCKER: ${stats.totalFail} tool(s) marked as FAIL - fix before release!`);
+  }
+
+  // WARNING: Skips should be documented
+  if (stats.totalSkip > 0) {
+    warnings.push(`${stats.totalSkip} tool(s) marked as SKIP - ensure these are intentionally skipped`);
+  }
+
+  // CRITICAL VALIDATION: Pass rate must be 100%
+  if (stats.passRate < 100 && testableTools > 0) {
+    errors.push(`RELEASE BLOCKER: Pass rate is ${stats.passRate.toFixed(1)}%, must be 100%`);
+  }
+
+  // Check for inconsistencies between summary and content
+  const contentPassCount = (content.match(/\|\s*PASS\s*\|/gi) || []).length;
+  if (Math.abs(contentPassCount - stats.totalPass) > 5) { // Allow some tolerance for PASS in notes
+    warnings.push(`Potential inconsistency: Summary shows ${stats.totalPass} PASS, content has ~${contentPassCount} PASS markers`);
+  }
+
+  return {
+    success: errors.length === 0,
+    errors,
+    warnings,
+    stats,
+    categories,
+  };
+}
+
+// Main execution
+function main(): void {
+  console.log('');
+  console.log('========================================');
+  console.log('  MCP Test Analysis Validator');
+  console.log('  Release Gate Check');
+  console.log('========================================');
+  console.log('');
+
+  try {
+    const result = validateMcpTestAnalysis();
+
+    // Print stats
+    console.log('Summary:');
+    console.log(`  Total Tools:      ${result.stats.totalTools}`);
+    console.log(`  Pass:             ${result.stats.totalPass}`);
+    console.log(`  Fail:             ${result.stats.totalFail}`);
+    console.log(`  Bug:              ${result.stats.totalBug}`);
+    console.log(`  Skip:             ${result.stats.totalSkip}`);
+    console.log(`  Config-Required:  ${result.stats.totalConfigRequired}`);
+    console.log(`  Pass Rate:        ${result.stats.passRate.toFixed(1)}%`);
+    console.log('');
+
+    // Print warnings
+    if (result.warnings.length > 0) {
+      console.log('Warnings:');
+      for (const warning of result.warnings) {
+        console.log(`  - ${warning}`);
+      }
+      console.log('');
+    }
+
+    // Print errors
+    if (result.errors.length > 0) {
+      console.log('ERRORS (RELEASE BLOCKED):');
+      for (const error of result.errors) {
+        console.log(`  - ${error}`);
+      }
+      console.log('');
+    }
+
+    // Final result
+    if (result.success) {
+      console.log('========================================');
+      console.log('  VALIDATION PASSED');
+      console.log('  No known bugs - safe to release!');
+      console.log('========================================');
+      process.exit(0);
+    } else {
+      console.log('========================================');
+      console.log('  VALIDATION FAILED');
+      console.log('  DO NOT RELEASE WITH KNOWN BUGS!');
+      console.log('========================================');
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error('Validation error:', error);
+    process.exit(1);
+  }
+}
+
+main();