Metadata-Version: 2.4
Name: melek-shell
Version: 1.0.0
Summary: Melek AI Asistan Projesi - 20x Gelişmiş Güvenlik Kalkanlı Gölge Terminal Modülü
Author: Melek AI Team
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: System :: Shells
Classifier: Topic :: Security
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: psutil>=5.0.0

# melek-shell 🛡️

Melek AI Asistan Projesi'nin 20x Gelişmiş, Sıfır-Güven (Zero-Trust) Güvenlik Kalkanlı ve Asenkron Gölge Terminal Köprüsü.

Bu kütüphane, Windows işletim sistemi üzerinde çalışan yapay zeka asistanlarının sistem komutlarını güvenli, arındırılmış ve oturum durumunu (dizin hafızası) koruyacak şekilde çalıştırmasını sağlar.

---

## ✨ 20x Güvenlik ve Mimari Özellikleri

1. **Oturum/Dizin Hafızası (Stateful CWD):** `cd` komutunu özel olarak algılar, tırnaklı/boşluklu yolları yönetir ve sonraki komutların o dizinde çalışmasını garanti eder.
2. **Gelişmiş Güvenlik Duvarı & Base64 Payload Denetimi:**
   - `rmdir /s`, `del /f /s`, `format`, `diskpart`, `reg delete` gibi tehlikeli CMD komutlarını engeller.
   - `Remove-Item -Recurse -Force`, `Format-Volume` gibi PowerShell yıkım komutlarını engeller.
   - **Şifreli Kod Çözücü:** `powershell -enc <base64>` şeklinde gizlenmiş zararlı komutları arka planda UTF-16LE çözüp içeriğindeki zararlı kodları yakalar ve engeller.
3. **Ortam Değişkeni Arındırma (Environment Sanitization):**
   - Alt süreçlerin ortam değişkenlerinden gizli API anahtarlarını, PyPI tokenlarını veya kimlik bilgilerini okumasını önler (`sanitize_env=True`).
4. **Yetim Süreç ve Ağaç Temizleyici (Process Tree Killer):**
   - Zaman aşımına uğrayan komutların arkasında kalan tüm çocuk/torun süreçleri (`psutil` ile) 2 saniyelik grace süresinin ardından zorla temizler.
5. **Çift Kanallı Canlı Akış (Streaming):** `stdout` ve `stderr` çıktılarını birbirine karıştırmadan gerçek zamanlı olarak stream callback fonksiyonuna iletir.
6. **Denetim Kayıtları (Audit Logging):** Çalıştırılan veya engellenen tüm komutları, çalışma sürelerini ve durumlarını hafızada denetim amacıyla saklar (`get_audit_log()`).
7. **Akıllı Takma Adlar (Alias):** Sık kullanılan komutlar için kısayol tanımları sağlar.

---

## 🚀 Kurulum

```bash
pip install melek-shell
```

---

## 💻 Kullanım Örnekleri

```python
from melek_shell import MelekShellController

# Güvenlik kalkanı ve ortam arındırması aktif başlat
shell = MelekShellController(default_timeout=20, sanitize_env=True)

# 1. Normal Komut Çalıştırma
result = shell.execute_command("echo Melek AI Çekirdek Hazır")
print(result["stdout"])

# 2. Dizin Değiştirme Hafızası
shell.execute_command('cd "C:\\Windows"')
res = shell.execute_command("dir")
print("C:\\Windows altındaki dosya satır sayısı:", len(res["stdout"]))

# 3. Güvenlik Duvarı Engellemesi
res_blocked = shell.execute_command("format d:")
print("Engellendi mi?:", not res_blocked["success"])
print("Hata:", res_blocked["stderr"])

# 4. Denetim Günlüğü
print("Son loglar:", shell.get_audit_log(limit=3))
```
