# रिपॉजिटरी को क्लोन करें
git clone https://github.com/fr0gger/nova-claude-code-protector.git
cd nova_claude_code_protector

# वैश्विक रूप से स्थापित करें (हुक को ~/.claude/settings.json में पंजीकृत करता है)
./install.sh

# हुक को सक्रिय करने के लिए Claude Code को पुनरारंभ करें

./install.sh

./uninstall.sh

┌─────────────────────────────────────────────────────────────┐
│                    Claude Code Session                       │
├─────────────────────────────────────────────────────────────┤
│                                                              │
│  1. SessionStart Hook                                        │
│     └── Creates session JSONL file                          │
│     └── Initializes tracking with session ID                │
│                                                              │
│  2. PreToolUse Hook (Bash, Write, Edit)           [ACTIVE]  │
│     └── Scans commands BEFORE execution                     │
│     └── BLOCKS dangerous operations (rm -rf, etc.)          │
│                                                              │
│  3. PostToolUse Hook (Read, Bash, WebFetch, etc.) [PASSIVE] │
│     └── Scans tool OUTPUT for prompt injection              │
│     └── WARNS Claude if threats detected                    │
│     └── Records event with NOVA verdict                     │
│                                                              │
│  4. SessionEnd Hook                                          │
│     └── Generates interactive HTML report                   │
│     └── Creates AI-powered session summary                  │
│     └── Saves to .nova-tracer/reports/                      │
│                                                              │
└─────────────────────────────────────────────────────────────┘

# वर्तमान प्रोजेक्ट के लिए रिपोर्ट सूचीबद्ध करें
ls .nova-tracer/reports/

# अपने ब्राउज़र में एक रिपोर्ट खोलें
open .nova-tracer/reports/session-abc123.html

# नमूना हमले के परीक्षण चलाएं
uv run hooks/test-nova-guard.py --samples

# विशिष्ट पाठ का परीक्षण करें
uv run hooks/test-nova-guard.py --text "पिछले निर्देशों को अनदेखा करें"

# एक फ़ाइल का परीक्षण करें
uv run hooks/test-nova-guard.py --file suspicious.txt

# इंटरैक्टिव मोड
uv run hooks/test-nova-guard.py -i

# रिपोर्ट आउटपुट निर्देशिका
# खाली = {project}/.nova-tracer/reports/ (डिफ़ॉल्ट)
# सापेक्ष पथ = प्रोजेक्ट के सापेक्ष
# पूर्ण पथ = सटीक स्थान
report_output_dir: ""

# AI-संचालित सत्र सारांश
# केवल-आँकड़े सारांश का उपयोग करने के लिए false पर सेट करें (कोई API कॉल नहीं)
ai_summary_enabled: true

# रिपोर्ट में टूल आउटपुट के लिए अधिकतम आकार KB में
# बड़े आउटपुट को काट दिया जाएगा
output_truncation_kb: 10

# कस्टम NOVA नियमों के लिए निर्देशिका
custom_rules_dir: "rules/"

# स्तर 3 पहचान के लिए LLM प्रदाता
llm_provider: anthropic
model: claude-3-5-haiku-20241022

# पहचान स्तर (सक्षम/अक्षम)
enable_keywords: true
enable_semantics: true
enable_llm: true

# थ्रेसहोल्ड (0.0 - 1.0)
semantic_threshold: 0.7
llm_threshold: 0.7

# गंभीरता फ़िल्टर
min_severity: low  # low, medium, या high

# AI सारांश और LLM-स्तरीय पहचान के लिए आवश्यक
export ANTHROPIC_API_KEY=sk-ant-...

rule MyCustomRule
{
    meta:
        description = "मेरे विशिष्ट हमले के पैटर्न का पता लगाता है"
        author = "आपका नाम"
        severity = "high"
        category = "custom"

    keywords:
        $pattern1 = /मेरा regex पैटर्न/i
        $pattern2 = "सटीक स्ट्रिंग मिलान"

    semantics:
        $sem1 = "हमले का सिमैंटिक विवरण" (0.75)

    llm:
        $llm1 = "LLM के लिए मूल्यांकन करने का प्रश्न" (0.7)

    condition:
        any of ($pattern*) or $sem1 or $llm1
}

nova_claude_code_protector/
├── install.sh                    # वैश्विक स्थापना स्क्रिप्ट
├── uninstall.sh                  # हटाने की स्क्रिप्ट
├── config/
│   ├── nova-config.yaml          # NOVA स्कैनिंग कॉन्फ़िगरेशन
├── rules/
│   ├── instruction_override.nov  # ओवरराइड हमले के नियम
│   ├── roleplay_jailbreak.nov    # जेलब्रेक हमले के नियम
│   ├── encoding_obfuscation.nov  # एन्कोडिंग हमले के नियम
│   └── context_manipulation.nov  # संदर्भ हमले के नियम
├── hooks/
│   ├── session-start.py          # SessionStart हुक
│   ├── pre-tool-guard.py         # PreToolUse हुक (अवरुद्ध)
│   ├── post-tool-nova-guard.py   # PostToolUse हुक (स्कैनिंग)
│   ├── session-end.py            # SessionEnd हुक (रिपोर्ट)
│   ├── test-nova-guard.py        # परीक्षण उपयोगिता
│   └── lib/
│       ├── session_manager.py    # सत्र ट्रैकिंग तर्क
│       ├── report_generator.py   # HTML रिपोर्ट उत्पादन
│       ├── ai_summary.py         # AI सारांश उत्पादन
│       └── config.py             # कॉन्फ़िगरेशन प्रबंधन
├── tests/                        # व्यापक परीक्षण सूट (483 परीक्षण)
└── test-files/                   # नमूना इंजेक्शन फ़ाइलें

# मॉडल कैश साफ़ करें और पुनः प्रयास करें
rm -rf ~/.cache/huggingface/
uv run hooks/test-nova-guard.py --samples

# सभी परीक्षण चलाएं
uv run pytest tests/ -v

# विशिष्ट परीक्षण फ़ाइल चलाएं
uv run pytest tests/test_report_generator.py -v

# कवरेज के साथ चलाएं
uv run pytest tests/ --cov=hooks/lib