@daghis/teamcity-mcp 0.9.1 → 1.0.0

package/jest.setup.js

@@ -1,24 +0,0 @@
-/**
- * Jest setup file - runs before all tests
- */
-
-// Set NODE_ENV to test
-process.env.NODE_ENV = 'test';
-
-// Silence console logs during tests unless explicitly needed
-if (!process.env.DEBUG_TESTS) {
-  global.console = {
-    ...console,
-    log: jest.fn(),
-    debug: jest.fn(),
-    info: jest.fn(),
-    warn: jest.fn(),
-    // Keep error for debugging test failures
-    error: console.error,
-  };
-}
-
-// Increase default test timeout for async tests
-jest.setTimeout(15000);
-
-// Open handles cleanup is handled in tests/setup.ts (setupFilesAfterEnv)

package/openapi-generator-config.json

@@ -1,27 +0,0 @@
-{
-  "generatorName": "typescript-axios",
-  "outputDir": "./src/teamcity-client",
-  "inputSpec": "./.cache/teamcity-swagger.json",
-  "additionalProperties": {
-    "npmName": "@teamcity/client",
-    "npmVersion": "1.0.0",
-    "supportsES6": true,
-    "withSeparateModelsAndApi": true,
-    "apiPackage": "api",
-    "modelPackage": "models",
-    "withInterfaces": true,
-    "useSingleRequestParameter": true,
-    "ensureUniqueParams": true
-  },
-  "globalProperties": {
-    "skipFormModel": false,
-    "modelDocs": true,
-    "apiDocs": true,
-    "modelTests": false,
-    "apiTests": false
-  },
-  "typeMappings": {
-    "DateTime": "Date",
-    "date": "Date"
-  }
-}

package/openapitools.json

@@ -1,7 +0,0 @@
-{
-  "$schema": "./node_modules/@openapitools/openapi-generator-cli/config.schema.json",
-  "spaces": 2,
-  "generator-cli": {
-    "version": "7.10.0"
-  }
-}

package/scripts/build.cjs

@@ -1,106 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Build script using esbuild for fast TypeScript compilation
- */
-
-const esbuild = require('esbuild');
-const { TsconfigPathsPlugin } = require('@esbuild-plugins/tsconfig-paths');
-const { execSync } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-
-const isProduction = process.env.NODE_ENV === 'production';
-
-const plugins = [
-  TsconfigPathsPlugin({
-    tsconfig: path.resolve(__dirname, '..', 'tsconfig.json')
-  })
-];
-
-if (process.env.CODECOV_BUNDLE) {
-  try {
-    // Attempt to load Codecov bundler plugin for esbuild. If unavailable,
-    // warn and continue; CI will conditionally upload only when bundles exist.
-    const { codecovEsbuildPlugin } = require('@codecov/bundler-plugin-esbuild');
-    plugins.push(
-      codecovEsbuildPlugin({
-        output: {
-          path: path.join(__dirname, '..', 'coverage', 'bundles')
-        }
-      })
-    );
-  } catch (err) {
-    console.warn('Codecov bundle plugin missing, skipping analysis');
-  }
-}
-
-async function build() {
-  try {
-    console.log('🔨 Building TypeScript project with esbuild...');
-    
-    // Clean dist directory
-    const distPath = path.join(__dirname, '..', 'dist');
-    if (fs.existsSync(distPath)) {
-      fs.rmSync(distPath, { recursive: true, force: true });
-    }
-    fs.mkdirSync(distPath, { recursive: true });
-    
-    // Build with esbuild
-    await esbuild.build({
-      entryPoints: ['src/index.ts'],
-      bundle: true,
-      outfile: 'dist/index.js',
-      platform: 'node',
-      target: 'node20',
-      format: 'cjs',
-      banner: {
-        js: '#!/usr/bin/env node'
-      },
-      sourcemap: !isProduction,
-      minify: isProduction,
-      treeShaking: true,
-      plugins,
-      external: [
-        '@modelcontextprotocol/sdk',
-        'express',
-        'dotenv',
-        'winston',
-        'morgan',
-        'zod'
-      ],
-      logLevel: 'info',
-      define: {
-        'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV || 'development')
-      }
-    });
-    
-    // Generate TypeScript declarations using tsc
-    console.log('📝 Generating TypeScript declarations...');
-    try {
-      execSync('npx tsc --emitDeclarationOnly --declaration --project tsconfig.build.json', {
-        stdio: 'inherit'
-      });
-      
-      // Apply path aliases to generated .d.ts files
-      console.log('🔗 Resolving path aliases...');
-      execSync('npx tsc-alias -p tsconfig.build.json', {
-        stdio: 'inherit'
-      });
-    } catch (error) {
-      console.warn('⚠️ TypeScript declaration generation had some issues, but JavaScript build succeeded');
-    }
-    
-    // Make the file executable (shebang will be added by esbuild for ESM)
-    const builtFile = path.join(__dirname, '..', 'dist', 'index.js');
-    fs.chmodSync(builtFile, '755');
-    
-    console.log('✅ Build completed successfully!');
-  } catch (error) {
-    console.error('❌ Build failed:', error);
-    process.exit(1);
-  }
-}
-
-// Run build
-build();

