feat: Major improvements to search and release workflow

- Use issuesGetter/count endpoint for efficient issue counting
- Split search into simple (ID+summary) and detailed (full info) versions
- Add custom_fields_filter to search_issues_detailed
- Add GitHub Packages (ghcr.io) Docker registry support
- Include package artifacts in GitHub Releases (.whl and .tar.gz)
- Update documentation with all available functions

Author: ivolnistov

.github/workflows/release.yml

@@ -34,9 +34,9 @@ jobs:
       uses: pypa/gh-action-pypi-publish@release/v1
       # Uses OIDC Trusted Publisher, no password needed!
 
-  # Deploy to Docker Hub
+  # Deploy to Docker Hub and GitHub Container Registry
   docker:
-    name: Deploy to Docker Hub
+    name: Deploy Docker Images
     runs-on: ubuntu-latest
     permissions:
       contents: read
@@ -59,11 +59,20 @@ jobs:
         username: ${{ secrets.DOCKERHUB_USERNAME }}
         password: ${{ secrets.DOCKERHUB_TOKEN }}
 
+    - name: Log in to GitHub Container Registry
+      uses: docker/login-action@v3
+      with:
+        registry: ghcr.io
+        username: ${{ github.actor }}
+        password: ${{ secrets.GITHUB_TOKEN }}
+
     - name: Extract metadata
       id: meta
       uses: docker/metadata-action@v5
       with:
-        images: docker.io/ivolnistov/youtrack-rocket-mcp
+        images: |
+          docker.io/ivolnistov/youtrack-rocket-mcp
+          ghcr.io/${{ github.repository }}
         tags: |
           type=semver,pattern={{version}}
           type=semver,pattern={{major}}.{{minor}}
@@ -81,17 +90,62 @@ jobs:
         cache-from: type=gha
         cache-to: type=gha,mode=max
 
