@daghis/teamcity-mcp 0.1.2 → 0.2.1

package/.commitlintrc.mjs

@@ -0,0 +1,25 @@
+export default {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    // Allow Dependabot-style commit bodies with long URLs/metadata
+    'body-max-line-length': [0, 'always'],
+    'type-enum': [
+      2,
+      'always',
+      [
+        'build',
+        'chore',
+        'ci',
+        'docs',
+        'feat',
+        'fix',
+        'perf',
+        'refactor',
+        'revert',
+        'style',
+        'test',
+        'deps'
+      ]
+    ]
+  }
+};

package/.github/dependabot.yml

@@ -0,0 +1,38 @@
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "06:00"
+      timezone: "UTC"
+    open-pull-requests-limit: 10
+    labels:
+      - "dependencies"
+    commit-message:
+      prefix: "deps"
+      include: "scope"
+    groups:
+      minor-and-patch:
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "06:00"
+      timezone: "UTC"
+    labels:
+      - "dependencies"
+    commit-message:
+      prefix: "deps"
+      include: "scope"
+    groups:
+      actions-minor-and-patch:
+        update-types:
+          - "minor"
+          - "patch"

package/.github/workflows/ci.yml

@@ -10,14 +10,15 @@ on:
 
 permissions:
   contents: read
+  checks: write
 
 jobs:
   lint:
     name: Lint (no fix)
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
         with:
           node-version: 20.x
           cache: npm
@@ -28,8 +29,8 @@ jobs:
     name: Format check
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
         with:
           node-version: 20.x
           cache: npm
@@ -40,8 +41,8 @@ jobs:
     name: Typecheck
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
         with:
           node-version: 20.x
           cache: npm
@@ -56,8 +57,8 @@ jobs:
       matrix:
         shard: [1, 2, 3, 4]
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
         with:
           node-version: 20.x
           cache: npm
@@ -67,28 +68,31 @@ jobs:
           JEST_JUNIT_OUTPUT: ./coverage/junit-${{ matrix.shard }}.xml
           JEST_JUNIT_CLASSNAME: "{filepath}"
         run: npm run test:coverage:ci -- --reporters=default --reporters=jest-junit --shard=${{ matrix.shard }}/4 --passWithNoTests
+      - name: Upload test results to Codecov
+        if: ${{ !cancelled() && github.actor != 'dependabot[bot]' }}
+        uses: codecov/test-results-action@v1
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage/junit-${{ matrix.shard }}.xml
       - name: Upload coverage to Codecov
-        if: success()
-        uses: codecov/codecov-action@v4
+        if: ${{ success() && github.actor != 'dependabot[bot]' }}
+        uses: codecov/codecov-action@v5
         with:
           files: ./coverage/lcov.info
           flags: unittests
           name: codecov-coverage
           token: ${{ secrets.CODECOV_TOKEN }}
-          fail_ci_if_error: false
-      - name: Upload test results to Codecov
-        if: ${{ !cancelled() }}
-        uses: codecov/test-results-action@v1
+          fail_ci_if_error: true
+      - name: Analyze bundle
+        run: npm run build:bundle
+      - name: Upload bundle analysis to Codecov
+        if: ${{ success() && github.actor != 'dependabot[bot]' && hashFiles('coverage/bundles/*.json') != '' }}
+        uses: codecov/codecov-action@v5
         with:
