Vultisignal — Enhanced Dashboard Features

Overview

The unified HTML dashboard generator creates comprehensive Vultisignal dashboards using Jinja2 templates, working directly with native GitHub JSON data. The system supports both enhanced (full-featured) and simple (debugging) dashboard modes.

Features

Core Sections

• Summary Overview - Comprehensive metrics including active repositories, issues, PRs, bugs, and high-priority items
• Cross-Platform Bugs - Issues affecting multiple platforms (iOS/Android/Windows)
• High-Priority Issues - Issues requiring immediate attention
• Stale Items - Issues and PRs open for 2+ weeks without activity
• Development Activity - Repository hotspots with commit activity
• Contributor Activity - Most active committers across all repos
• Recent Releases - Latest releases across the ecosystem
• Active Pull Requests - Currently open PRs with author and timing

Advanced Analytics

Cross-Platform Bug Detection

• Automatically groups similar issues across iOS, Android, Windows, and other platforms
• Uses repository names and issue labels to detect platform association
• Groups bugs by normalized titles to identify true cross-platform issues

Stale Item Detection

• Identifies issues and PRs with no activity for 14+ days
• Calculates exact staleness in days
• Sorts by staleness to prioritize oldest items

Development Hotspots

• Visual activity bars showing relative repository activity
• Combines commits, issues, and PRs into total activity score
• Provides summary statistics for development trends

Smart Prioritization

• Detects high-priority issues through multiple signals:
• "High Priority" labels
• Keywords like "urgent", "critical", "crash" in titles
• Recent activity patterns

Technical Implementation

Jinja2 Template System

• Unified Generator: Single html_generator.py handles both enhanced and simple dashboards
• Template Separation: Clean separation between data processing and presentation
• Maintainable: Easy to modify dashboard layout without touching core logic
• Extensible: Simple to add new dashboard sections or modify existing ones
• Base Template: Shared styling and structure via base.html

Native JSON Processing

• Works directly with GitHub API native format (no unified schema needed)
• Preserves all original GitHub metadata and links
• Timezone-aware datetime processing for accurate staleness calculation
• Separate timestamps for dataset collection vs. page generation

Robust Error Handling

• Graceful handling of missing or malformed date fields
• Continues processing even if individual items have data issues
• Comprehensive logging for troubleshooting

Performance Optimized

• Efficient grouping algorithms for cross-platform detection
• Smart sorting and filtering to handle large datasets
• Limited output (top 10-15 items per section) for fast rendering

Data Requirements

The dashboard requires GitHub JSON data with the following structure: - Repository metadata (name, description, stats) - Issues with labels, titles, created/updated dates, state - Pull requests with author, titles, created/updated dates, state
- Recent commits with author and date information - Release information with tags and publication dates