# 📦 Installation Guide

## ⚡ Schnellstart (empfohlen)

```bash
# 1. Source Tarball herunterladen (enthält ALLE Dateien)
cd /tmp
wget https://gitea.die-heimatlosen.eu/arch_agent/aegisaur/archive/master.tar.gz

# 2. Entpacken
tar xzf master.tar.gz
cd aegisaur

# 3. Verifizieren (alle 7 Dateien müssen da sein)
ls src/
# → config.rs, hook.rs, ioc_fetcher.rs, main.rs, scanner.rs, trust_scorer.rs, utils.rs

# 4. Bauen und installieren
cargo build --release
sudo cp target/release/aegisaur /usr/local/bin/
sudo aegisaur install-hook
```

## ⚠️ WICHTIG: Git-Clone NICHT verwenden!

```bash
# ❌ NICHT SO - Fehlende Dateien!
git clone https://gitea.die-heimatlosen.eu/arch_agent/aegisaur.git

# Warum: Gitea API zeigt Dateien >10KB nicht korrekt an
# (ioc_fetcher.rs, scanner.rs, trust_scorer.rs fehlen)
```

## Alternative: PKGBUILD

```bash
cd /tmp/aegisaur
makepkg -si
```

## ALPM-Hook (systemweit)

```bash
# Installiert Hook nach /usr/share/libalpm/hooks/
sudo aegisaur install-hook

# Deinstalliert Hook
sudo aegisaur remove-hook
```

## Konfiguration

```bash
# Erstellt ~/.config/aegisaur/config.toml
aegisaur config
```

## Pfad-Übersicht

| Komponente | Pfad |
|------------|------|
| Binary (makepkg) | `/usr/bin/aegisaur` |
| Binary (manuell) | `/usr/local/bin/aegisaur` |
| ALPM-Hook | `/usr/share/libalpm/hooks/99-aegisaur.hook` |
| Hook-Script | `/usr/share/libalpm/hooks/aegisaur-check.sh` |
| Dokumentation | `/usr/share/doc/aegisaur/` |
| Config | `~/.config/aegisaur/config.toml` |
| Cache | `~/.cache/aegisaur/` |
| Quellcode | `/home/arch_agent_system/.openclaw/workspace/aegisaur/` |
| Gitea-Repo | `https://gitea.die-heimatlosen.eu/arch_agent/aegisaur` |

## Hook-Verhalten

| Paket-Status | Aktion |
|--------------|--------|
| **IOCDetected** | 🚨 Alert, Installation abbrechen möglich |
| **Dangerous** | 🚨 Alert, Installation abbrechen möglich |
| **Suspicious** | ⚠️ Warnung wird angezeigt |
| **Warning** | ⚠️ Warnung wird angezeigt |
| **Safe** | ✅ Keine Meldung |

---
*Built with ❤️ (and some 👻 magic)*
*Quasi & Thuumate — 2026*