🛡️ DevGuard Pro - Configuration Guardian

Your project's comprehensive guardian for security, standards, and streamlined onboarding.

DevGuard Pro transforms your development workflow with real-time configuration validation, automated drift detection, and intelligent remediation—all with crystal-clear visual status indicators right in your VSCode sidebar.

🎯 Why DevGuard Pro?

Stop wondering if your setup is broken. DevGuard Pro provides immediate visual feedback about your project's health.

✅ Always Know Your Status

• Real-time validation panel in Explorer sidebar
• Visual indicators for all configuration states
• Instant feedback on what's working vs. what needs attention
• No more guessing if the extension is installed or working

🔍 Comprehensive Monitoring

• ESLint & MegaLinter configuration validation
• VSCode extensions alignment checking
• CI/CD pipeline status monitoring
• Security vulnerability scanning and reporting
• Configuration drift detection and remediation

🚀 Enterprise-Ready

• GitHub integration for team workflows
• Analytics dashboard with trend analysis
• Automated remediation for common issues
• Compliance reporting and export capabilities

🎯 Key Features

🌍 Environment Management ⭐ NEW in v5.2.0

Complete Development Environment Automation: DevGuard Pro now includes comprehensive environment management with:

• 🚀 One-Click Project Setup - Initialize projects with optimal tool configurations (.tool-versions, .envrc, Doppler)
• 🤖 Smart MCP Integrations - Context7, Supabase, Stripe, and Claude Console with seamless secret management
• 🔄 Fleet Management - Update development tools across multiple projects simultaneously
• 🩺 Environment Health Monitoring - Continuous diagnostics with auto-repair capabilities
• ⚡ Power User CLI Access - Full bash CLI compatibility for advanced workflows
• 🛠️ Visual Setup Wizard - Guided configuration with intelligent defaults

Environment Tree View:

🌍 Environment
├── ⚙️ Configuration (✅ Healthy)
│   ├── ✅ Tool Versions (.tool-versions)
│   └── ✅ Environment Variables (.envrc)
├── 🤖 MCP Servers
│   ├── ✅ Context7 (Documentation Assistant)
│   ├── ✅ Supabase (Database Operations)
│   ├── ✅ Stripe (Payment Processing)
│   └── ✅ Claude Console (Multi-Provider AI)
└── ⚡ Quick Actions
    ├── 🔄 Refresh Status
    ├── 🛠️ Open Setup Wizard
    └── 🩺 Run Environment Doctor

12 New Environment Commands:

• 🌍 Initialize Environment - Set up project with optimal configurations
• 🤖 Setup Anthropic/Z.AI - Configure AI providers and MCP servers
• 💳 Setup Stripe - Enable payment processing integrations
• 🚀 Fleet Update - Update tools across multiple projects
• 🩺 Environment Doctor - Comprehensive health diagnostics
• 🔍 Detect Environment - Scan and analyze current setup
• ⚡ Open CLI Tools - Access bash CLI for power users
• ...and more!

🛡️ Real-Time Status Monitoring

Explorer Sidebar Integration: DevGuard Pro adds dedicated panels to your Explorer sidebar:

• ✅ Configuration validation status with expandable details
• 🔍 Drift detection results with one-click fixes
• 🛡️ Security scan summaries with remediation guidance
• 🌍 Environment status with real-time health monitoring
• ⚡ Quick action buttons for common tasks

🚨 Smart Status Bar Indicators

Immediate Visual Feedback: The status bar shows DevGuard Pro with custom shield logo:

• 🛡️⟨⟩ DevGuard Pro (Ready/Unknown status)
• ✅🛡️⟨⟩ DevGuard Pro (All systems compliant)
• ❌🛡️⟨⟩ DevGuard Pro (Issues detected - click to fix)
• ⚠️🛡️ DevGuard Pro (Click to opt-in and get started)

📊 Comprehensive Dashboard

Rich Analytics Interface: Access detailed project insights through:

• Configuration health trends and metrics
• Environment status and MCP server monitoring
• Linting coverage and performance analytics
• Team collaboration patterns and statistics
• Export capabilities for compliance reporting

🚀 Quick Start

1. Install & Immediate Feedback

From VS Code Marketplace

code --install-extension HabitusNet.devguard-pro

For VS Code Insiders

code-insiders --install-extension HabitusNet.devguard-pro

Manual Installation (for testing)

1. Download devguard-pro-4.0.1.vsix from releases
2. Install using:

code --install-extension devguard-pro-4.0.1.vsix --force

✅ Immediate Visual Confirmation:

