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.27.2 — check with pip show purple8-hyper-graph |
| Python version | ✅ | 3.11.9 — check with python --version |
| OS | ✅ | macOS 15.2, Ubuntu 22.04, etc. |
| Installation method | ✅ | pip install / Docker / source |
| Logs / stack traces | Optional | Paste any error 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
- Vector / HNSW Search
- Cypher Query Language
- Journey Engine
- REST / GraphQL API
- MCP Server
- CDC / Event Bus
- KMS / Encryption
- SDKs (Python / TypeScript)
- Documentation
- Docker / 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 |