script_Überprüfung und Kommentarheader
Deploy mindnet to llm-node / deploy (push) Successful in 4s

This commit is contained in:
Lars committed 2025-12-28 10:40:28 +01:00
1 parent 23b1cb2966
commit e9532e8878
30 files changed
+1835 -542

No files matched your search

+58 -15
View File
@@ -1,23 +1,66 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
scripts/validate_edges.py
FILE: scripts/validate_edges.py
VERSION: 2.1.0 (2025-12-15)
STATUS: Active
COMPATIBILITY: v2.9.1 (Post-WP14/WP-15b)
Validiert die von WP-03 erzeugten Edges in Qdrant:
- Zählt Kanten je Typ (references, backlink, references_at)
- Prüft: Für jede "references" (resolved) existiert eine "backlink"-Gegenkante
- Prüft: "backlink" darf nicht "unresolved" sein
- Prüft: "references_at".source_id existiert in {prefix}_chunks
- Prüft: "references"/"backlink" source/target existieren in {prefix}_notes
- Prüft: doppelte edge_id (sollte 0 sein, da UUIDv5 aus edge_id)
Gibt ein kompaktes JSON-Resultat + optionale Detail-Listen aus.
Zweck:
-------
Validiert die Integrität der Edges in Qdrant.
Prüft strukturelle Korrektheit, Referenz-Integrität und Konsistenz.
Umgebung/Parameter:
- QDRANT_URL (Default: http://127.0.0.1:6333)
- QDRANT_API_KEY (optional)
- COLLECTION_PREFIX (Default: mindnet)
Funktionsweise:
---------------
1. Lädt alle Edges aus {prefix}_edges
2. Führt mehrere Validierungen durch:
- Zählt Edges nach Typ (references, backlink, etc.)
- Prüft: Für jede "references" existiert "backlink"-Gegenkante
- Prüft: "backlink" darf nicht "unresolved" sein
- Prüft: "references_at".source_id existiert in chunks
- Prüft: source/target existieren in notes
- Prüft: doppelte edge_id (sollte 0 sein)
3. Gibt kompaktes JSON-Resultat + optionale Detail-Listen aus
Beispiel:
python scripts/validate_edges.py --prefix mindnet
Ergebnis-Interpretation:
------------------------
- Ausgabe: JSON mit Validierungs-Ergebnissen
* counts_by_kind: Anzahl Edges pro Typ
* validation_results: Ergebnisse der einzelnen Prüfungen
* issues: Liste gefundener Probleme (optional mit --verbose)
- Exit-Code 0: Alle Validierungen bestanden
- Exit-Code 1: Validierungsfehler gefunden
Verwendung:
-----------
- Qualitätskontrolle nach Importen
- Debugging von Graph-Problemen
- CI/CD-Validierung
Hinweise:
---------
- Prüft strukturelle Integrität, nicht semantische Korrektheit
- Kann bei großen Graphen langsam sein
Aufruf:
-------
python3 -m scripts.validate_edges --prefix mindnet
python3 -m scripts.validate_edges --prefix mindnet --verbose
Parameter:
----------
--prefix TEXT Collection-Präfix (Default: ENV COLLECTION_PREFIX oder mindnet)
--verbose Zeigt detaillierte Problem-Listen
Umgebungsvariablen:
-------------------
QDRANT_URL (Default: http://127.0.0.1:6333), QDRANT_API_KEY, COLLECTION_PREFIX
Änderungen:
-----------
v2.1.0 (2025-12-15): Dokumentation aktualisiert
v1.0.0: Initial Release
"""
from __future__ import annotations
import argparse