• Explorer Sidebar: Look for "🛡️ DevGuard Pro" panel
• Status Bar: See "🛡️⟨⟩ DevGuard Pro" indicator (bottom right)
• Activity Bar: DevGuard Pro activity icon (if configured)

2. Visual Status Check

• Open any workspace with a package.json or project files
• Check the DevGuard Pro panel in Explorer sidebar:
  • 🛡️ Configuration Status (with expandable details)
  • 🔍 Drift Detection (scanning for issues)
  • 🛡️ Security Scanning (vulnerability status)
  • ⚡ Quick Actions (refresh, run linters, open dashboard)
• Click on items to see detailed information and available fixes

3. Take Action & Test Functionality

• Use Quick Actions in the panel:
  • "Refresh Status" → Updates all validation data
  • "Check Drift" → Scans for configuration changes
  • "Run MegaLinter" → Executes comprehensive linting (if available)
  • "Open Dashboard" → Shows detailed analytics webview
• Command Palette (Ctrl+Shift+P / Cmd+Shift+P):
  • Search "DevGuard Pro" to see all available commands
  • Try "DevGuard Pro: Show Trust Signals" for compliance overview
• Status Bar Interaction: Click the status bar indicator for quick actions

📋 Features Overview

🔍 Real-Time Validation

⚡ Quick Actions

• 🔄 Refresh Status - Update all validation data
• 🔍 Check Drift - Scan for configuration changes
• 🚀 Run MegaLinter - Execute comprehensive analysis
• 📊 Open Dashboard - View detailed analytics
• 🔧 Auto-Fix Issues - Automated remediation

🎛️ Configuration States

✅ Healthy State

🛡️ DevGuard Pro
├── ✅ Configuration Status (95%)
│   ├── ✅ ESLint Configuration
│   ├── ✅ MegaLinter Setup (85% coverage)
│   ├── ✅ VSCode Extensions Aligned
│   └── ✅ CI/CD Pipeline (success)
├── ✅ Drift Detection (No drift detected)
└── ✅ Security Scanning (No vulnerabilities)

⚠️ Warning State

🛡️ DevGuard Pro
├── ⚠️ Configuration Status (70%)
│   ├── ✅ ESLint Configuration
│   ├── ⏳ MegaLinter Setup (pending)
│   ├── ❌ VSCode Extensions (2 missing)
│   └── ⏳ CI/CD Pipeline (pending)
├── ⚠️ Drift Detection (3 issues found)
│   ├── 📄 Config Issues (1)
│   └── 🔌 Extension Issues (2)
└── 🟡 Security Scanning (5 medium issues)

❌ Critical State

🛡️ DevGuard Pro
├── ❌ Configuration Status (30%)
│   ├── ❌ ESLint Configuration (Missing)
│   ├── ❌ No Linter Configuration
│   ├── ❌ VSCode Extensions (5 issues)
│   └── ❌ CI/CD Pipeline (failure)
├── 🔴 Drift Detection (8 issues found)
└── 🔴 Security Scanning (3 critical issues)

🛠️ Installation & Setup

Method 1: VSCode Marketplace ⭐ Recommended

1. Open VSCode
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for "DevGuard Pro"
4. Click Install
5. ✅ Immediate feedback: Check Explorer sidebar for DevGuard Pro panel

Method 2: Command Line

code --install-extension HabitusNet.devguard-pro

Method 3: VSIX File

code --install-extension devguard-pro-3.0.0.vsix

🔧 Post-Installation Setup

1. Welcome notification appears automatically
2. Click "View Validation Panel" to see current status
3. Use "Get Started" for guided setup if not opted in
4. Configure GitHub integration for CI/CD features

📖 User Guide

Understanding the Validation Panel

Configuration Status Section

• Trust Level Percentage: Overall health score
• Individual Components: Detailed status of each tool
• Performance Metrics: Coverage and efficiency scores
• Last Updated: Timestamp of latest validation

Drift Detection Section

• Config Issues: Configuration file problems
• Extension Issues: Missing or misaligned extensions
• MegaLinter Issues: Linter-specific problems
• Performance Issues: Optimization opportunities

Security Scanning Section

• Critical Issues 🔴: Immediate security risks
• High Issues 🟠: Important security concerns
• Medium Issues 🟡: Security improvements needed
• Low Issues 🟢: Minor security suggestions

Quick Actions Section

• Refresh Status: Manual validation update
• Check Drift: Comprehensive drift analysis
• Run MegaLinter: Execute full linting suite
• Open Dashboard: Detailed analytics view

Common Workflows

🆕 New Project Setup

1. Open project in VSCode
2. DevGuard Pro panel shows current state
3. Address any ❌ issues shown
4. Use Quick Actions for automated fixes
5. Monitor status until all items are ✅

