@gala-chain/launchpad-mcp-server 5.0.3 → 5.0.4-beta.0

package/MCP_TEST_ANALYSIS.md

@@ -1,317 +0,0 @@
-# MCP Tool Test Analysis
-
-**Last Updated:** 2025-12-09 (v5.0.0)
-**Total Tools:** 132
-**Environment:** STAGE
-**SDK Version:** 5.0.0
-**MCP Version:** 5.0.0
-
-## Summary
-
-| Category | Total | Pass | Fail | Skip | Config-Required |
-|----------|-------|------|------|------|-----------------|
-| utilities | 19 | 19 | 0 | 0 | 0 |
-| pools | 19 | 19 | 0 | 0 | 0 |
-| balance | 12 | 12 | 0 | 0 | 0 |
-| trading | 13 | 13 | 0 | 0 | 0 |
-| dex | 29 | 29 | 0 | 0 | 0 |
-| creation | 4 | 4 | 0 | 0 | 0 |
-| transfers | 2 | 2 | 0 | 0 | 0 |
-| locks | 3 | 3 | 0 | 0 | 0 |
-| bridge | 31 | 30 | 0 | 0 | 1 |
-| **TOTAL** | **132** | **131** | **0** | **0** | **1** |
-
-**Coverage: 100%** (132/132 tools accounted for)
-**Pass Rate: 100%** (131/131 testable tools passed)
-
----
-
-## UTILITIES (19 tools) - 19 PASS
-
-| Tool | Status | Notes |
-|------|--------|-------|
-| `gala_launchpad_get_config` | PASS | Returns environment, URLs, slippage settings, **gasFee: "1"** |
-| `gala_launchpad_get_version` | PASS | Returns SDK 5.0.0 and MCP 5.0.0 |
-| `gala_launchpad_get_environment` | PASS | Returns current environment |
-| `gala_launchpad_switch_environment` | PASS | Switches between production/development/testing |
-| `gala_launchpad_has_wallet` | PASS | Returns true if wallet configured |
-| `gala_launchpad_get_wallet` | PASS | Returns wallet info |
-| `gala_launchpad_get_address` | PASS | Returns GalaChain format `eth\|{hex}` |
-| `gala_launchpad_get_ethereum_address` | PASS | Returns `0x{hex}` format |
-| `gala_launchpad_set_wallet` | PASS | Sets new wallet from private key |
-| `gala_launchpad_create_wallet` | PASS | Creates random wallet with private key |
-| `gala_launchpad_get_public_key_from_private_key` | PASS | Derives public key (compressed + uncompressed) |
-| `gala_launchpad_get_ethereum_address_from_private_key` | PASS | Derives Ethereum address from private key |
-| `gala_launchpad_get_cache_info` | PASS | Returns cache stats |
-| `gala_launchpad_clear_cache` | PASS | Clears token metadata cache |
-| `gala_launchpad_cleanup` | PASS | Cleans up SDK resources |
-| `gala_launchpad_is_token_graduated` | PASS | Returns boolean for graduation status |
-| `gala_launchpad_get_url_by_token_name` | PASS | Returns launchpad URL |
-| `gala_launchpad_explain_sdk_usage` | PASS | Returns SDK usage examples for 37 topics |
-| `gala_launchpad_create_solana_wallet` | PASS | Creates random Solana keypair |
-
----
-
-## POOLS (19 tools) - 19 PASS
-
-| Tool | Status | Notes |
-|------|--------|-------|
-| `gala_launchpad_fetch_pools` | PASS | Returns paginated pool list |
-| `gala_launchpad_fetch_all_pools` | PASS | Returns all pools with auto-pagination |
-| `gala_launchpad_fetch_pool_details` | PASS | Returns detailed pool info |
-| `gala_launchpad_fetch_pool_details_for_calculation` | PASS | Returns optimized pool data for calculations |
-| `gala_launchpad_fetch_token_details` | PASS | Returns DEX token metadata |
-| `gala_launchpad_fetch_token_distribution` | PASS | Returns holder distribution |
-| `gala_launchpad_fetch_token_badges` | PASS | Returns achievement badges |
-| `gala_launchpad_fetch_volume_data` | PASS | Returns OHLCV candlestick data |
-| `gala_launchpad_fetch_token_spot_price` | PASS | Returns USD spot price with smart routing |
-| `gala_launchpad_fetch_gala_spot_price` | PASS | Returns GALA USD price |
-| `gala_launchpad_fetch_launchpad_token_spot_price` | PASS | Returns launchpad token USD price (deprecated) |
-| `gala_launchpad_fetch_price_history` | PASS | Returns historical price snapshots |
-| `gala_launchpad_fetch_all_price_history` | PASS | Returns all price history with auto-pagination |
-| `gala_launchpad_check_token_name` | PASS | Checks token name availability |
-| `gala_launchpad_check_token_symbol` | PASS | Checks token symbol availability |
-| `gala_launchpad_resolve_vault_address` | PASS | Returns GalaChain vault address |
-| `gala_launchpad_resolve_token_class_key` | PASS | Returns TokenClassKey for token |
-| `gala_launchpad_on_dex_pool_creation` | PASS | Watcher - detects DEX pool creation events |
-| `gala_launchpad_on_launchpad_token_creation` | PASS | Watcher - detects token launch events |
-
----
-
-## BALANCE (12 tools) - 12 PASS
-
-| Tool | Status | Notes |
-|------|--------|-------|
-| `gala_launchpad_fetch_gala_balance` | PASS | Returns GALA balance |
-| `gala_launchpad_fetch_token_balance` | PASS | Returns specific token balance |
-| `gala_launchpad_fetch_locked_tokens` | PASS | Returns lock details with lockedQuantity and lockedHolds array |
-| `gala_launchpad_fetch_tokens_held` | PASS | Returns tokens held with filtering |
-| `gala_launchpad_fetch_tokens_created` | PASS | Returns tokens created by address |
-| `gala_launchpad_fetch_profile` | PASS | Returns user profile data |
-| `gala_launchpad_update_profile` | PASS | Write operation - updates profile data |
-| `gala_launchpad_fetch_referral_url` | PASS | Returns user's unique referral URL |
-| `gala_launchpad_fetch_referrals` | PASS | Returns paginated list of referred users |
-| `gala_launchpad_fetch_all_referrals` | PASS | Returns all referrals with auto-pagination |
-| `gala_launchpad_fetch_referrals_summary` | PASS | Returns referral count and reward totals (day/month/total) |
-| `gala_launchpad_register_account` | PASS | Registers wallet for trading, returns { exists, walletAlias } |
-
----
-
-## TRADING (13 tools) - 13 PASS
-
-| Tool | Status | Notes |
-|------|--------|-------|
-| `gala_launchpad_calculate_buy_amount` | PASS | Calculates buy amount with fees |
-| `gala_launchpad_calculate_buy_amount_local` | PASS | Local bonding curve calculation |
-| `gala_launchpad_calculate_buy_amount_external` | PASS | External GalaChain calculation |
-| `gala_launchpad_calculate_sell_amount` | PASS | Calculates sell amount with fees |
-| `gala_launchpad_calculate_sell_amount_local` | PASS | Local sell calculation |
-| `gala_launchpad_calculate_sell_amount_external` | PASS | External sell calculation |
-| `gala_launchpad_calculate_initial_buy` | PASS | Pre-mint phase calculation |
-| `gala_launchpad_calculate_buy_amount_for_graduation` | PASS | Graduation cost calculation |
-| `gala_launchpad_buy_tokens` | PASS | Write operation - executes token purchase |
-| `gala_launchpad_sell_tokens` | PASS | Write operation - executes token sale |
-| `gala_launchpad_graduate_token` | **PASS** | **v5.0.0 MILESTONE** - Full graduation tested! |
-| `gala_launchpad_fetch_trades` | PASS | Returns trade history |
-| `gala_launchpad_get_bundler_transaction_result` | PASS | Returns transaction status |
-
-**v5.0.0 Milestone:** `graduate_token` was previously SKIP (irreversible), now **PASS** - successfully graduated token "qatestnine" on STAGE.
-
----
-
-## DEX (29 tools) - 29 PASS
-
-| Tool | Status | Notes |
-|------|--------|-------|
-| `gala_launchpad_fetch_dex_pools` | PASS | Returns paginated DEX pools (268 pools) |
-| `gala_launchpad_fetch_all_dex_pools` | PASS | Returns all DEX pools with auto-pagination |
-| `gala_launchpad_get_swap_quote_exact_input` | PASS | Quote for exact input amount |
-| `gala_launchpad_get_swap_quote_exact_output` | PASS | Quote for exact output amount |
-| `gala_launchpad_execute_swap` | PASS | Write operation - executes DEX swap (10 GALA → 6.5 ETIME) |
-| `gala_launchpad_get_swap_user_assets` | PASS | Returns wallet token assets with rich metadata |
-| `gala_launchpad_get_all_swap_user_assets` | PASS | Returns all wallet assets with auto-pagination |
-| `gala_launchpad_fetch_available_dex_tokens` | PASS | Paginated token discovery (no wallet required) |
-| `gala_launchpad_fetch_all_available_dex_tokens` | PASS | Auto-paginated token discovery |
-| `gala_launchpad_get_swap_pool_info` | PASS | Returns pool liquidity and fee tiers |
-| `gala_launchpad_get_swap_pool_price` | PASS | Returns pool price/tick/liquidity |
-| `gala_launchpad_fetch_composite_pool_data` | PASS | Returns complete pool state for offline calculations |
-| `gala_launchpad_calculate_dex_pool_quote_local` | PASS | Local DEX quote calculation |
-| `gala_launchpad_calculate_dex_pool_quote_external` | PASS | External DEX quote from GalaChain |
-| `gala_launchpad_get_user_liquidity_positions` | PASS | Returns user's LP positions |
-| `gala_launchpad_get_all_user_liquidity_positions` | PASS | Returns all LP positions with auto-pagination |
-| `gala_launchpad_get_liquidity_position` | PASS | Returns specific position by tick range |
-| `gala_launchpad_get_liquidity_position_by_id` | PASS | Returns position by ID |
-| `gala_launchpad_fetch_swap_position_direct` | PASS | Direct position lookup by compound key |
-| `gala_launchpad_estimate_remove_liquidity` | PASS | Estimates tokens/fees on removal |
-| `gala_launchpad_add_liquidity_by_price` | PASS | Write operation - adds liquidity by price range |
-| `gala_launchpad_add_liquidity_by_ticks` | PASS | Write operation - adds liquidity with tick boundaries |
-| `gala_launchpad_remove_liquidity` | PASS | Write operation - removes liquidity from position |
-| `gala_launchpad_collect_position_fees` | PASS | Write operation - collects accumulated fees |
-| `gala_launchpad_fetch_all_dex_seasons` | PASS | Returns all leaderboard seasons |
-| `gala_launchpad_fetch_current_dex_season` | PASS | Returns current active season |
-| `gala_launchpad_fetch_dex_leaderboard_by_season_id` | PASS | Returns leaderboard by season (100 entries) |
-| `gala_launchpad_fetch_current_dex_leaderboard` | PASS | Returns current leaderboard |
-| `gala_launchpad_fetch_dex_aggregated_volume_summary` | PASS | Returns 1d/7d/30d volume metrics |
-
----
-
-## CREATION (4 tools) - 4 PASS
-
-| Tool | Status | Notes |
-|------|--------|-------|
-| `gala_launchpad_launch_token` | PASS | Write operation - created "mcpv5test" (MVTX) |
-| `gala_launchpad_upload_token_image` | PASS | Write operation - uploads token image to CDN |
-| `gala_launchpad_upload_profile_image` | PASS | Write operation - uploads profile image to CDN |
-| `gala_launchpad_fetch_launch_token_fee` | PASS | Returns 0.001 GALA fee |
-
----
-
-## TRANSFERS (2 tools) - 2 PASS
-
-| Tool | Status | Notes |
-|------|--------|-------|
-| `gala_launchpad_transfer_gala` | PASS | Write operation - transfers GALA |
-| `gala_launchpad_transfer_token` | PASS | Write operation - transfers launchpad tokens (10 ANIME) |
-
----
-
-## LOCKS (3 tools) - 3 PASS
-
-| Tool | Status | Notes |
-|------|--------|-------|
-| `gala_launchpad_lock_tokens` | PASS | Batch lock operation - locked 100 ANIME |
-| `gala_launchpad_unlock_tokens` | PASS | Batch unlock operation - unlocked 50 ANIME |
-| `gala_launchpad_burn_tokens` | PASS | Permanently destroy tokens - burned 5 ANIME (IRREVERSIBLE!) |
-
-**Batch API (v4.0.22+):**
-```typescript
-await sdk.lockTokens({ tokens: [{ tokenName: 'anime', amount: '100' }] });
-await sdk.unlockTokens({ tokens: [{ tokenName: 'anime', amount: '50' }] });
-await sdk.burnTokens({ tokens: [{ tokenName: 'anime', amount: '5' }] });
-```
-
----
-
-## BRIDGE (31 tools) - 30 PASS, 1 CONFIG-REQUIRED
-
-| Tool | Status | Notes |
-|------|--------|-------|
-| `gala_launchpad_get_supported_bridge_tokens` | PASS | Returns 6 tokens: GALA, GWETH, GUSDC, GUSDT, GWBTC, GSOL |
-| `gala_launchpad_estimate_bridge_fee` | PASS | Ethereum: 0.06 GALA, Solana: 38.28 GALA |
-| `gala_launchpad_get_bridge_status` | PASS | Returns bridge transaction status |
-| `gala_launchpad_bridge_out` | PASS | GalaChain → Ethereum/Solana (both tested!) |
-| `gala_launchpad_bridge_in` | PASS | Ethereum/Solana → GalaChain (both tested!) |
-| `gala_launchpad_fetch_ethereum_wallet_native_balance` | PASS | Returns ETH balance (2.55 ETH) |
-| `gala_launchpad_fetch_ethereum_wallet_token_balance` | PASS | Returns ERC-20 balance (38 GALA) |
-| `gala_launchpad_fetch_ethereum_wallet_all_balances` | PASS | Returns ETH + all ERC-20s |
-| `gala_launchpad_get_ethereum_transaction_status` | PASS | Returns Ethereum tx status |
-| `gala_launchpad_fetch_solana_wallet_native_balance` | PASS | Returns SOL balance (0.699 SOL) |
-| `gala_launchpad_fetch_solana_wallet_token_balance` | PASS | Returns SPL token balance (85 GALA) |
-| `gala_launchpad_fetch_solana_wallet_all_balances` | PASS | Returns SOL + all SPL tokens |
-| `gala_launchpad_get_solana_transaction_status` | PASS | Returns Solana tx status |
-| `gala_launchpad_create_solana_wallet` | PASS | Creates random Solana keypair |
-| `gala_launchpad_request_solana_devnet_airdrop` | CONFIG | Rate limited (1 SOL/day) - not a bug |
-| `gala_launchpad_fetch_bridgeable_tokens_by_network` | PASS | Paginated bridgeable token discovery |
-| `gala_launchpad_fetch_all_bridgeable_tokens_by_network` | PASS | Auto-paginated with caching (ETH: 33, SOL: 16) |
-| `gala_launchpad_fetch_all_tokens_bridgeable_to_ethereum` | PASS | Returns 33 Ethereum-bridgeable tokens |
-| `gala_launchpad_fetch_all_tokens_bridgeable_to_solana` | PASS | Returns 16 Solana-bridgeable tokens |
-| `gala_launchpad_is_token_bridgeable_to_network` | PASS | Boolean check with contract address |
-| `gala_launchpad_is_token_bridgeable_to_ethereum` | PASS | Returns Ethereum contract address |
-| `gala_launchpad_is_token_bridgeable_to_solana` | PASS | Returns Solana mint address |
-| `gala_launchpad_fetch_wrappable_tokens` | PASS | Paginated wrappable token pairs (2 tokens) |
-| `gala_launchpad_fetch_all_wrappable_tokens` | PASS | Auto-paginated with caching |
-| `gala_launchpad_get_wrappable_token` | PASS | Lookup by tokenId |
-| `gala_launchpad_get_wrap_counterpart` | PASS | MUSIC → GMUSIC, GMUSIC → MUSIC |
-| `gala_launchpad_is_token_wrappable` | PASS | Boolean check with counterpart info |
-| `gala_launchpad_wrap_token` | PASS | Wrapped 1 MUSIC → GMUSIC |
-| `gala_launchpad_unwrap_token` | PASS | Unwrapped 1 GMUSIC → MUSIC |
-| `gala_launchpad_estimate_wrap_fee` | PASS | Returns 0 GALA fee |
-| `gala_launchpad_estimate_unwrap_fee` | PASS | Returns 0 GALA fee |
-| `gala_launchpad_get_wrap_status` | PASS | Returns wrap/unwrap transaction status |
-
----
-
-## Notes
-
-### v5.0.0 Breaking Changes
-- **Token symbol validation**: Must be UPPERCASE letters only (no numbers)
-- **tokenId format required**: Bare token symbols rejected, use `Collection|Category|Type|AdditionalKey` format
-- See SDK README for migration guide
-
-### Bridge Operations
-- **Ethereum:** Full support - bridge_out and bridge_in both work
-- **Solana:** Full support - bridge_out and bridge_in both work
-- **Wrap/Unwrap:** MUSIC ↔ GMUSIC working (cross-channel bridge within GalaChain)
-- **Custom RPC:** Supports `ethereumRpcUrl` and `solanaRpcUrl` config options
-
-### Known Issues
-- `request_solana_devnet_airdrop`: Rate limited to 1 SOL/day - this is devnet behavior, not a bug
-
-### Fixed Issues (SDK 5.0.1)
-- **FIXED:** `remove_liquidity` / `collect_position_fees` pagination bug - Position lookup now uses auto-pagination to find positions beyond page 1 (previously limited to first 10 positions)
-
-### DEX Token Format
-DEX pool operations require full token class key format: `GALA|Unit|none|none` (not just "GALA")
-
----
-
-## Change History
-
-| Version | Date | Changes |
-|---------|------|---------|
-| **v5.0.0** | **2025-12-09** | **MAJOR RELEASE** - Full comprehensive test with ALL write ops including graduation! |
-| v4.0.22-beta.5 | 2025-12-09 | Added 4 tools: `register_account`, `fetch_referrals`, `fetch_all_referrals`, `fetch_referrals_summary` (132 tools) |
-| v4.0.22-beta.2 | 2025-12-09 | `get_config` returns `gasFee: "1"` |
-| v4.0.22-beta.1 | 2025-12-09 | Batch lock/unlock + burn_tokens (128 tools) |
-| v4.0.20-beta.2 | 2025-12-09 | `bridge_in` from Solana fixed with retry logic |
-| v4.0.20-beta.1 | 2025-12-09 | Custom RPC URL support, Helius RPC fixes Solana queries |
-| v4.0.20-beta.0 | 2025-12-08 | Wrap/unwrap execution working, `get_bridge_status` fixed |
-| v4.0.17-beta.6 | 2025-12-08 | 5 wrappable token discovery tools |
-| v4.0.17-beta.1 | 2025-12-07 | Solana balance queries working, bridge_out tested |
-| v4.0.15-beta.2 | 2025-12-06 | Key derivation + bridgeable token queries (112 tools) |
-| v4.0.7-beta.7 | 2025-12-05 | Fixed `estimate_bridge_fee` URL |
-| v4.0.7-beta.6 | 2025-12-05 | 11 bridge tools for cross-chain operations |
-
----
-
-## v5.0.0 Test Highlights
-
-### Write Operations Tested
-
-| Operation | Tool | Transaction/Result |
-|-----------|------|-------------------|
-| Token Graduation | `graduate_token` | ✅ Graduated "qatestnine" to DEX |
-| DEX Swap | `execute_swap` | TX: `2a4a40ad-4fc6-4e47-a7ed-0ba3bb587f47` (10 GALA → 6.5 ETIME) |
-| Add Liquidity (Price) | `add_liquidity_by_price` | TX: `89870d26-ef4f-4377-a21a-0c8cbfbe7bfa` |
-| Add Liquidity (Ticks) | `add_liquidity_by_ticks` | TX: `b4f24f6d-fd8a-455b-aa7d-a52a33da5d68` |
-| Token Launch | `launch_token` | TX: `73c41365-9e61-4c56-a391-0b4d11ea4680` ("mcpv5test" / MVTX) |
-| Transfer GALA | `transfer_gala` | ✅ "gala-transfer-successful" |
-| Transfer Token | `transfer_token` | ✅ 10 ANIME transferred |
-| Lock Tokens | `lock_tokens` | ✅ 100 ANIME locked |
-| Unlock Tokens | `unlock_tokens` | ✅ 50 ANIME unlocked |
-| Burn Tokens | `burn_tokens` | ✅ 5 ANIME burned (IRREVERSIBLE!) |
-| Wrap Token | `wrap_token` | TX: `82b6fad5...` (1 MUSIC → GMUSIC) |
-| Unwrap Token | `unwrap_token` | TX: `67cec436...` (1 GMUSIC → MUSIC) |
-| Bridge Out (ETH) | `bridge_out` | TX: `966d21c8...` (1 GALA → Ethereum) |
-| Bridge Out (SOL) | `bridge_out` | TX: `1285b629...` (1 GALA → Solana) |
-| Bridge In (ETH) | `bridge_in` | TX: `0xcf855a8e...` (1 GALA from Ethereum) |
-| Bridge In (SOL) | `bridge_in` | TX: `4tYaERX8...` (1 GALA from Solana) |
-| Create Wallet | `create_wallet` | ✅ `0x4340747AB7501D89ca8e6D48fb878f46000D9BA7` |
-| Create Solana Wallet | `create_solana_wallet` | ✅ `SxQRguAvWj7nWHgS6gh4764d5HKsYect1ovYGdfHZWE` |
-
-### Comprehensive Coverage
-- **132 tools** - ALL tested
-- **131 PASS** - 100% of testable tools
-- **0 BUG** - All bugs fixed in SDK 5.0.1!
-- **1 CONFIG-REQUIRED** - `request_solana_devnet_airdrop` (rate limited, expected)
-- **0 SKIP** - Even `graduate_token` now tested!
-
----
-
-## Test Environment
-
-- **Environment:** STAGE (staging)
-- **SDK Version:** 5.0.0
-- **MCP Server Version:** 5.0.0
-- **Test Wallet:** Configured via PRIVATE_KEY environment variable
-- **Test Date:** 2025-12-09

