Reporting Issues
Found a bug or have a feature idea? Here's how to let us know.
🐛 Bug Reports
Use our structured bug report form to ensure we can reproduce and fix the issue quickly:
What to include
| Field | Required | Example |
|---|---|---|
| Description | ✅ | "Vector search returns 0 results after node deletion" |
| Steps to reproduce | ✅ | Minimal code snippet or API calls to trigger the bug |
| Expected behaviour | ✅ | "Should return 5 nearest neighbours" |
| Actual behaviour | ✅ | "Returns empty list with no error" |
| Purple8 version | ✅ | 0.72.0 — check with pip show purple8-hyper-graph |
| Python version | ✅ | 3.12.x — check with python --version |
| OS / Platform | ✅ | macOS 15, Ubuntu 24.04, Red Hat Enterprise Linux 9 / OpenShift, etc. |
| Deployment mode | ✅ | Embedded pip install / Docker (:developer or :0.72.0) / Red Hat UBI9 |
| Logs / stack traces | Optional | Paste structured JSON/console log output |
Tips for a great bug report
- Minimal reproduction — strip your code down to the smallest example that triggers the bug
- Include the full stack trace — don't truncate error messages
- Check your version — make sure you're on the latest release before reporting:bash
pip install --upgrade purple8-hyper-graph - Search existing issues — someone may have already reported it: Search issues
💡 Feature Requests
Have an idea for a new feature or improvement? We'd love to hear it:
What to include
| Field | Required | Description |
|---|---|---|
| Problem / motivation | ✅ | What problem does this solve? Why do you need it? |
| Proposed solution | ✅ | How you'd like it to work (API examples welcome) |
| Alternatives considered | Optional | Workarounds you've tried |
| Area | ✅ | Which part of Purple8 this relates to (Core Engine, Journey Engine, MCP, etc.) |
Feature request areas
Our issue template includes these categories:
- Core Engine (
GraphEngine,BrickCoreStorage/ Cortex,BrickWAL,CortexAutoConfig) - Vector / HNSW & Hybrid Search (
graph_guided_search, BM25) - Cypher Query Language & Cost-Based Planner
- Journey Engine (Workflows, SLA Monitor, HITL Gates)
- RAG Studio (
rag.hybrid_query,rag.profile_collection,rag.tune_collection) - MCP Server (125 tools across 16 namespaces,
/mcp/sse) - DocIntel Integration (70+ formats, 75+ languages)
- Industry Verticals (AEC / BIM, SOC Threat Detection, Quantum QUBO/Ising, Evolutionary Optimization)
- Enterprise & Clustering (Raft HA, Horizontal Sharding, Supergraph Federation, Multi-Tenancy)
- KMS & Envelope Encryption (
Local,Vault,AWS,GCP,Azure) - Docker / Red Hat UBI9 / OpenShift Deployment
🔒 Security Vulnerabilities
Do not open a public issue for security vulnerabilities.
Report them privately to security@purple8.ai. See the full Security Policy for details on our responsible disclosure process and response timeline.
Where to Find Issues
- All open issues: github.com/Purple8-Technologies/purple8-hyper-graph/issues
- Bugs only: Filter by
buglabel - Feature requests: Filter by
enhancementlabel
Other Channels
| Channel | Contact |
|---|---|
| General questions | hello@purple8.ai |
| Enterprise enquiries | enterprise@purple8.ai |
| Security reports | security@purple8.ai |
| Documentation | docs.graph.purple8.ai |