🛡️ GuardScan

100% मुफ़्त और ओपन सोर्स • गोपनीयता-प्रथम सुरक्षा स्कैनिंग और AI कोड समीक्षा CLI

  ____ _   _   _    ____  ____    ____   ____    _    _   _            ____ _     ___ 
 / ___| | | | / \  |  _ \|  _ \  / ___| / ___|  / \  | \ | |          / ___| |   |_ _|
| |  _| | | |/ _ \ | |_) | | | | \___ \| |     / _ \ |  \| |  _____  | |   | |    | |
| |_| | |_| / ___ \|  _ <| |_| |  ___) | |___ / ___ \| |\  | |_____| | |___| |___ | | 
 \____|\___/_/   \_\_| \_\____/  |____/ \____/_/   \_\_| \_|          \____|_____|___|

 Privacy-First AI Code Review & Security Scanning

---

🎉 पूरी तरह से मुफ़्त - कोई सदस्यता नहीं, कोई सीमा नहीं

GuardScan 100% मुफ़्त और ओपन सोर्स है! कोई क्रेडिट सिस्टम नहीं, कोई पेवॉल नहीं, कोई सदस्यता नहीं।

आपको क्या मिलता है (सब कुछ मुफ़्त)

• ✅ असीमित स्टैटिक विश्लेषण - 9 सुरक्षा स्कैनर + कोड गुणवत्ता उपकरण
• ✅ AI-संवर्धित कोड समीक्षा - अपनी API कुंजी लाएँ (OpenAI, Claude, Gemini, Ollama)
• ✅ पूरी तरह से ऑफ़लाइन काम करता है - स्टैटिक विश्लेषण के लिए इंटरनेट की आवश्यकता नहीं
• ✅ गोपनीयता-प्रथम - आपका सोर्स कोड कभी अपलोड नहीं करता
• ✅ कोई उपयोग सीमा नहीं - असीमित LOC, असीमित रिपॉज़िटरी स्कैन करें

---

🚀 त्वरित शुरुआत

# Install globally via npm
npm install -g guardscan

# Initialize GuardScan
guardscan init

# Run comprehensive security scan (100% FREE, offline)
guardscan security

# Configure AI provider for enhanced review (optional, BYOK)
guardscan config

# Run AI-enhanced code review
guardscan run

# Check status
guardscan status

🐳 Docker / Alpine Linux

Docker वातावरण के लिए, विशेष रूप से Alpine Linux:

# Install dependencies first
apk add --no-cache python3 make g++ pkgconfig cairo-dev pango-dev \
  libjpeg-turbo-dev giflib-dev pixman-dev freetype-dev build-base git

# Install GuardScan
npm install -g guardscan

# Set home directory (important for Docker)
export GUARDSCAN_HOME=/app/.guardscan

# Initialize
guardscan init

प्रलेखन:

• 📖 व्यापक Docker गाइड - Linux, macOS और Windows के लिए पूर्ण गाइड
• 🐧 Docker और Alpine त्वरित संदर्भ - Alpine Linux-विशिष्ट त्वरित संदर्भ

---

📋 मुख्य विशेषताएँ

🔒 सुरक्षा स्कैनिंग (मुफ़्त, ऑफ़लाइन)

GuardScan में व्यापक सुरक्षा स्कैनर शामिल हैं:

1. सीक्रेट्स डिटेक्शन - हार्डकोडेड API कुंजियाँ, पासवर्ड, टोकन खोजें (20+ पैटर्न)
2. निर्भरता भेद्यताएँ - npm, pip, Maven, Cargo निर्भरताओं को स्कैन करें
3. OWASP टॉप 10 - SQL इंजेक्शन, XSS, असुरक्षित कॉन्फ़िग, CSRF, XXE
4. Docker सुरक्षा - Dockerfile और कंटेनर स्कैनिंग
5. इन्फ्रास्ट्रक्चर ऐज़ कोड - Terraform, CloudFormation, Kubernetes सुरक्षा
6. API सुरक्षा - REST और GraphQL एंडपॉइंट विश्लेषण

📊 कोड गुणवत्ता और विश्लेषण (मुफ़्त, ऑफ़लाइन)

7. कोड मेट्रिक्स - साइक्लोमैटिक जटिलता, Halstead मेट्रिक्स, रखरखाव सूचकांक
8. कोड स्मेल्स - 30+ विरोधी-पैटर्न (गॉड क्लासेस, लंबी विधियाँ, मैजिक नंबर)
9. लाइसेंस अनुपालन - निर्भरता लाइसेंस जाँचें (MIT, GPL, Apache, आदि)
10. अनुपालन जाँच - GDPR, HIPAA, PCI-DSS अनुपालन स्कैनिंग
11. लिंटर एकीकरण - ESLint, Pylint, RuboCop, आदि
12. LOC काउंटर - भाषा-जागरूक पंक्ति गणना (20+ भाषाएँ)

🧪 परीक्षण और प्रदर्शन (मुफ़्त, ऑफ़लाइन)

