mcp-ticketer 0.1.1__py3-none-any.whl

mcp_ticketer-0.1.1.dist-info/METADATA

@@ -0,0 +1,362 @@
+Metadata-Version: 2.4
+Name: mcp-ticketer
+Version: 0.1.1
+Summary: Universal ticket management interface for AI agents with MCP support
+Author-email: MCP Ticketer Team <support@mcp-ticketer.io>
+Maintainer-email: MCP Ticketer Team <support@mcp-ticketer.io>
+License: MIT
+Project-URL: Homepage, https://github.com/mcp-ticketer/mcp-ticketer
+Project-URL: Documentation, https://mcp-ticketer.readthedocs.io
+Project-URL: Repository, https://github.com/mcp-ticketer/mcp-ticketer
+Project-URL: Issues, https://github.com/mcp-ticketer/mcp-ticketer/issues
+Project-URL: Changelog, https://github.com/mcp-ticketer/mcp-ticketer/blob/main/CHANGELOG.md
+Keywords: mcp,tickets,jira,linear,github,issue-tracking,project-management,ai,automation,agent,ticketing
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Bug Tracking
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: typing-extensions>=4.8.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: psutil>=5.9.0
+Provides-Extra: all
+Requires-Dist: mcp-ticketer[github,jira,linear,mcp]; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-timeout>=2.2.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.12.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.5.0; extra == "dev"
+Requires-Dist: tox>=4.11.0; extra == "dev"
+Requires-Dist: pre-commit>=3.5.0; extra == "dev"
+Requires-Dist: bump2version>=1.0.1; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=7.2.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=2.0.0; extra == "docs"
+Requires-Dist: sphinx-autodoc-typehints>=1.25.0; extra == "docs"
+Requires-Dist: sphinx-click>=5.1.0; extra == "docs"
+Requires-Dist: myst-parser>=2.0.0; extra == "docs"
+Provides-Extra: mcp
+Requires-Dist: mcp>=0.1.0; extra == "mcp"
+Provides-Extra: jira
+Requires-Dist: jira>=3.5.0; extra == "jira"
+Requires-Dist: ai-trackdown-pytools>=1.5.0; extra == "jira"
+Provides-Extra: linear
+Requires-Dist: gql[httpx]>=3.0.0; extra == "linear"
+Provides-Extra: github
+Requires-Dist: PyGithub>=2.1.0; extra == "github"
+Provides-Extra: test
+Requires-Dist: pytest>=7.4.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+Requires-Dist: pytest-cov>=4.1.0; extra == "test"
+Requires-Dist: pytest-timeout>=2.2.0; extra == "test"
+Requires-Dist: pytest-mock>=3.12.0; extra == "test"
+Requires-Dist: responses>=0.24.0; extra == "test"
+Dynamic: license-file
+
+# MCP Ticketer
+
+[![PyPI - Version](https://img.shields.io/pypi/v/mcp-ticketerer.svg)](https://pypi.org/project/mcp-ticketerer)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/mcp-ticketerer.svg)](https://pypi.org/project/mcp-ticketerer)
+[![Documentation Status](https://readthedocs.org/projects/mcp-ticketerer/badge/?version=latest)](https://mcp-ticketerer.readthedocs.io/en/latest/?badge=latest)
+[![Tests](https://github.com/mcp-ticketerer/mcp-ticketerer/workflows/Tests/badge.svg)](https://github.com/mcp-ticketerer/mcp-ticketerer/actions)
+[![Coverage Status](https://codecov.io/gh/mcp-ticketerer/mcp-ticketerer/branch/main/graph/badge.svg)](https://codecov.io/gh/mcp-ticketerer/mcp-ticketerer)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
+Universal ticket management interface for AI agents with MCP (Model Context Protocol) support.
+
+## 🚀 Features
+
+- **🎯 Universal Ticket Model**: Simplified to Epic, Task, and Comment types
+- **🔌 Multiple Adapters**: Support for JIRA, Linear, GitHub Issues, and AI-Trackdown
+- **🤖 MCP Integration**: Native support for AI agent interactions
+- **⚡ High Performance**: Smart caching and async operations
+- **🎨 Rich CLI**: Beautiful terminal interface with colors and tables
+- **📊 State Machine**: Built-in state transitions with validation
+- **🔍 Advanced Search**: Full-text search with multiple filters
+- **📦 Easy Installation**: Available on PyPI with simple pip install
+
+## 📦 Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install mcp-ticketerer
+
+# Install with specific adapters
+pip install mcp-ticketerer[jira]      # JIRA support
+pip install mcp-ticketerer[linear]    # Linear support
+pip install mcp-ticketerer[github]    # GitHub Issues support
+pip install mcp-ticketerer[all]       # All adapters
+```
+
+### From Source
+
+```bash
+git clone https://github.com/mcp-ticketerer/mcp-ticketerer.git
+cd mcp-ticketerer
+pip install -e .
+```
+
+### Requirements
+
+- Python 3.9+
+- Virtual environment (recommended)
+
+## 🚀 Quick Start
+
+### 1. Initialize Configuration
+
+```bash
+# For AI-Trackdown (local file-based)
+mcp-ticketer init --adapter aitrackdown
+
+# For Linear (requires API key)
+mcp-ticketer init --adapter linear --team-id YOUR_TEAM_ID
+
+# For JIRA (requires server and credentials)
+mcp-ticketer init --adapter jira \
+  --jira-server https://company.atlassian.net \
+  --jira-email your.email@company.com
+
+# For GitHub Issues
+mcp-ticketer init --adapter github --repo owner/repo
+```
+
+### 2. Create Your First Ticket
+
+```bash
+mcp-ticketer create "Fix login bug" \
+  --description "Users cannot login with OAuth" \
+  --priority high \
+  --assignee "john.doe"
+```
+
+### 3. Manage Tickets
+
+```bash
+# List open tickets
+mcp-ticketer list --state open
+
+# Show ticket details
+mcp-ticketer show TICKET-123 --comments
+
+# Update ticket
+mcp-ticketer update TICKET-123 --priority critical
+
+# Transition state
+mcp-ticketer transition TICKET-123 in_progress
+
+# Search tickets
+mcp-ticketer search "login bug" --state open
+```
+
+## 🤖 MCP Server Integration
+
+Run the MCP server for AI tool integration:
+
+```bash
+mcp-ticketer-server
+```
+
+Configure your AI tool to use the MCP server:
+
+```json
+{
+  "mcpServers": {
+    "ticketer": {
+      "command": "mcp-ticketer-server",
+      "args": [],
+      "env": {
+        "MCP_TICKETER_ADAPTER": "jira"
+      }
+    }
+  }
+}
+```
+
+## 📚 Documentation
+
+Full documentation is available at [https://mcp-ticketerer.readthedocs.io](https://mcp-ticketerer.readthedocs.io)
+
+- [Getting Started Guide](https://mcp-ticketerer.readthedocs.io/en/latest/getting-started/)
+- [API Reference](https://mcp-ticketerer.readthedocs.io/en/latest/api/)
+- [Adapter Development](https://mcp-ticketerer.readthedocs.io/en/latest/adapters/)
+- [MCP Integration](https://mcp-ticketerer.readthedocs.io/en/latest/mcp/)
+
+## 🏗️ Architecture
+
+```
+mcp-ticketerer/
+├── adapters/        # Ticket system adapters
+│   ├── jira/       # JIRA integration
+│   ├── linear/     # Linear integration
+│   ├── github/     # GitHub Issues
+│   └── aitrackdown/ # Local file storage
+├── core/           # Core models and interfaces
+├── cli/            # Command-line interface
+├── mcp/            # MCP server implementation
+├── cache/          # Caching layer
+└── queue/          # Queue system for async operations
+```
+
+### State Machine
+
+```mermaid
+graph LR
+    OPEN --> IN_PROGRESS
+    IN_PROGRESS --> READY
+    IN_PROGRESS --> WAITING
+    IN_PROGRESS --> BLOCKED
+    WAITING --> IN_PROGRESS
+    BLOCKED --> IN_PROGRESS
+    READY --> TESTED
+    TESTED --> DONE
+    DONE --> CLOSED
+```
+
+## 🧪 Development
+
+### Setup Development Environment
+
+```bash
+# Clone repository
+git clone https://github.com/mcp-ticketerer/mcp-ticketerer.git
+cd mcp-ticketerer
+
+# Create virtual environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install in development mode with all dependencies
+pip install -e ".[dev,test,docs]"
+
+# Install pre-commit hooks
+pre-commit install
+```
+
+### Running Tests
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=mcp_ticketer --cov-report=html
+
+# Run specific test file
+pytest tests/test_adapters.py
+
+# Run tests in parallel
+pytest -n auto
+```
+
+### Code Quality
+
+```bash
+# Format code
+black src tests
+
+# Lint code
+ruff check src tests
+
+# Type checking
+mypy src
+
+# Run all checks
+tox
+```
+
+### Building Documentation
+
+```bash
+cd docs
+make html
+# View at docs/_build/html/index.html
+```
+
+## 📋 Roadmap
+
+### ✅ v0.1.0 (Current)
+- Core ticket model and state machine
+- JIRA, Linear, GitHub, AITrackdown adapters
+- Rich CLI interface
+- MCP server for AI integration
+- Smart caching system
+- Comprehensive test suite
+
+### 🚧 v0.2.0 (In Development)
+- [ ] Web UI Dashboard
+- [ ] Webhook Support
+- [ ] Advanced Search
+- [ ] Team Collaboration
+- [ ] Bulk Operations
+- [ ] API Rate Limiting
+
+### 🔮 v0.3.0+ (Future)
+- [ ] GitLab Issues Adapter
+- [ ] Slack/Teams Integration
+- [ ] Custom Adapters SDK
+- [ ] Analytics Dashboard
+- [ ] Mobile Applications
+- [ ] Enterprise SSO
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## 🙏 Acknowledgments
+
+- Built with [Pydantic](https://pydantic-docs.helpmanual.io/) for data validation
+- CLI powered by [Typer](https://typer.tiangolo.com/) and [Rich](https://rich.readthedocs.io/)
+- MCP integration using the [Model Context Protocol](https://github.com/anthropics/model-context-protocol)
+
+## 📞 Support
+
+- 📧 Email: support@mcp-ticketerer.io
+- 💬 Discord: [Join our community](https://discord.gg/mcp-ticketerer)
+- 🐛 Issues: [GitHub Issues](https://github.com/mcp-ticketerer/mcp-ticketerer/issues)
+- 📖 Docs: [Read the Docs](https://mcp-ticketerer.readthedocs.io)
+
+## ⭐ Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=mcp-ticketerer/mcp-ticketerer&type=Date)](https://star-history.com/#mcp-ticketerer/mcp-ticketerer&Date)
+
+---
+
+Made with ❤️ by the MCP Ticketer Team

mcp_ticketer-0.1.1.dist-info/RECORD

@@ -0,0 +1,35 @@
+mcp_ticketer/__init__.py,sha256=ayPQdFr6msypD06_G96a1H0bdFCT1m1wDtv8MZBpY4I,496
+mcp_ticketer/__version__.py,sha256=qSqPXA3OEKZmdvDrsW7qILCtjGikygqmeWhMrBtY1qY,1114
+mcp_ticketer/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mcp_ticketer/adapters/__init__.py,sha256=_QRLaX38EUsL-kMvJITY0lYHvrq_ip9Qw4Q1YLavJSo,283
+mcp_ticketer/adapters/aitrackdown.py,sha256=ICNimTtF6rPajuVoVEpmdw2TfjYjnWvao8prUwukNn0,15210
+mcp_ticketer/adapters/github.py,sha256=5vv_BwjPTJOY0sLFQv342Cz2u8PtS51RV7AK0-NEsLo,35357
+mcp_ticketer/adapters/jira.py,sha256=rd-8PseTsRyQNPjsrUJ8vJ8vfBpa6HWFBieOUyvw0Tg,28954
+mcp_ticketer/adapters/linear.py,sha256=PYqR30h223un50_Z-0lepPyIasK2uVHyL11mfPqtWV0,44119
+mcp_ticketer/cache/__init__.py,sha256=MSi3GLXancfP2-edPC9TFAJk7r0j6H5-XmpMHnkGPbI,137
+mcp_ticketer/cache/memory.py,sha256=gTzv-xF7qGfiYVUjG7lnzo0ZcqgXQajMl4NAYUcaytg,5133
+mcp_ticketer/cli/__init__.py,sha256=YeljyLtv906TqkvRuEPhmKO-Uk0CberQ9I6kx1tx2UA,88
+mcp_ticketer/cli/main.py,sha256=j8rLLKIB1CtwN9ayrCw8CP35_18BqPdj1LfUeIWuCe0,25775
+mcp_ticketer/cli/queue_commands.py,sha256=f3pEHKZ43dBHEIoCBvdfvjfMB9_WJltps9ATwTzorY0,8160
+mcp_ticketer/cli/utils.py,sha256=NxsS91vKA8xZnDXKU2y0Gcyc4I_ctRyJj-wT7Xd1Q_Q,18589
+mcp_ticketer/core/__init__.py,sha256=NA-rDvwuAOZ9sUZVYJOWp8bR6mOBG8w_5lpWTT75JNI,318
+mcp_ticketer/core/adapter.py,sha256=Hh4G9Ri1afchfpRSX8z971roXf50kmyyDD98zbRxSEk,5442
+mcp_ticketer/core/config.py,sha256=9a2bksbcFr7KXeHSPY6KoSP5Pzt54utYPCmbM-1QKmk,13932
+mcp_ticketer/core/http_client.py,sha256=RM9CEMNcuRb-FxhAijmM_FeBMgxgh1OII9HIPBdJue0,13855
+mcp_ticketer/core/mappers.py,sha256=8I4jcqDqoQEdWlteDMpVeVF3Wo0fDCkmFPRr8oNv8gA,16933
+mcp_ticketer/core/models.py,sha256=K-bLuU_DNNVgjHnVFzAIbSa0kJwT2I3Hj24sCklwIYo,4374
+mcp_ticketer/core/registry.py,sha256=fwje0fnjp0YKPZ0SrVWk82SMNLs7CD0JlHQmx7SigNo,3537
+mcp_ticketer/mcp/__init__.py,sha256=Bvzof9vBu6VwcXcIZK8RgKv6ycRV9tDlO-9TUmd8zqQ,122
+mcp_ticketer/mcp/server.py,sha256=iWdXGYxtONY7P5YB8RJ-WwbJEaxSIGWIyCY5YOR8qU8,15669
+mcp_ticketer/queue/__init__.py,sha256=xHBoUwor8ZdO8bIHc7nP25EsAp5Si5Co4g_8ybb7fes,230
+mcp_ticketer/queue/__main__.py,sha256=kQd6iOCKbbFqpRdbIRavuI4_G7-oE898JE4a0yLEYPE,108
+mcp_ticketer/queue/manager.py,sha256=79AH9oUxdBXH3lmJ3kIlFf2GQkWHL6XB6u5JqVWPq60,7571
+mcp_ticketer/queue/queue.py,sha256=UgbIChWPiyI7BJNQ9DYA92D2jVMMtmVWBzotI5ML51A,11394
+mcp_ticketer/queue/run_worker.py,sha256=HFoykfDpOoz8OUxWbQ2Fka_UlGrYwjPVZ-DEimGFH9o,802
+mcp_ticketer/queue/worker.py,sha256=cVjHR_kfnGKAkiUg0HuXCnbKeKNBBEuj0XZHgIuIn4k,14017
+mcp_ticketer-0.1.1.dist-info/licenses/LICENSE,sha256=KOVrunjtILSzY-2N8Lqa3-Q8dMaZIG4LrlLTr9UqL08,1073
+mcp_ticketer-0.1.1.dist-info/METADATA,sha256=F55wT1Fco4HeDuvZkCpZldAvLC_WSvhdpTb-eBBw5-s,11176
+mcp_ticketer-0.1.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mcp_ticketer-0.1.1.dist-info/entry_points.txt,sha256=2V70xrJlC0xiIfRRD5yX8hxhh0mX_ZpkjtmOVrztAEU,111
+mcp_ticketer-0.1.1.dist-info/top_level.txt,sha256=WnAG4SOT1Vm9tIwl70AbGG_nA217YyV3aWFhxLH2rxw,13
+mcp_ticketer-0.1.1.dist-info/RECORD,,

mcp_ticketer-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

mcp_ticketer-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+mcp-ticketer = mcp_ticketer.cli.main:main
+mcp-ticketer-server = mcp_ticketer.mcp.server:main

mcp_ticketer-0.1.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 MCP Ticketer Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mcp_ticketer-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+mcp_ticketer