         ┌───────────────────────────────┐
         │  User / Developer             │
         │  (Windows, Mac, Linux)        │
         └──────────────┬────────────────┘
                        │
                        ▼
              ┌────────────────────┐
              │  CLI Interface     │
              │  (click + rich)    │
              └────────┬───────────┘
                       │
                       ▼
            ┌─────────────────────────┐
            │  Scanner Engine         │
            │  (Regex + Entropy)      │
            └────────┬────────────────┘
                     │
      ┌──────────────┼───────────────┐
      │                              │
      ▼                              ▼
┌──────────────┐           ┌────────────────┐
│ Regex Engine │           │ Entropy Engine │
│ (patterns.py)│           │ (entropy.py)   │
└──────┬───────┘           └──────┬─────────┘
       │                          │
       └─────┬────────────┬───────┘
             ▼            ▼
   ┌──────────────────────────────┐
   │ Aggregated Findings List     │
   └────────────┬─────────────────┘
                ▼
     ┌──────────────────────────┐
     │ Reporter Module          │
     │ (Table Output + Exit Code)│
     └────────────┬─────────────┘
                  ▼
     ┌──────────────────────────┐
     │ Pre-commit Hook (Optional)│
     └──────────────────────────┘
