Was macht dev-experiment-031?
Wasserlinie – Offline, LLM-freier, dependencies-freier differenzieller Erreichbarkeitsanalysator für Agent-Skill-Bündel: Berechnet die erreichbare Hülle unter vier Resolver-Modellen und meldet, wo die Sicht eines Scanners von der eines Agenten abweicht (die Audit-Runtime-Lücke + Referenzwäsche).
Beschreibung
Wasserlinie analysiert Agent-Skill-Bündel, indem es die erreichbaren Ressourcen unter verschiedenen Auflösungsstrategien berechnet. Es vergleicht die statische Scanner-Sicht mit der dynamischen Agenten-Sicht und deckt Lücken auf.
Verwendung
# Installation (von GitHub)
git clone https://github.com/freyesperales/dev-experiment-031.git
cd dev-experiment-031
# Führe die Analyse aus (Details in der Quelldokumentation)
python waterline.py --bundle ./skill-bundle --resolver all
Resolver-Modelle
- Deklarativ: Erreichbarkeit basierend auf expliziten Import-/Export-Deklarationen.
- Prozedural: Simulation des tatsächlichen Kontrollflusses (z. B.
require(),import()). - Heuristisch: Fuzzy-Matching und Pfadauflösung ohne vollständige Semantik.
- Vollständig: Kombiniert alle drei oben genannten Modelle plus dynamische Proxy-Erkennung.
Audit-Runtime-Lücke
Die Lücke tritt auf, wenn ein Scanner eine Ressource nicht als erreichbar meldet, der Agent sie jedoch zur Laufzeit laden kann. Wasserlinie identifiziert diese Fälle präzise.
Referenzwäsche (Reference Laundering)
Referenzwäsche bezeichnet die indirekte Maskierung einer sensitiven Ressource durch eine Kette von Zwischenreferenzen (z. B. alias → symlink → proxy). Das Tool deckt solche verschleierten Pfade auf.
Abhängigkeiten
Keine externen Abhängigkeiten. Das Tool verwendet nur die Python-Standardbibliothek.
Lizenz
MIT