BUG-TRACKING-SYSTEM.md•2.76 kB
# Bug Tracking System - Revenue Engine MCP
## Bug UID Format
`[CATEGORY]-[NUMBER]` (e.g., `EMAIL-001`, `DEPLOY-003`)
## Categories
- **EMAIL** - Gmail integration issues
- **DEPLOY** - Deployment and infrastructure issues
- **MATRIX** - Knowledge Matrix system issues
- **PIPELINE** - Lead management issues
- **CALENDAR** - Google Calendar integration issues
- **API** - Apps Script API issues
- **MCP** - MCP server issues
- **AUTH** - Authentication/permissions issues
- **DATA** - Data integrity/corruption issues
- **PERF** - Performance issues
## Severity Levels
- **CRITICAL** - System down, data loss, security breach
- **HIGH** - Major feature broken, blocking work
- **MEDIUM** - Feature partially broken, workaround exists
- **LOW** - Minor issue, cosmetic, edge case
## Status Values
- **NEW** - Just discovered, not started
- **INVESTIGATING** - Root cause analysis in progress
- **IN PROGRESS** - Actively working on fix
- **TESTING** - Fix deployed, needs verification
- **FIXED** - Verified working
- **WONTFIX** - Not addressing (document reason)
## Matrix Entry Format
When logging bugs in the Knowledge Matrix "Bugs & Fixes" topic, use this format:
```
[TIME] [UID] [STATUS] [SEVERITY] Brief description
- Root cause: ...
- Solution: ...
- Time spent: X sessions/hours
- Related: [OTHER-BUG-UID] (if applicable)
```
### Example:
```
3:00pm CST EMAIL-001 FIXED HIGH get_email_content tool not working
- Root cause: MCP server pointing to old deployment @23, isStarred() invalid
- Solution: Removed isStarred(), created deployment @25, updated MCP URL
- Time spent: 1 session (~30 mins)
- Status: ✅ VERIFIED
```
## Bug Registry (Active Bugs)
### EMAIL-001 ✅ FIXED
- **Date**: 2025-10-16
- **Severity**: HIGH
- **Description**: get_email_content returning "Unknown action: getEmailContent"
- **Root Cause**: MCP server pointing to old deployment; isStarred() not valid Gmail API method
- **Solution**: Created deployment @25 without isStarred(), updated MCP URL
- **Time Spent**: 1 session (~30 mins)
- **Status**: FIXED & VERIFIED
---
## Historical Bug Reference
To find all bugs by category:
- Use Matrix `query_matrix` with keyword searches like "EMAIL-" or "DEPLOY-"
- Track time by counting sessions/entries per bug UID
- Analyze patterns: which categories have most issues?
## Metrics to Track
- **Total bugs by category** - Which systems need attention?
- **Time to resolution** - How long does each severity level take?
- **Reopened bugs** - Quality of fixes?
- **Most common root causes** - Deployment issues? API changes?
## Future Enhancements
- [ ] Automated bug UID generation
- [ ] Bug dashboard in Revenue Engine
- [ ] Link bugs to specific code commits
- [ ] Time tracking automation
- [ ] Bug frequency heatmap