package/jest.integration.config.js

@@ -1,70 +0,0 @@
-/**
- * Jest Configuration for Integration Tests
- *
- * Integration tests use real SDK instances and make actual API calls.
- * Requires valid PRIVATE_KEY environment variable.
- */
-
-module.exports = {
-  // Use ts-jest for TypeScript support
-  preset: 'ts-jest',
-
-  // Node.js environment (MCP server is server-side)
-  testEnvironment: 'node',
-
-  // Integration test file location patterns
-  roots: ['<rootDir>/src'],
-  testMatch: ['**/__tests__/integration/**/*.integration.test.ts'],
-
-  // Coverage collection
-  collectCoverageFrom: [
-    'src/tools/**/*.ts',
-    '!src/tools/**/__tests__/**',
-    '!src/**/*.d.ts',
-  ],
-
-  // Coverage reporters
-  coverageReporters: ['text', 'text-summary', 'html', 'lcov'],
-
-  // Module path aliases
-  moduleNameMapper: {
-    '^@/(.*}$': '<rootDir>/src/$1',
-    '^(\\.{1,2}/.*)\\.js$': '$1', // Map .js imports to .ts files
-  },
-
-  // Transform files with ts-jest
-  transform: {
-    '^.+\\.ts$': [
-      'ts-jest',
-      {
-        tsconfig: {
-          module: 'commonjs',
-          strict: true,
-          esModuleInterop: true,
-          skipLibCheck: true,
-        },
-      },
-    ],
-  },
-
-  // File extensions to consider
-  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json'],
-
-  // Ignore patterns
-  testPathIgnorePatterns: ['/node_modules/', '/dist/', '/.history/'],
-
-  // Setup files (if needed for global test setup)
-  // setupFilesAfterEnv: ['<rootDir>/src/__tests__/setup.ts'],
-
-  // Clear mocks between tests
-  clearMocks: true,
-
-  // Verbose output
-  verbose: true,
-
-  // Integration tests may take longer
-  testTimeout: 60000, // 60 seconds
-
-  // Maximum worker threads (optimize for CI/CD)
-  maxWorkers: '50%',
-};

package/scripts/inject-version.ts

@@ -1,31 +0,0 @@
-/**
- * Version Injection Script
- *
- * Reads the MCP server version from package.json and generates a version constant file.
- * This runs as a prebuild step to ensure version is always in sync.
- */
-
-import { readFileSync, writeFileSync, mkdirSync } from 'fs';
-import { dirname, join } from 'path';
-
-// Get package version from package.json
-const packageJsonPath = join(dirname(__filename), '../package.json');
-const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
-const mcpVersion = packageJson.version;
-
-// Create the generated constants file
-const generatedDir = join(dirname(__filename), '../src/generated');
-mkdirSync(generatedDir, { recursive: true });
-
-const versionFile = join(generatedDir, 'version.ts');
-const versionContent = `/**
- * AUTO-GENERATED VERSION FILE
- * This file is generated by scripts/inject-version.ts during build
- * DO NOT EDIT MANUALLY
- */
-
-export const MCP_SERVER_VERSION = '${mcpVersion}';
-`;
-
-writeFileSync(versionFile, versionContent, 'utf-8');
-console.log(`✓ Injected MCP version ${mcpVersion} to ${versionFile}`);

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

@@ -1,250 +0,0 @@
-#!/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();