Contributing & Community Feedback

Thank you for building with Purple8 Hyper Graph (v0.72.0)! We welcome bug reports, feature requests, custom MCP tool integrations, and feedback from developers, solution architects, and enterprise DevOps teams.

---

Ways to Contribute

🐛 Bug Reports

Found an issue in the Python SDK, Cypher engine, REST API, or MCP server? Open a bug report with:

• A clear, descriptive title
• Minimal steps or code snippet to reproduce the issue
• Expected vs. actual behaviour
• Your environment (OS, Python 3.12+ version, purple8-hyper-graph version 0.72.0, Docker or embedded mode)
• Relevant structured logs or stack traces

See Reporting Issues for a detailed walkthrough.

💡 Feature Requests

Have a use case for a new graph algorithm, MCP tool, Journey template, or connector? Open a feature request with:

• A clear description of the problem or workflow you're solving
• Your proposed API or MCP tool signature (e.g. graph.*, rag.*, journey.*)
• How it fits your deployment architecture (embedded SDK, Docker, or OpenShift)

🔌 Extending Purple8 with Custom MCP Tools

You can register custom domain tools and A2A agents directly into a running Purple8 instance without modifying core engine code using the registry.* MCP namespace:

• registry.register_tool — register a custom webhook or callable tool into the RBAC-governed catalog
• registry.register_mcp_server — federate an external MCP server
• registry.register_a2a_agent — register an Agent2Agent endpoint
• registry.list_tools / registry.test_tool — inspect and verify registered tools

🔒 Security Vulnerabilities

Do not open a public issue for security vulnerabilities. Please see the Security Policy for responsible disclosure instructions.

---

Verifying Your Local Environment

Before submitting a bug report or reproduction script, verify your installation on Python 3.12+:

python3.12 -m venv .venv
source .venv/bin/activate

# Install the latest v0.72.0 release
pip install --upgrade purple8-hyper-graph

# Verify version and Cortex engine health
python -c "import purple8_graph; from purple8_graph import GraphEngine; e = GraphEngine('./verify_db', auto_config=True); print('Purple8 ready, nodes:', e.count_nodes())"

---

Code of Conduct

We are committed to providing a welcoming, professional, and inclusive community. Please be respectful and constructive in all interactions.

---

Questions & Support Channels

Channel	Contact
General & Community	hello@purple8.ai
Enterprise Support & Licensing	enterprise@purple8.ai
Security Advisories	security@purple8.ai
Issue Tracker	GitHub Issues