13. टेस्ट रनर - Jest, pytest, JUnit परीक्षण निष्पादित और विश्लेषण करें
14. म्यूटेशन टेस्टिंग - टेस्ट सूट की प्रभावशीलता सत्यापित करें (Stryker आवश्यक - वैकल्पिक)
15. प्रदर्शन परीक्षण - लोड परीक्षण और बेंचमार्किंग (k6 आवश्यक - वैकल्पिक)
16. SBOM जनरेशन - सॉफ़्टवेयर सामग्री की सूची (CycloneDX, SPDX)

नोट: प्रदर्शन और म्यूटेशन परीक्षण के लिए वैकल्पिक बाहरी टूल आवश्यक हैं।

🤖 AI-संवर्धित विशेषताएँ (BYOK - अपनी कुंजी लाएँ)

9 उन्नत AI-संचालित विशेषताएँ:

1. कोड एक्सप्लेनर (guardscan explain) - जटिल कोड समझें
2. कोड समीक्षा (guardscan review) - व्यापक AI कोड समीक्षा
3. कमिट जनरेटर (guardscan commit) - कमिट संदेश उत्पन्न करें
4. डॉक्स जनरेटर (guardscan docs) - स्वतः प्रलेखन उत्पन्न करें
5. टेस्ट जनरेटर (guardscan test-gen) - यूनिट परीक्षण उत्पन्न करें
6. रीफैक्टरिंग सुझाव (guardscan refactor) - कोड गुणवत्ता सुधारें
7. खतरा मॉडलिंग (guardscan threat-model) - सुरक्षा आर्किटेक्चर विश्लेषण
8. माइग्रेशन सहायक (guardscan migrate) - फ़्रेमवर्क/भाषा माइग्रेशन
9. इंटरैक्टिव चैट (guardscan chat) - RAG-संचालित कोडबेस प्रश्नोत्तर

🌍 बहु-भाषा समर्थन

7+ भाषाओं के लिए AST पार्सर:

• TypeScript/JavaScript
• Python
• Java
• Go
• Rust
• Ruby
• PHP
• C#

🔌 AI प्रदाता एकीकरण

अपनी पसंद का कोई भी AI प्रदाता कॉन्फ़िगर करें:

• OpenAI (GPT-4, GPT-4 Turbo, GPT-3.5)
• Anthropic Claude (Claude 3 Opus, Sonnet, Haiku)
• Google Gemini (Gemini Pro)
• Ollama (स्थानीय, गोपनीयता-केंद्रित - llama2, codellama, mistral)
• LM Studio (स्थानीय मॉडल)
• OpenRouter (कई मॉडलों तक पहुँच)

आप सीधे AI प्रदाता को भुगतान करते हैं - GuardScan कुछ भी शुल्क नहीं लेता!

---

🛠️ कमांड

सभी कमांड 100% मुफ़्त हैं, कोई सीमा नहीं!

कॉन्फ़िगरेशन कमांड

कमांड	विवरण
guardscan init	कॉन्फ़िग प्रारंभ करें, client_id उत्पन्न करें
guardscan config	AI प्रदाता और सेटिंग्स कॉन्फ़िगर करें
guardscan status	कॉन्फ़िगरेशन और रेपो जानकारी दिखाएँ
guardscan reset	स्थानीय कैश और कॉन्फ़िग साफ़ करें

सुरक्षा और विश्लेषण कमांड

कमांड	विवरण
guardscan security	व्यापक सुरक्षा स्कैन चलाएँ (ऑफ़लाइन)
guardscan scan	त्वरित सुरक्षा स्कैन
guardscan run	AI-संवर्धित पूर्ण कोड समीक्षा (BYOK)

परीक्षण और गुणवत्ता कमांड

कमांड	विवरण
guardscan test	परीक्षण और कोड गुणवत्ता विश्लेषण चलाएँ
guardscan perf	प्रदर्शन परीक्षण और लोड परीक्षण (k6 आवश्यक - वैकल्पिक)
guardscan mutation	परीक्षण गुणवत्ता के लिए म्यूटेशन परीक्षण (Stryker आवश्यक - वैकल्पिक)

नोट: perf और mutation कमांड के लिए वैकल्पिक बाहरी टूल्स आवश्यक हैं। इंस्टॉलेशन और उपयोग विवरण के लिए Testing Tools Guide देखें।

उपयोगिता कमांड

कमांड	विवरण
guardscan sbom	Software Bill of Materials उत्पन्न करें
guardscan rules	कस्टम YAML-आधारित रूल इंजन

AI-संचालित कमांड (BYOK)

कमांड	विवरण
guardscan explain <file>	बताएँ कि कोड कैसे काम करता है
guardscan review <file>	व्यापक AI कोड समीक्षा
guardscan commit	कमिट संदेश उत्पन्न करें
guardscan docs <file>	स्वतः दस्तावेज़ीकरण उत्पन्न करें
guardscan test-gen <file>	यूनिट परीक्षण उत्पन्न करें
guardscan refactor <file>	रिफैक्टरिंग सुझाव प्राप्त करें
guardscan threat-model	सुरक्षा आर्किटेक्चर विश्लेषण
guardscan migrate	फ्रेमवर्क/भाषा माइग्रेशन सहायता
guardscan chat	कोडबेस के बारे में इंटरैक्टिव प्रश्नोत्तर (RAG)

---

🔒 गोपनीयता की गारंटी

हम गोपनीयता को गंभीरता से लेते हैं:

❌ कभी संग्रहीत या प्रसारित नहीं