package/scripts/debug-fetch-log.ts

@@ -1,52 +0,0 @@
-import * as dotenv from 'dotenv';
-dotenv.config();
-
-import { TeamCityAPI } from '@/api-client';
-
-async function main() {
-  const buildId = process.argv[2] || '54';
-  try {
-    const api = TeamCityAPI.getInstance();
-    // Try chunked first
-    const chunk = await api.getBuildLogChunk(buildId, { startLine: 0, lineCount: 200 });
-    // Print as JSON to see structure
-    // eslint-disable-next-line no-console
-    console.log(JSON.stringify({ ok: true, where: 'chunk', meta: chunk }, null, 2));
-    // eslint-disable-next-line no-console
-    console.log('--- lines start ---');
-    // eslint-disable-next-line no-console
-    console.log(chunk.lines.join('\n'));
-    // eslint-disable-next-line no-console
-    console.log('--- lines end ---');
-  } catch (e1) {
-    // eslint-disable-next-line no-console
-    console.error('Chunk fetch failed:', e1 instanceof Error ? e1.message : String(e1));
-    // Try to resolve buildId from a build number if a plain number was provided
-    const maybeNumber = buildId;
-    if (/^\d+$/.test(maybeNumber)) {
-      try {
-        const api = TeamCityAPI.getInstance();
-        const resp = await api.listBuilds(`number:${maybeNumber},count:5`);
-        // eslint-disable-next-line no-console
-        console.log('\nLocator search results for build number', maybeNumber);
-        // eslint-disable-next-line no-console
-        console.log(JSON.stringify(resp, null, 2));
-        const items = (resp as any).build || [];
-        if (items.length > 0) {
-          const first = items[0];
-          // eslint-disable-next-line no-console
-          console.log('First match id:', first.id, 'buildTypeId:', first.buildTypeId);
-        } else {
-          // eslint-disable-next-line no-console
-          console.log('No builds found with build number', maybeNumber);
-        }
-      } catch (e3) {
-        // eslint-disable-next-line no-console
-        console.error('Failed to search by build number:', e3 instanceof Error ? e3.message : String(e3));
-      }
-    }
-    process.exit(1);
-  }
-}
-
-main();

package/scripts/emit-coverage-stats.js

