SuperDiagnosticTool v1.0.4

Release v1.0.4 - Hotfix

🐛 Bug Fixes

• Fixed ModuleNotFoundError: No module named 'rich._unicode_data' startup crash.
• Updated build script to strictly collect all rich library assets.

SuperDiagnosticTool v1.0.2

SuperDiagnosticTool v1.0.2 - Security & Validation Enhancements

Release Date

February 10, 2026

Overview

This patch release focuses on improving API key validation and enhancing HTML report security to protect against potential vulnerabilities.

What's New

🔐 Enhanced API Key Validation

• Improved validation logic - Better format checking without over-sanitization
• Automatic error recovery - Invalid keys are detected and corrupted files are cleaned up automatically
• Better user feedback - Clear messages when keys are invalid or need replacement
• Prevents key corruption - Removed aggressive regex patterns that could damage valid keys

🛡️ HTML Report Security

• XSS Protection - Added comprehensive sanitization for AI-generated HTML content
• Script tag removal - Automatically strips potentially dangerous script and style tags
• Event handler filtering - Removes onclick, onload, and other event attributes
• User input escaping - Properly escapes user-provided problem descriptions
• Maintains formatting - Security improvements while preserving report readability

Technical Improvements

API Key Management

• New validate_key() function for proper format verification
• UTF-8 encoding for all key file operations
• Graceful handling of corrupted key files
• Enhanced error messages and debugging information

HTML Sanitization

• New sanitize_ai_html() function using regex patterns
• Removes <script> and <style> tags from AI responses
• Strips event handler attributes (on*)
• Uses html.escape() for user input fields
• Prevents potential XSS vulnerabilities

Security Notes

What's Protected

• ✅ User input in HTML reports (problem descriptions)
• ✅ AI-generated content in reports (analysis, recommendations)
• ✅ API key validation and storage
• ✅ Prevention of malicious script injection

Best Practices

• Always review generated HTML reports before sharing
• Keep your API key secure and don't share it
• Run the tool with administrator privileges only when necessary
• Review PowerShell scripts before execution

Installation

For Users

Download the latest executable:
SuperDiagnosticTool.exe

For Developers

git checkout v1.0.2
pip install -r requirements.txt
python super_diagnose_v2.py

Requirements

• Windows 10 or Windows 11
• Administrator privileges
• Google Gemini API Key (Get free key)

Upgrade Notes

From v1.0.1

No breaking changes. Simply replace your existing executable with the new version.
Your saved API key will be validated on first run.

What to Check After Upgrading

1. API key is loaded correctly on first run
2. HTML reports generate without errors
3. All security features work as expected

Known Issues

None at this time. Please report any issues on GitHub.

What's Next

Future releases will focus on:

• Additional safety features and validation
• Performance optimizations
• Extended hardware support
• More diagnostic capabilities

Contributors

• Knight (Guettaf Houssem Eddine) - Lead Developer

Support

• GitHub Issues: https://github.com/Guettaf-hossam/SuperDiagnosticTool/issues
• Email: hossam.guettaf@proton.me

License

GNU General Public License v3.0

---

Full Changelog: v1.0.1...v1.0.2

v1.0.1 - Official Release

Critical bug fix for API key persistence issue.

What's Fixed

• API key now persists correctly between sessions
• Fixed regex sanitization corrupting keys
• Fixed working directory confusion
• Fixed environment variable conflicts
• UTF-8 encoding for all file operations
• Better error messages and validation

Full Changelog: 1.0.0...v1.0.1

Official Release

SuperDiagnosticTool v1.0

First production release with production-grade security architecture.

Features

Safety-First Architecture

• 6-layer security pipeline: Knowledge Base validation, dry-run simulation, multi-level script validation, user confirmation, system restore points, and monitored execution
• Automatic system restore point creation before any modifications
• Enhanced monitoring with pre/post execution snapshots and change detection
• Multi-level script validation with blacklist, whitelist, and risk scoring (0-100)
• Sandbox execution environment with comprehensive logging
• Automatic rollback script generation

Knowledge Base

• 5 tested, known solutions for common Windows issues
• AI solution validation against proven remedies
• Success rate tracking (70-98%)

Intelligent Analysis

• Google Gemini AI integration for advanced system diagnostics
• Context-aware recommendations based on system telemetry
• Security auditing for suspicious processes and resource leaks

Comprehensive System Scanning

• Performance metrics: CPU usage (overall and per-core), memory breakdown, top resource consumers
• Network diagnostics: DNS configuration, Wi-Fi signal strength, connectivity tests
• Security integrity: Antivirus status, firewall profiles, Windows Update history
• Hardware health: Disk SMART status, GPU information, battery status
• System services: Startup applications, failed services, critical event logs

Universal Hardware Support

• Dynamic scaling for any CPU configuration (1-128+ cores)
• Optimized for low-spec systems (Intel Pentium) to high-end workstations (AMD Threadripper, Intel Xeon)
• Graceful fallbacks for unsupported hardware features

Technical Highlights

• Approximately 1,380 lines of safety and validation code
• 80+ whitelisted PowerShell commands and keywords
• Professional HTML diagnostic reports with dark theme
• Timestamped execution logs for full audit trail
• Change detection for services, registry keys, and startup items

Security

• Admin privilege verification for all remediation scripts
• PowerShell variable sanitization to prevent execution errors
• Service existence verification before any operations
• Non-destructive operations designed to prevent data loss
• Comprehensive error handling with try-catch blocks
• API key stored locally only (never transmitted except to Google Gemini API)

Installation

1. Download SuperDiagnosticTool.exe
2. Run as Administrator
3. Enter your Google Gemini API Key (obtain free key at https://makersuite.google.com/app/apikey)
4. Select scan mode and describe your system issue

Requirements

• Windows 10 or Windows 11
• Administrator privileges
• Google Gemini API Key

Known Issues

• Clean-DiskImage cmdlet may not be available on all Windows versions (non-critical, alternative cleanup methods used)
• Some Intel-specific services may not exist on AMD systems (expected behavior, safely skipped)

Notes

• First run will prompt for API key configuration
• All remediation scripts require explicit user confirmation
• System restore point automatically created before any system changes
• Full execution logs saved to AI_Reports directory
• All operations are logged, monitored, and reversible

What's New in v1.0

• Initial production release
• Complete 6-layer safety pipeline implementation
• Knowledge base with 5 tested solutions
• Enhanced monitoring and change detection
• Automatic rollback script generation
• Multi-level script validation system
• Sandbox execution environment

Built with safety, transparency, and user control as core principles.

Full Changelog: https://github.com/Guettaf-hossam/SuperDiagnosticTool/commits/1.0.0