+          plugin: javascript-bundle
+          files: ./coverage/bundles/*.json
           token: ${{ secrets.CODECOV_TOKEN }}
-          files: ./coverage/junit-${{ matrix.shard }}.xml
-      - name: Upload coverage artifact
-        if: always()
-        uses: actions/upload-artifact@v4
-        with:
-          name: coverage-shard-${{ matrix.shard }}
-          path: coverage/
-          if-no-files-found: ignore
+          fail_ci_if_error: true
 
   aggregate:
     name: Lint, Typecheck, Test (Node 20)

package/.github/workflows/codeql.yml

@@ -20,7 +20,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Initialize CodeQL
         uses: github/codeql-action/init@v3

package/.github/workflows/commitlint.yml

@@ -11,10 +11,10 @@ jobs:
   commitlint:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
-      - uses: wagoid/commitlint-github-action@v5
+      - uses: wagoid/commitlint-github-action@v6
         with:
-          configFile: .commitlintrc.js
+          configFile: .commitlintrc.mjs
           commitDepth: 1

package/.github/workflows/publish.yml

@@ -20,10 +20,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
           node-version: 20.x
           registry-url: 'https://registry.npmjs.org'
@@ -39,7 +39,27 @@ jobs:
       - name: Verify package contents
         run: npm pack --dry-run
 
+      - name: Read package version
+        id: pkg
+        run: |
+          node -e "console.log('version=' + require('./package.json').version)" >> "$GITHUB_OUTPUT"
+
+      - name: Check if version already exists on npm
+        id: exists
+        run: |
+          set -e
+          PKG_NAME=$(node -p -e "require('./package.json').name")
+          VERSION=${{ steps.pkg.outputs.version }}
+          if npm view "${PKG_NAME}@${VERSION}" version > /dev/null 2>&1; then
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+            echo "Version ${VERSION} already published for ${PKG_NAME}; skipping publish."
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+            echo "Version ${VERSION} not found on registry; will publish."
+          fi
+
       - name: Publish to npm
+        if: steps.exists.outputs.exists == 'false'
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
           NPM_CONFIG_PROVENANCE: 'true'

package/AGENTS.md

@@ -66,3 +66,64 @@
   await initializeTeamCity();
   await triggerBuild('MyBuildTypeId', 'refs/heads/main');
   ```
+
+## GitHub CLI (gh) Usage
+
+Use GitHub CLI to examine/update issues and manage PRs. Prefer body files over literal `\n` to ensure proper newlines in descriptions.
+
+### Setup
+- Verify install: `gh --version`
+- Authenticate: `gh auth login` (HTTPS, GitHub.com, device or browser flow)
+- Set repo context: `gh repo view` (should show `Daghis/teamcity-mcp`)
+
+### Issues: Inspect and Update
+- List open issues: `gh issue list --state open`
+- View details (JSON): `gh issue view 18 --json number,title,state,labels,assignees,body,url`
+- View formatted: `gh issue view 18`
+- Edit title/body: `gh issue edit 18 --title "New title" --body-file ./notes/issue-18.md`
+- Add/remove labels: `gh issue edit 18 --add-label enhancement --remove-label bug`
+- Assign/unassign: `gh issue edit 18 --add-assignee user1 --remove-assignee user2`
+- Comment: `gh issue comment 18 --body-file ./notes/comment.md`
+- Close/reopen: `gh issue close 18` | `gh issue reopen 18`
+
+### PRs: Create, Update, Review
+- Create PR from current branch:
+  - Minimal: `gh pr create --fill`
+  - Explicit: `gh pr create --base main --head feat/my-change --title "feat: ..." --body-file ./pr.md`
+  - Link issue: include `Closes #18` in the PR body.
+- Edit PR after creation:
+  - Update title/body: `gh pr edit 31 --title "..." --body-file ./pr.md`
+  - Change base: `gh pr edit 31 --base main`
+  - Add labels: `gh pr edit 31 --add-label dependencies`
+  - Mark draft/ready: `gh pr ready 31` | `gh pr create --draft ...`
+- Checkout PR branch: `gh pr checkout 31`
+- List/open PRs: `gh pr list --state open` | `gh pr view 31 --web`
+- Reviews: `gh pr review 31 --approve` | `--request-changes --body-file ./review.md`
+- Merge (maintainers): `gh pr merge 31 --squash --delete-branch` (ensure checks are green)
+
+### CI: Checks and Runs
+- PR status: `gh pr status` (current repo) or `gh pr view 31 --json statusCheckRollup`
+- List workflow runs (current branch): `gh run list --branch $(git branch --show-current)`
+- View a run: `gh run view <run-id> --log`
+- Rerun a run (maintainers): `gh run rerun <run-id>`
+
+### Advanced: Direct API with gh
+- Commit check-runs: `gh api repos/:owner/:repo/commits/<sha>/check-runs --paginate`
+- Combined status: `gh api repos/:owner/:repo/commits/<sha>/status`
+- PR payload: `gh pr view 31 --json headRefName,headRefOid,mergeable,mergeStateStatus`
+
+### Good Practices and Examples
+- Use body files to preserve newlines and bullets:
+  - Create file: `cat > /tmp/pr.md <<'MD'
+Title and summary paragraph.
+
+Bullets
+- Point A
+- Point B
+
+Closes #18.
+MD`
+  - Apply: `gh pr edit 31 --body-file /tmp/pr.md`
+- Keep commit subjects under 100 chars (commitlint default via `@commitlint/config-conventional`).
+- For Dependabot PRs: repository secrets aren’t available. Our CI skips Codecov uploads for `dependabot[bot]` but still runs tests and checks.
+- For forked PRs: treat as untrusted (no secrets). Avoid running steps that require secrets or write permissions unless guarded.

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.2.1](https://github.com/Daghis/teamcity-mcp/compare/v0.2.0...v0.2.1) (2025-09-12)
+
+
+### Bug Fixes
+
+* **mcp:** normalize TeamCity errors and wrap server info/metrics with runTool ([#53](https://github.com/Daghis/teamcity-mcp/issues/53)) ([2c8ab85](https://github.com/Daghis/teamcity-mcp/commit/2c8ab855a85e5faec4216a498c089e3a1a93ed7b))
+
+## [0.2.0](https://github.com/Daghis/teamcity-mcp/compare/v0.1.2...v0.2.0) (2025-09-11)
+
+
+### Features
+
+* add Codecov bundle analysis ([#28](https://github.com/Daghis/teamcity-mcp/issues/28)) ([87c3de8](https://github.com/Daghis/teamcity-mcp/commit/87c3de85af34bec5b071d82612d67ba4d5a52702))
+
 ## 0.1.2 (2025-09-11)
 
 

package/README.md

@@ -3,6 +3,7 @@
 [![CI](https://github.com/Daghis/teamcity-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Daghis/teamcity-mcp/actions/workflows/ci.yml)
 [![CodeQL](https://github.com/Daghis/teamcity-mcp/actions/workflows/codeql.yml/badge.svg)](https://github.com/Daghis/teamcity-mcp/actions/workflows/codeql.yml)
 [![codecov](https://codecov.io/gh/Daghis/teamcity-mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/Daghis/teamcity-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
 A Model Control Protocol (MCP) server that bridges AI coding assistants with JetBrains TeamCity CI/CD server, enabling natural language control of builds, tests, and deployments.
 
@@ -183,8 +184,15 @@ npm run typecheck
 
 # Build for production
 npm run build
+
+# Analyze bundle for Codecov
+npm run build:bundle
 ```
 
+### Bundle analysis in CI
+
+The CI workflow runs `npm run build:bundle` and uploads the generated `coverage/bundles` JSON using `codecov/codecov-action` with the `javascript-bundle` plugin.
+
 ## Project Structure
 
 ```

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,58 @@
+# Third-Party Notices
+
+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.
+
+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.
+
+Last updated: 2025-09-11
+
+## Production Dependencies
+
+- @modelcontextprotocol/sdk 0.5.0 — MIT
+- ajv 8.17.1 — MIT
+- ajv-formats 3.0.1 — MIT
+- axios 1.11.0 — MIT
+- dotenv 16.6.1 — BSD-2-Clause
+- express 4.21.2 — MIT
+- inversify 7.9.1 — MIT
+- morgan 1.10.1 — MIT
+- reflect-metadata 0.2.2 — Apache-2.0
+- tslib 2.8.1 — 0BSD
+- uuid 11.1.0 — MIT
+- winston 3.17.0 — MIT
+- zod 3.25.76 — MIT
+
+## Development Dependencies
+
+- @esbuild-plugins/tsconfig-paths 0.1.2 — ISC
+- @openapitools/openapi-generator-cli 2.23.1 — Apache-2.0
+- @trivago/prettier-plugin-sort-imports 5.2.2 — Apache-2.0
+- @types/ajv 0.0.5 — MIT
+- @types/express 4.17.23 — MIT
+- @types/jest 29.5.14 — MIT
+- @types/js-yaml 4.0.9 — MIT
+- @types/morgan 1.9.10 — MIT
+- @types/node 20.19.11 — MIT
+- @types/uuid 10.0.0 — MIT
+- @typescript-eslint/eslint-plugin 6.21.0 — MIT
+- @typescript-eslint/parser 6.21.0 — BSD-2-Clause
+- axios-retry 4.5.0 — Apache-2.0
+- esbuild 0.25.9 — MIT
+- eslint 8.57.1 — MIT
+- eslint-config-prettier 9.1.2 — MIT
+- eslint-import-resolver-typescript 4.4.4 — ISC
+- eslint-plugin-import 2.32.0 — MIT
+- eslint-plugin-prettier 5.5.4 — MIT
+- jest 29.7.0 — MIT
+- jest-junit 16.0.0 — Apache-2.0
+- js-yaml 4.1.0 — MIT
+- prettier 3.6.2 — MIT
+- ts-jest 29.4.1 — MIT
+- tsc-alias 1.8.16 — MIT
+- tsconfig-paths 4.2.0 — MIT
+- tsx 4.20.5 — MIT
+- typescript 5.9.2 — Apache-2.0
+
+---
+
+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.