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

pip install melek-shell

💻 Kullanım Örnekleri

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))