This commit is contained in:
1 parent
23b1cb2966
commit
e9532e8878
30 files changed
+1835
-542
No files matched your search
+58
-15
@@ -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
|
||||
|
||||
Reference in new issue
Block a user