@@ -1,42 +0,0 @@
-#!/usr/bin/env node
-/* Emit TeamCity buildStatisticValue messages from coverage/coverage-summary.json */
-const fs = require('fs');
-const path = require('path');
-
-function esc(val) {
-  const s = String(val);
-  return s
-    .replace(/\|/g, '||')
-    .replace(/\[/g, '|[')
-    .replace(/\]/g, '|]')
-    .replace(/'/g, "|'")
-    .replace(/\n/g, '|n');
-}
-
-try {
-  const file = path.resolve(process.cwd(), 'coverage', 'coverage-summary.json');
-  const raw = fs.readFileSync(file, 'utf8');
-  const json = JSON.parse(raw);
-  const t = json.total || {};
-  const pairs = [
-    ['CoverageLines', t.lines?.pct],
-    ['CoverageBranches', t.branches?.pct],
-    ['CoverageFunctions', t.functions?.pct],
-    ['CoverageStatements', t.statements?.pct],
-  ];
-  for (const [k, v] of pairs) {
-    if (v == null) continue;
-    // TeamCity requires single-quoted values with escaping
-    process.stdout.write(
-      `##teamcity[buildStatisticValue key='${esc(k)}' value='${esc(v)}']\n`
-    );
-  }
-  process.exit(0);
-} catch (e) {
-  const msg = esc(e && e.message ? e.message : String(e));
-  process.stdout.write(
-    `##teamcity[message text='Skipping coverage stats: ${msg}' status='WARNING']\n`
-  );
-  process.exit(0);
-}
-

package/scripts/fetch-swagger-spec.ts

@@ -1,140 +0,0 @@
-#!/usr/bin/env tsx
-
-/**
- * Script to fetch and cache TeamCity Swagger specification
- */
-
-import { config as loadEnv } from 'dotenv';
-import { SwaggerManager } from '../src/swagger';
-import fs from 'fs/promises';
-import path from 'path';
-
-// Load environment variables
-loadEnv();
-
-async function main() {
-  console.log('🔄 Fetching TeamCity Swagger specification...\n');
-
-  // Parse command line arguments
-  const args = process.argv.slice(2);
-  const forceRefresh = args.includes('--force') || args.includes('-f');
-  const outputPath = args.find(arg => arg.startsWith('--output='))?.split('=')[1] ?? 
-                     args.find(arg => arg.startsWith('-o='))?.split('=')[1];
-  const showHelp = args.includes('--help') || args.includes('-h');
-
-  if (showHelp) {
-    console.log(`
-Usage: npm run fetch:swagger [options]
-
-Options:
-  -f, --force           Force refresh (ignore cache)
-  -o, --output=<path>   Save spec to file
-  -h, --help           Show this help message
-
-Environment variables:
-  TEAMCITY_URL         TeamCity server URL (required)
-  TEAMCITY_TOKEN       TeamCity API token (required)
-
-Examples:
-  npm run fetch:swagger
-  npm run fetch:swagger --force
-  npm run fetch:swagger --output=./swagger.json
-`);
-    process.exit(0);
-  }
-
-  // Check required environment variables
-  const baseUrl = process.env['TEAMCITY_URL'];
-  const token = process.env['TEAMCITY_TOKEN'];
-
-  if (!baseUrl || !token) {
-    console.error('❌ Error: TEAMCITY_URL and TEAMCITY_TOKEN environment variables are required');
-    console.error('\nExample:');
-    console.error('  export TEAMCITY_URL=https://teamcity.example.com');
-    console.error('  export TEAMCITY_TOKEN=your-api-token');
-    process.exit(1);
-  }
-
-  try {
-    // Create SwaggerManager instance
-    const manager = new SwaggerManager({
-      baseUrl,
-      token,
-      forceRefresh,
-    });
-
-    // Get server info
-    console.log('📡 Connecting to TeamCity server...');
-    const serverInfo = await manager.getServerInfo();
-    
-    if (!serverInfo.connected) {
-      throw new Error('Failed to connect to TeamCity server');
-    }
-
-    console.log(`✅ Connected to TeamCity ${serverInfo.version ?? 'Unknown version'}\n`);
-
-    // Fetch the specification
-    console.log('📥 Fetching Swagger specification...');
-    const spec = await manager.getSpec();
-
-    // Validate the specification
-    console.log('🔍 Validating specification...');
-    const validation = await manager.validateSpec(spec);
-
-    if (!validation.isValid) {
-      console.error('❌ Specification validation failed:');
-      validation.errors?.forEach(error => console.error(`  - ${error}`));
-      process.exit(1);
-    }
-
-    console.log(`✅ Valid ${validation.version} specification`);
-    if (validation.teamCityVersion) {
-      console.log(`   TeamCity version: ${validation.teamCityVersion}`);
-    }
-    
-    if (validation.warnings && validation.warnings.length > 0) {
-      console.log('\n⚠️  Warnings:');
-      validation.warnings.forEach(warning => console.log(`  - ${warning}`));
-    }
-
-    // Save to file if requested
-    if (outputPath) {
-      console.log(`\n💾 Saving specification to ${outputPath}...`);
-      const outputDir = path.dirname(outputPath);
-      await fs.mkdir(outputDir, { recursive: true });
-      await fs.writeFile(outputPath, JSON.stringify(spec, null, 2), 'utf-8');
-      console.log('✅ Specification saved');
-    }
-
-    // Show cache statistics
-    const cacheStats = await manager.getCacheStats();
-    console.log('\n📊 Cache Statistics:');
-    console.log(`   Files: ${cacheStats.files}`);
-    console.log(`   Size: ${Math.round(cacheStats.size / 1024)} KB`);
-    if (cacheStats.oldestFile) {
-      console.log(`   Oldest: ${cacheStats.oldestFile.toISOString()}`);
-    }
-
-    // Show summary
-    const paths = Object.keys(spec.paths ?? {});
-    console.log('\n📋 Specification Summary:');
-    console.log(`   Total paths: ${paths.length}`);
-    console.log(`   Builds endpoints: ${paths.filter(p => p.includes('/builds')).length}`);
-    console.log(`   Projects endpoints: ${paths.filter(p => p.includes('/projects')).length}`);
-    console.log(`   VCS endpoints: ${paths.filter(p => p.includes('/vcs')).length}`);
-    console.log(`   Agent endpoints: ${paths.filter(p => p.includes('/agent')).length}`);
-
-    console.log('\n✨ Success! Swagger specification is ready for client generation.');
-    console.log('   Run "npm run generate:client" to generate the TypeScript client.');
-
-  } catch (error) {
-    console.error('\n❌ Error:', error instanceof Error ? error.message : error);
-    process.exit(1);
-  }
-}
-
-// Run the script
-main().catch(error => {
-  console.error('Unhandled error:', error);
-  process.exit(1);
-});

package/scripts/generate-third-party-notices.cjs

@@ -1,71 +0,0 @@
-#!/usr/bin/env node
-/*
- Generates THIRD_PARTY_NOTICES.md from installed packages.
- Reads direct deps and devDeps from package.json and extracts
- name, version, and license from node_modules/<pkg>/package.json.
-*/
-const fs = require('fs');
-const path = require('path');
-
-function readJSON(p) {
-  return JSON.parse(fs.readFileSync(p, 'utf8'));
-}
-
-function pkgInfo(name) {
-  try {
-    const p = path.join('node_modules', ...name.split('/'));
-    const data = readJSON(path.join(p, 'package.json'));
-    // Normalize license string
-    let license = 'UNKNOWN';
-    if (typeof data.license === 'string') license = data.license;
-    else if (data.license && typeof data.license.type === 'string') license = data.license.type;
-    else if (Array.isArray(data.licenses) && data.licenses.length && data.licenses[0].type)
-      license = data.licenses[0].type;
-    return { name, version: data.version || 'UNKNOWN', license };
-  } catch {
-    return { name, version: 'UNKNOWN', license: 'UNKNOWN' };
-  }
-}
-
-function generate() {
-  const pkg = readJSON(path.join(process.cwd(), 'package.json'));
-  const prod = Object.keys(pkg.dependencies || {}).sort().map(pkgInfo);
-  const dev = Object.keys(pkg.devDependencies || {}).sort().map(pkgInfo);
-
-  const lines = [];
-  lines.push('# Third-Party Notices');
-  lines.push('');
-  lines.push(
-    'This project includes third-party software. The following lists the direct dependencies and their licenses as resolved in this workspace. For full license texts, see each package’s own repository or the copies included in `node_modules/<package>/LICENSE` when present.'
-  );
-  lines.push('');
-  lines.push(
-    'If a dependency is not currently installed in `node_modules`, its version or license may be shown as UNKNOWN below; consult the package’s metadata for definitive terms.'
-  );
-  lines.push('');
-  const now = new Date();
-  const isoDate = now.toISOString().slice(0, 10);
-  lines.push(`Last updated: ${isoDate}`);
-  lines.push('');
-
-  lines.push('## Production Dependencies');
-  lines.push('');
-  for (const i of prod) lines.push(`- ${i.name} ${i.version} — ${i.license}`);
-  lines.push('');
-
-  lines.push('## Development Dependencies');
-  lines.push('');
-  for (const i of dev) lines.push(`- ${i.name} ${i.version} — ${i.license}`);
-  lines.push('');
-  lines.push('---');
-  lines.push('');
-  lines.push(
-    'Note: This document is provided for convenience and does not modify any license terms. All third-party packages remain the property of their respective copyright holders and are licensed under their own terms.'
-  );
-  lines.push('');
-
-  fs.writeFileSync('THIRD_PARTY_NOTICES.md', lines.join('\n'));
-}
-
-generate();
-

package/scripts/interact.sh

@@ -1,23 +0,0 @@
-#!/usr/bin/env bash
-
-echo "Starting MCP Server in interactive mode..."
-echo "The server will start and you can type JSON-RPC commands."
-echo ""
-echo "Try these commands (paste them one at a time):"
-echo ""
-echo '1. Initialize:'
-echo '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"0.1.0","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}},"id":1}'
-echo ""
-echo '2. List tools:'
-echo '{"jsonrpc":"2.0","method":"tools/list","params":{},"id":2}'
-echo ""
-echo '3. Call ping tool:'
-echo '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"ping","arguments":{"message":"hello"}},"id":3}'
-echo ""
-echo "Press Ctrl+C to exit"
-echo "=========================================="
-echo ""
-
-# Run the server
-npx tsx src/index.ts
-

package/scripts/print-builds.ts

@@ -1,21 +0,0 @@
-import * as dotenv from 'dotenv';
-dotenv.config();
-
-import { TeamCityAPI } from '@/api-client';
-
-async function main() {
-  const locator = process.argv.slice(2).join(' ') || 'count:5';
-  const api = TeamCityAPI.getInstance();
-  // eslint-disable-next-line no-console
-  console.log('Locator:', locator);
-  const data = await api.listBuilds(locator);
-  // eslint-disable-next-line no-console
-  console.log(JSON.stringify(data, null, 2));
-}
-
-main().catch((e) => {
-  // eslint-disable-next-line no-console
-  console.error('Error:', e instanceof Error ? e.message : String(e));
-  process.exit(1);
-});
-

package/scripts/verify-integration-env.cjs

@@ -1,29 +0,0 @@
-#!/usr/bin/env node
-// Simple precheck to prevent false-positive integration runs
-// Loads .env and ensures required TeamCity variables are present.
-
-const dotenv = require('dotenv');
-dotenv.config();
-
-function hasEnv(name) {
-  return typeof process.env[name] === 'string' && process.env[name].length > 0;
-}
-
-const url = process.env.TEAMCITY_URL || process.env.TEAMCITY_SERVER_URL;
-const token = process.env.TEAMCITY_TOKEN || process.env.TEAMCITY_API_TOKEN;
-
-if (!url || !token) {
-  // Print a clear message and fail.
-  const msg = [
-    'Missing TeamCity credentials for integration tests.',
-    'Please set TEAMCITY_URL and TEAMCITY_TOKEN (or TEAMCITY_SERVER_URL and TEAMCITY_API_TOKEN) in your environment or .env file.',
-  ].join('\n');
-  console.error(msg);
-  process.exit(1);
-}
-
-// Ensure MCP_MODE is set for clarity; integration tests control per-call, but default to dev
-if (!hasEnv('MCP_MODE')) process.env.MCP_MODE = 'dev';
-
-process.exit(0);
-