Xophz Bug-Catching Net
Collaborative beta issue reporter and bug hunting utility for testers and site stakeholders.
by Hall of the Gods, Inc. · github.com/hallofthegods/xophz-compass-bugnet · website
Install
The author publishes release zips, so WP-CLI can install straight from GitHub:
wp plugin install https://github.com/hallofthegods/xophz-compass-bugnet/releases/download/v26.9.5/xophz-compass-bugnet-26.9.5.zipDeclares an update source (https://github.com/HalloftheGods/xophz-compass-bugnet), so updates arrive through the plugin's own updater.
Readme
Xophz Bug-Catching Net
Category: Wizard's Tower · Version: 0.0.1
The official bug-catching and tracking engine for the COMPASS platform.
Description
Bug-Catching Net leverages a dedicated WordPress Custom Post Type (compass_bug) to log, monitor, and resolve system issues. It acts as an integrated issue tracker with automatic runtime error interception - catching bugs before users even report them.
Core Capabilities
- Custom Post Type –
compass_bugstores Title, Description, Environment, Status, and Priority. - Automatic Error Interception – Catches uncaught JS errors, unhandled Promise rejections, and Vue component lifecycle errors.
- Fingerprint Deduplication – Identical errors within 10 seconds are suppressed.
- Batched Queue – Posts flushed in batches of 5 every 2 seconds to avoid API floods.
- Vue Dashboard – Card-based bug tracking UI with search, filters, and inline editing.
Bug Status Lifecycle
| Status | Description |
|---|---|
new |
Newly reported, awaiting triage |
in-progress |
Actively being worked on |
resolved |
Fix applied and tested |
closed |
Verified complete |
Priority Levels
| Priority | Description |
|---|---|
low |
Minor visual inconsistencies |
medium |
Expected functionality issues, non-blocking |
high |
Severe operational failure |
critical |
Total system failure, data loss, or security vulnerability |
Automatic Error Interception
The interceptor hooks into three error surfaces:
| Source | Catches |
|---|---|
window.addEventListener('error') |
Uncaught JS errors |
window.addEventListener('unhandledrejection') |
Failed async/await, unhandled Promises |
app.config.errorHandler |
Vue component lifecycle errors |
Auto-generated bugs use [Auto] title prefix, new status, and high/critical priority based on source.
Requirements
- Xophz COMPASS parent plugin (active)
- WordPress 5.8+, PHP 7.4+
Installation
- Ensure Xophz COMPASS is installed and active.
- Upload
xophz-compass-bugnetto/wp-content/plugins/. - Activate through the Plugins menu.
- Access via the My Compass dashboard → Bug Net.
Frontend Routes
| Route | View | Description |
|---|---|---|
/bugnet |
Dashboard | Card grid with search, status/priority filters, and "Report Bug" dialog |
/bugnet/:id |
Detail | Single bug view with inline status/priority editing |
PHP Class Map
| Class | File | Purpose |
|---|---|---|
Xophz_Compass_Bugnet |
class-xophz-compass-bugnet.php |
Core plugin hooks |
Xophz_Compass_Bugnet_CPT |
class-xophz-compass-bugnet-cpt.php |
Custom Post Type, meta box, REST fields |
Changelog
0.0.1
- Initial release with CPT-based bug tracking, automatic error interception, and Vue dashboard
Read the full README on GitHub →
Releases
| Tag | Published | Asset | Downloads |
|---|---|---|---|
| v26.9.5 | Sep 5, 2026 | xophz-compass-bugnet-26.9.5.zip | 2 |
| v26.9.3 | Sep 4, 2026 | xophz-compass-bugnet-26.9.3.zip | 2 |
| v26.9.4 | Sep 4, 2026 | xophz-compass-bugnet-26.9.4.zip | 1 |
| v26.9.1 | Sep 2, 2026 | xophz-compass-bugnet-26.9.1.zip | 1 |
| v26.9.2 | Sep 2, 2026 | xophz-compass-bugnet-26.9.2.zip | 1 |
| v26.8.30 | Aug 31, 2026 | xophz-compass-bugnet-26.8.30.zip | 1 |
| v26.8.31 | Aug 31, 2026 | xophz-compass-bugnet-26.8.31.zip | 1 |
| v26.5.2 | May 3, 2026 | xophz-compass-bugnet-26.5.2.zip | 4 |
| v26.5.3 | May 3, 2026 | xophz-compass-bugnet-26.5.3.zip | 0 |
| v26.4.30 | Apr 30, 2026 | xophz-compass-bugnet-26.4.30.zip | 1 |
| v26.4.29 | Apr 29, 2026 | xophz-compass-bugnet-26.4.29.zip | 1 |
| v26.4.28 | Apr 28, 2026 | xophz-compass-bugnet-26.4.28.zip | 3 |
| v26.4.27 | Apr 27, 2026 | xophz-compass-bugnet-26.4.27.zip | 1 |