+  # Build release packages
+  build-packages:
+    name: Build Release Packages
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.12'
+    
+    - name: Install build tools
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install build
+    
+    - name: Build packages
+      run: python -m build
+    
+    - name: Upload wheel
+      uses: actions/upload-artifact@v4
+      with:
+        name: wheel
+        path: dist/*.whl
+    
+    - name: Upload sdist
+      uses: actions/upload-artifact@v4
+      with:
+        name: sdist
+        path: dist/*.tar.gz
+
   # Create GitHub Release
   release:
     name: Create GitHub Release
-    needs: [pypi, docker]  # Wait for both deployments
+    needs: [pypi, docker, build-packages]  # Wait for all deployments and builds
     runs-on: ubuntu-latest
     permissions:
       contents: write
 
     steps:
     - uses: actions/checkout@v4
 
+    - name: Download wheel artifact
+      uses: actions/download-artifact@v4
+      with:
+        name: wheel
+        path: dist/
+    
+    - name: Download sdist artifact
+      uses: actions/download-artifact@v4
+      with:
+        name: sdist
+        path: dist/
+    
     - name: Extract version from tag
       id: version
       run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
@@ -103,18 +157,27 @@ jobs:
         draft: false
         prerelease: false
         generate_release_notes: true
+        files: |
+          dist/*.whl
+          dist/*.tar.gz
         body: |
           ## 🚀 Release v${{ steps.version.outputs.VERSION }}
           
           ### Installation Options:
           
+          #### Direct Download
+          Download the packages attached to this release.
+          
           #### PyPI
           ```bash
           # Using uvx (no installation required)
           uvx youtrack-rocket-mcp
           
           # Or install with uv tool
           uv tool install youtrack-rocket-mcp
+          
+          # Or with pip
+          pip install youtrack-rocket-mcp
           ```
           
           #### Docker Hub
@@ -123,5 +186,11 @@ jobs:
           docker pull ivolnistov/youtrack-rocket-mcp:latest
           ```
           
+          #### GitHub Container Registry
+          ```bash
+          docker pull ghcr.io/i-volnistov/youtrack-rocket-mcp:${{ steps.version.outputs.VERSION }}
+          docker pull ghcr.io/i-volnistov/youtrack-rocket-mcp:latest
+          ```
+          
           ### What's Changed
           See the full changelog below.

CHANGES.md

@@ -1,5 +1,42 @@
 # YouTrack MCP Server - Changes
 
+## Date: 2025-01-06
+
+### New Features:
+
+1. **GitHub Release packages and Container Registry support**
+   - Added GitHub Packages (ghcr.io) deployment alongside Docker Hub
+   - Docker images now available at both:
+     - `docker.io/ivolnistov/youtrack-rocket-mcp`
+     - `ghcr.io/i-volnistov/youtrack-rocket-mcp`
+   - GitHub Releases now include built packages (.whl and .tar.gz files) as attachments
+   - Added separate build-packages job to create release artifacts
+   - File: `.github/workflows/release.yml`
+
+2. **Efficient issue counting with `issuesGetter/count` endpoint**
+   - Replaced inefficient fetching of 1000 issues with dedicated count API endpoint
+   - Added retry logic for when YouTrack returns -1 (still calculating)
+   - Significantly improves performance for large result sets
+   - Both `search_issues` and `search_issues_detailed` now use the count endpoint
+   - Files: `src/youtrack_rocket_mcp/tools/issues.py`
+
+3. **Split search functionality into simple and detailed versions**
+   - `search_issues`: Returns only ID and summary (default limit: 100)
+   - `search_issues_detailed`: Returns full information with custom fields (default limit: 30)
+   - Added `custom_fields_filter` parameter to selectively include fields
+   - Files: `src/youtrack_rocket_mcp/tools/issues.py`
+
+### Improvements:
+
+1. **Search results metadata**
+   - All search functions now return total count, shown count, and limit
+   - Display informative message when not all results are shown
+   - Removed redundant project field from search results
+
+2. **Fixed async close() method**
+   - Changed `def close()` to `async def close()` to fix RuntimeWarning
+   - File: `src/youtrack_rocket_mcp/tools/issues.py`
+
 ## Date: 2025-01-05
 
 ### Fixes and Improvements:

README.md

@@ -9,26 +9,36 @@ Model Context Protocol (MCP) is an open standard that enables AI models to inter
 ## Features
 
 - **Issue Management**
-  - Get issue details
-  - Search for issues using YouTrack query language
-  - Create new issues
-  - Add comments to issues
+  - `get_issue` - Get complete issue details
+  - `get_issue_raw` - Get raw API response for an issue
+  - `search_issues` - Quick search (returns only ID and summary, limit 100)
+  - `search_issues_detailed` - Full search with custom fields filtering (limit 30)
+  - `create_issue` - Create new bug reports, features, or tasks
+  - `add_comment` - Add comments to issues with markdown support
+  - `execute_command` - Batch update issues (assign, change state, priority, etc.)
 
 - **Project Management**
-  - Get project list and details
-  - Create and update projects
-  - Access project issues
-  - Manage custom fields
+  - `get_projects` - List all available projects
+  - `get_project` - Get project configuration and custom fields
+  - `get_project_by_name` - Find project by display name
+  - `get_project_issues` - List issues in a project
+  - `get_field_values` - Get valid values for a field (states, priorities, etc.)
+  - `get_custom_fields` - List project's custom fields
 
 - **User Management**
-  - Get current user information
-  - Search for users
-  - Access user details and groups
-
-- **Search Functionality**
-  - Advanced search with custom fields
-  - Structured filtering
-  - Sorting options
+  - `get_current_user` - Get current API user
+  - `get_user` - Fetch user details by ID
+  - `get_user_by_login` - Find user by login name
+  - `search_users` - Search users by name or login
+
+- **Advanced Search**
+  - `advanced_search` - Search with sorting capabilities
+  - `filter_issues` - Structured filtering by multiple criteria
+  - `search_with_custom_fields` - Search by custom field values
+
+- **Search Help**
+  - `get_search_syntax_guide` - Complete YouTrack query syntax reference
+  - `get_common_queries` - Common query examples and templates
 
 ## Documentation