mindnet/app/services/edge_registry.py
2025-12-18 18:50:45 +01:00

116 lines
4.5 KiB
Python

"""
FILE: app/services/edge_registry.py
DESCRIPTION: Single Source of Truth für Kanten-Typen.
WP-22 Teil B: Registry & Validation.
FIX: Erzwingt sofortige Log-Ausgabe beim Laden des Moduls.
VERSION: 0.6.8 (Emergency Debug)
"""
import re
import os
import json
import logging
from typing import Dict, Optional, Set
# Sofortiger Print beim Laden des Moduls (erscheint garantiert in journalctl)
print(">>> MODULE_LOAD: edge_registry.py is being read by Python <<<", flush=True)
from app.config import get_settings
logger = logging.getLogger(__name__)
class EdgeRegistry:
_instance = None
def __new__(cls, *args, **kwargs):
if cls._instance is None:
print(">>> SINGLETON: Creating new EdgeRegistry instance <<<", flush=True)
cls._instance = super(EdgeRegistry, cls).__new__(cls)
cls._instance.initialized = False
return cls._instance
def __init__(self, vault_root: Optional[str] = None):
if self.initialized:
return
print(">>> INIT: EdgeRegistry.__init__ started <<<", flush=True)
settings = get_settings()
# Prio: MINDNET_VOCAB_PATH > MINDNET_VAULT_ROOT > Default
env_vocab_path = os.getenv("MINDNET_VOCAB_PATH")
env_vault_root = os.getenv("MINDNET_VAULT_ROOT") or getattr(settings, "MINDNET_VAULT_ROOT", "./vault_master")
if env_vocab_path:
self.full_vocab_path = os.path.abspath(env_vocab_path)
else:
self.full_vocab_path = os.path.abspath(
os.path.join(env_vault_root, "01_User_Manual", "01_edge_vocabulary.md")
)
self.unknown_log_path = "data/logs/unknown_edges.jsonl"
self.canonical_map: Dict[str, str] = {}
self.valid_types: Set[str] = set()
self._load_vocabulary()
self.initialized = True
def _load_vocabulary(self):
"""Parst die Markdown-Tabelle im Vault."""
print(f">>> CHECK: Searching for Vocabulary at {self.full_vocab_path}", flush=True)
if not os.path.exists(self.full_vocab_path):
msg = f"!!! [DICT-ERROR] Edge Vocabulary NOT found at: {self.full_vocab_path} !!!"
print(msg, flush=True)
logger.warning(msg)
return
# Regex für Markdown Tabellen
pattern = re.compile(r"\|\s*\*\*([a-z_]+)\*\*\s*\|\s*([^|]+)\|")
try:
with open(self.full_vocab_path, "r", encoding="utf-8") as f:
c_types, c_aliases = 0, 0
for line in f:
match = pattern.search(line)
if match:
canonical = match.group(1).strip()
aliases_str = match.group(2).strip()
self.valid_types.add(canonical)
self.canonical_map[canonical] = canonical
c_types += 1
if aliases_str and "Kein Alias" not in aliases_str:
aliases = [a.strip() for a in aliases_str.split(",") if a.strip()]
for alias in aliases:
clean_alias = alias.replace("`", "").lower().strip()
self.canonical_map[clean_alias] = canonical
c_aliases += 1
success_msg = f"=== [DICT-SUCCESS] Loaded {c_types} Types and {c_aliases} Aliases ==="
print(success_msg, flush=True)
logger.info(success_msg)
except Exception as e:
err_msg = f"!!! [DICT-FATAL] Failed to parse: {e} !!!"
print(err_msg, flush=True)
logger.error(err_msg)
def resolve(self, edge_type: str) -> str:
if not edge_type: return "related_to"
clean_type = edge_type.lower().strip().replace(" ", "_")
if clean_type in self.canonical_map:
return self.canonical_map[clean_type]
self._log_unknown(clean_type)
return clean_type
def _log_unknown(self, edge_type: str):
try:
os.makedirs(os.path.dirname(self.unknown_log_path), exist_ok=True)
entry = {"unknown_type": edge_type, "status": "new"}
with open(self.unknown_log_path, "a", encoding="utf-8") as f:
f.write(json.dumps(entry) + "\n")
except Exception: pass
# Singleton Instanz - Dies triggert beim Import die Initialisierung
print(">>> INSTANTIATING REGISTRY SINGLETON <<<", flush=True)
registry = EdgeRegistry()