This commit is contained in:
1 parent
23b1cb2966
commit
e9532e8878
30 files changed
+1835
-542
No files matched your search
@@ -1,34 +1,66 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
Script: audit_edges_vs_expectations.py — Prüfe Kanten in Qdrant gegen Vault-Erwartungen
|
||||
Version: 1.0.0
|
||||
Datum: 2025-09-09
|
||||
FILE: scripts/audit_edges_vs_expectations.py
|
||||
VERSION: 2.1.0 (2025-12-15)
|
||||
STATUS: Active
|
||||
COMPATIBILITY: v2.9.1 (Post-WP14/WP-15b)
|
||||
|
||||
Zweck
|
||||
-----
|
||||
- Liest Edges/Chunks/Notes aus Qdrant.
|
||||
- Ermittelt erwartete Kanten-Anzahlen aus dem Vault:
|
||||
* belongs_to : sollte == #Chunks
|
||||
* next / prev : je Note (#Chunks_in_Note - 1)
|
||||
* references : Summe aller Chunk-Wikilinks
|
||||
* backlink : Summe einzigartiger Wikilinks pro Note (Note-Level)
|
||||
- Vergleicht IST vs. SOLL und meldet Abweichungen.
|
||||
|
||||
ENV/Qdrant
|
||||
----------
|
||||
QDRANT_URL, QDRANT_API_KEY (optional), COLLECTION_PREFIX (Default: mindnet)
|
||||
|
||||
Aufrufe
|
||||
Zweck:
|
||||
-------
|
||||
# Gesamtaudit
|
||||
python3 -m scripts.audit_edges_vs_expectations --vault ./test_vault
|
||||
Prüft Edge-Anzahlen in Qdrant gegen erwartete Werte aus dem Vault.
|
||||
Validiert strukturelle Integrität des Graphen.
|
||||
|
||||
# Mit anderem Prefix
|
||||
python3 -m scripts.audit_edges_vs_expectations --vault ./test_vault --prefix mindnet_dev
|
||||
Funktionsweise:
|
||||
---------------
|
||||
1. Liest Edges/Chunks/Notes aus Qdrant
|
||||
2. Ermittelt erwartete Edge-Anzahlen aus Vault:
|
||||
- belongs_to: sollte == #Chunks pro Note
|
||||
- next/prev: je Note (#Chunks - 1)
|
||||
- references: Summe aller Chunk-Wikilinks
|
||||
- backlink: Summe einzigartiger Wikilinks (Note-Level)
|
||||
3. Vergleicht IST vs. SOLL
|
||||
4. Meldet Abweichungen
|
||||
|
||||
# Details anzeigen
|
||||
python3 -m scripts.audit_edges_vs_expectations --vault ./test_vault --details
|
||||
Ergebnis-Interpretation:
|
||||
------------------------
|
||||
- Ausgabe: JSON mit Vergleichs-Ergebnissen
|
||||
* expected: Erwartete Edge-Anzahlen
|
||||
* actual: Tatsächliche Edge-Anzahlen
|
||||
* discrepancies: Abweichungen
|
||||
* per_note: Details pro Note (mit --details)
|
||||
- Exit-Code 0: Erfolgreich
|
||||
|
||||
Verwendung:
|
||||
-----------
|
||||
- Validierung nach Importen
|
||||
- Debugging von Edge-Problemen
|
||||
- Qualitätskontrolle
|
||||
|
||||
Hinweise:
|
||||
---------
|
||||
- Prüft strukturelle, nicht semantische Korrektheit
|
||||
- Kann bei großen Vaults langsam sein
|
||||
|
||||
Aufruf:
|
||||
-------
|
||||
python3 -m scripts.audit_edges_vs_expectations --vault ./vault
|
||||
python3 -m scripts.audit_edges_vs_expectations --vault ./vault --prefix mindnet_dev --details
|
||||
|
||||
Parameter:
|
||||
----------
|
||||
--vault PATH Pfad zum Vault-Verzeichnis (erforderlich)
|
||||
--prefix TEXT Collection-Präfix (Default: mindnet)
|
||||
--details Zeigt Details pro Note
|
||||
|
||||
Umgebungsvariablen:
|
||||
-------------------
|
||||
QDRANT_URL, QDRANT_API_KEY (optional), COLLECTION_PREFIX
|
||||
|
||||
Änderungen:
|
||||
-----------
|
||||
v2.1.0 (2025-12-15): Dokumentation aktualisiert
|
||||
v1.0.0 (2025-09-09): Initial Release
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
Reference in new issue
Block a user