🔄 Daily Development

1. Check panel for any drift alerts
2. Use Refresh Status if needed
3. Address new issues as they appear
4. Review security scan results regularly

🚨 Issue Resolution

1. Click on ❌ items for details
2. Use automated Fix buttons when available
3. Follow manual remediation guidance
4. Refresh to confirm fixes applied

🛠️ Troubleshooting & Repair

Extension Not Visible

Problem: Can't see DevGuard Pro panel in sidebar

Solutions:

1. Check Explorer: Panel appears in Explorer tab, not a separate view
2. Restart VSCode: Ctrl+Shift+P → "Developer: Reload Window"
3. Re-enable Extension: Extensions view → DevGuard Pro → Enable
4. Check Workspace: Panel only shows when workspace is open

No Status Updates

Problem: Panel shows "Loading..." or outdated information

Solutions:

1. Manual Refresh: Click refresh button in panel
2. Command Palette: Ctrl+Shift+P → "DevGuard Pro: Refresh Validation"
3. Check Permissions: Ensure file system access allowed
4. Restart Extension: Disable/Enable in Extensions view

Configuration Issues

Problem: ❌ status for tools that are installed

Solutions:

1. Check File Locations: Ensure config files are in project root
2. Validate Syntax: Check config file syntax is correct
3. Update Dependencies: npm install or yarn install
4. Reset Configuration: Use "Check Drift" → "Fix All"

Performance Issues

Problem: Extension running slowly or consuming resources

Solutions:

1. Adjust Refresh Rate: Increase validation interval in settings
2. Disable Unused Features: Turn off unneeded scanning
3. Check File Exclusions: Exclude large directories from scanning
4. Update Extension: Ensure latest version installed

⚙️ Configuration

Extension Settings

Access via: File → Preferences → Settings → Search "DevGuard Pro"

Workspace Configuration

Create .vscode/settings.json:

{
  "devguardPro.validation.enabled": true,
  "devguardPro.drift.checkInterval": 300000,
  "devguardPro.security.scanOnSave": true,
  "devguardPro.dashboard.autoOpen": false
}

🔌 Commands

All commands available via Command Palette (Ctrl+Shift+P):

🌍 Environment Management Commands ⭐ NEW

🚀 Advanced Features

GitHub Integration

• Automatic CI/CD Status: Real-time pipeline monitoring
• Repository Detection: Auto-configuration from git remotes
• Workflow Management: Setup and monitor GitHub Actions
• Team Collaboration: Shared standards and configurations

Analytics Dashboard

• Trend Analysis: Historical performance tracking
• Heat Maps: Issue distribution visualization
• Performance Metrics: Execution time and efficiency
• Export Capabilities: JSON, CSV, HTML, PDF formats

Enterprise Features

• Organization Standards: Centralized configuration management
• Compliance Reporting: Automated compliance tracking
• Team Analytics: Multi-developer insights
• Custom Integrations: API access for enterprise tools

📊 Metrics & Analytics

Key Performance Indicators

• Trust Level: Overall configuration health percentage
• Issue Count: Number of active configuration problems
• Drift Score: Measure of configuration deviation
• Security Rating: Vulnerability risk assessment
• Performance Score: Tool execution efficiency

Tracking Features

• Daily Metrics: Day-over-day performance tracking
• Trend Analysis: Long-term health trending
• Issue Resolution Time: Time to fix tracked issues
• Team Benchmarking: Compare against organization standards

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Development Setup

1. Clone repository: git clone https://github.com/devguard-pro/devguard-pro.git
2. Install dependencies: npm install
3. Open in VSCode: code .
4. Press F5 to launch Extension Development Host
5. Make changes and test with Ctrl+Shift+P → "Developer: Reload Window"

Reporting Issues

• Bug Reports: Use GitHub Issues with "bug" label
• Feature Requests: Use GitHub Issues with "enhancement" label
• Security Issues: Email security@devguard-pro.com

📄 License

MIT License - see LICENSE file for details.

🔗 Links

• Marketplace: Visual Studio Code Marketplace
• GitHub: Source Code Repository
• Documentation: User Guide & API Docs
• Installation Guide: Step-by-step Setup & Troubleshooting
• Changelog: Version History & Migration Guides
• Support: Issues & Support

🌍 Environment Management Documentation ⭐ NEW

• Environment Features: Complete Environment Management Guide

• Migration Guide: DevGuard Env → DevGuard Pro Migration

• Technical Integration: Architecture & Service APIs

• DevGuard Pro: Organization

Made with ❤️ by DevGuard Pro Team

Transform your development workflow. Install DevGuard Pro today.