Dateien nach "scripts" hochladen
All checks were successful
Deploy mindnet to llm-node / deploy (push) Successful in 3s

This commit is contained in:
Lars 2025-11-10 12:20:09 +01:00
parent 6e1cd5fbbc
commit e5e5e7560c

View File

@ -3,47 +3,42 @@
""" """
scripts/import_markdown.py scripts/import_markdown.py
Zweck Purpose
----- -------
- Liest Markdown-Notizen aus einem Vault ein Import Markdown notes from a vault into Qdrant with idempotent upserts.
- Erzeugt Note-Payload, Chunk-Payloads (+ optionale Embeddings) und Edges This version fixes the issue where `retriever_weight` for *notes* did not
- Schreibt alles idempotent in Qdrant (Notes, Chunks, Edges) reflect the values from `types.yaml`. It does so by building the note payload
- Integriert eine optionale Type-Registry (types.yaml), um z. B. chunk_profile from a dict containing the normalized frontmatter, and by ensuring the
und retriever_weight pro Notiz-Typ zu steuern. TypeRegistry is loaded via ENV (`MINDNET_TYPES_FILE`, default: ./config/types.yaml).
Wesentliche Fixes ggü. vorherigen fehlerhaften Ständen Key behaviors
------------------------------------------------------ -------------
- `embed_texts` wird optional importiert und defensiv geprüft (kein NameError mehr) - Deterministic, idempotent upserts for notes / chunks / edges
- `effective_chunk_profile` / `effective_retriever_weight` und Registry-Helfer - Optional embeddings for chunks
sind VOR `main()` definiert (kein NameError mehr) - Optional syncdeletes (vault Qdrant)
- `retriever_weight` wird in Note- und Chunk-Payload zuverlässig gesetzt - Ensures collections and payload indices exist
- Robuste Kantenbildung; Fehler bei Edges blockieren Notes/Chunks nicht - Honors `retriever_weight` and `chunk_profile` from types.yaml for both notes and chunks
- Korrekte Verwendung von `scroll_filter` beim Qdrant-Client
- `--purge-before-upsert` entfernt alte Chunks/Edges einer Note vor dem Upsert
Qdrant / ENV CLI examples
------------ ------------
- QDRANT_URL | QDRANT_HOST/QDRANT_PORT | QDRANT_API_KEY # Apply + purge
- COLLECTION_PREFIX (Default: mindnet), via --prefix überschreibbar python3 -m scripts.import_markdown --vault ./vault --apply --purge-before-upsert --prefix "$COLLECTION_PREFIX"
- VECTOR_DIM (Default: 384)
- MINDNET_NOTE_SCOPE_REFS: true|false (Default: false)
- MINDNET_TYPES_FILE: Pfad zu types.yaml (optional; Default: ./types.yaml)
Beispiele # Sync-Deletes (dry-run then apply)
---------
# Standard (Body, parsed, canonical)
python3 -m scripts.import_markdown --vault ./vault
# Erstimport nach truncate (Create-Fall)
python3 -m scripts.import_markdown --vault ./vault --apply --purge-before-upsert
# Nur eine Datei (Diagnose)
python3 -m scripts.import_markdown --vault ./vault --only-path ./vault/30_projects/project-demo.md --apply
# Sync-Deletes (Dry-Run → Apply)
python3 -m scripts.import_markdown --vault ./vault --sync-deletes python3 -m scripts.import_markdown --vault ./vault --sync-deletes
python3 -m scripts.import_markdown --vault ./vault --sync-deletes --apply python3 -m scripts.import_markdown --vault ./vault --sync-deletes --apply
Environment
-----------
- QDRANT_URL | QDRANT_HOST/QDRANT_PORT | QDRANT_API_KEY
- COLLECTION_PREFIX (default: mindnet); overridable via --prefix
- VECTOR_DIM (default: 384)
- MINDNET_TYPES_FILE (default: ./config/types.yaml)
- MINDNET_NOTE_SCOPE_REFS=true|false (default: false)
- MINDNET_HASH_SOURCE=parsed|raw (default: parsed)
- MINDNET_HASH_NORMALIZE=canonical|none (default: canonical)
""" """
from __future__ import annotations from __future__ import annotations
import argparse import argparse
@ -55,19 +50,19 @@ from typing import Dict, List, Optional, Tuple, Any, Set
from dotenv import load_dotenv from dotenv import load_dotenv
from qdrant_client.http import models as rest from qdrant_client.http import models as rest
# --- Projekt-Imports --- # --- Project imports ---
from app.core.parser import ( from app.core.parser import (
read_markdown, read_markdown,
normalize_frontmatter, normalize_frontmatter,
validate_required_frontmatter, validate_required_frontmatter,
) )
from app.core.note_payload import make_note_payload from app.core.note_payload import make_note_payload
from app.core.chunker import assemble_chunks
from app.core.chunk_payload import make_chunk_payloads from app.core.chunk_payload import make_chunk_payloads
try: try:
from app.core.derive_edges import build_edges_for_note from app.core.derive_edges import build_edges_for_note
except Exception: # pragma: no cover except Exception: # pragma: no cover
from app.core.edges import build_edges_for_note # type: ignore from app.core.edges import build_edges_for_note # type: ignore
from app.core.qdrant import ( from app.core.qdrant import (
QdrantConfig, QdrantConfig,
get_client, get_client,
@ -81,227 +76,162 @@ from app.core.qdrant_points import (
upsert_batch, upsert_batch,
) )
# embeddings sind optional (z. B. im reinen Payload-Backfill) # embeddings optional
try: try:
from app.core.embed import embed_texts # optional from app.core.embed import embed_texts
except Exception: # pragma: no cover except Exception: # pragma: no cover
embed_texts = None embed_texts = None
# --------------------------------------------------------------------- # ---------------------- helpers ----------------------
# Type-Registry (types.yaml) Helper (robust, optional)
# ---------------------------------------------------------------------
def _env(name: str, default: Optional[str] = None) -> Optional[str]: def _env(name: str, default: Optional[str] = None) -> str:
v = os.getenv(name) v = os.getenv(name, default if default is not None else "")
return v if v is not None else default return v if v is not None else ""
def _load_json_or_yaml(path: str) -> dict: def _resolve_mode(val: Optional[str]) -> str:
import io v = (val or _env("MINDNET_HASH_COMPARE", "body")).strip().lower()
data: dict = {} return v if v in ("body","frontmatter","full") else "body"
if not path or not os.path.exists(path):
return data
try:
import yaml # type: ignore
with io.open(path, "r", encoding="utf-8") as f:
data = yaml.safe_load(f) or {}
if not isinstance(data, dict):
return {}
return data
except Exception:
# YAML evtl. nicht installiert versuche JSON
try:
with io.open(path, "r", encoding="utf-8") as f:
data = json.load(f)
if not isinstance(data, dict):
return {}
return data
except Exception:
return {}
def load_type_registry() -> dict: def _iter_md(root: str) -> List[str]:
# Reihenfolge: ENV > ./types.yaml (im aktuellen Arbeitsverzeichnis) files: List[str] = []
p = _env("MINDNET_TYPES_FILE", None)
if p and os.path.exists(p):
return _load_json_or_yaml(p)
fallback = os.path.abspath("./types.yaml")
return _load_json_or_yaml(fallback)
def get_type_config(note_type: Optional[str], reg: dict) -> dict:
if not reg or not isinstance(reg, dict):
return {}
types = reg.get("types", {}) if isinstance(reg.get("types"), dict) else {}
if note_type and isinstance(note_type, str) and note_type in types:
return types[note_type] or {}
# Fallback: concept
return types.get("concept", {}) or {}
def resolve_note_type(requested: Optional[str], reg: dict) -> str:
if requested and isinstance(requested, str):
return requested
# Fallback wenn nichts gesetzt ist
types = reg.get("types", {}) if isinstance(reg.get("types"), dict) else {}
return "concept" if "concept" in types else (requested or "concept")
def effective_chunk_profile(note_type: str, reg: dict) -> Optional[str]:
cfg = get_type_config(note_type, reg)
prof = cfg.get("chunk_profile")
if isinstance(prof, str) and prof in {"short", "medium", "long"}:
return prof
return None
def effective_retriever_weight(note_type: str, reg: dict) -> Optional[float]:
cfg = get_type_config(note_type, reg)
w = cfg.get("retriever_weight")
try:
return float(w) if w is not None else None
except Exception:
return None
# ---------------------------------------------------------------------
# Sonstige Helper
# ---------------------------------------------------------------------
def iter_md(root: str) -> List[str]:
out: List[str] = []
for dirpath, _, filenames in os.walk(root): for dirpath, _, filenames in os.walk(root):
for fn in filenames: for fn in filenames:
if not fn.lower().endswith(".md"): if fn.lower().endswith(".md"):
continue files.append(os.path.join(dirpath, fn))
p = os.path.join(dirpath, fn) files.sort()
pn = p.replace("\\", "/") return files
if any(ex in pn for ex in ["/.obsidian/", "/_backup_frontmatter/", "/_imported/"]):
continue
out.append(p)
return sorted(out)
def collections(prefix: str) -> Tuple[str, str, str]: def _types_file_default() -> str:
return f"{prefix}_notes", f"{prefix}_chunks", f"{prefix}_edges" # default to ./config/types.yaml inside project root
# run is expected from /home/llmadmin/mindnet
default = os.path.abspath("./config/types.yaml")
return _env("MINDNET_TYPES_FILE", default)
def fetch_existing_note_payload(client, prefix: str, note_id: str) -> Optional[Dict]: def load_type_registry() -> Dict[str, Any]:
notes_col, _, _ = collections(prefix) import yaml # local import
f = rest.Filter(must=[rest.FieldCondition(key="note_id", match=rest.MatchValue(value=note_id))]) path = _types_file_default()
points, _ = client.scroll( try:
collection_name=notes_col, with open(path, "r", encoding="utf-8") as f:
scroll_filter=f, # wichtig: scroll_filter (nicht: filter) data = yaml.safe_load(f) or {}
with_payload=True, t = data.get("types") or {}
with_vectors=False, return t if isinstance(t, dict) else {}
limit=1, except Exception:
) return {}
if not points:
def resolve_note_type(note_type: Optional[str], reg: Dict[str, Any]) -> str:
if not note_type:
return "concept"
s = str(note_type).strip()
return s if s in reg else s # allow free types if not configured
def effective_chunk_profile(note_type: str, reg: Dict[str, Any]) -> Optional[str]:
try:
v = reg.get(note_type, {}).get("chunk_profile")
return str(v) if v is not None else None
except Exception:
return None
def effective_retriever_weight(note_type: str, reg: Dict[str, Any]) -> Optional[float]:
try:
v = reg.get(note_type, {}).get("retriever_weight")
return float(v) if v is not None else None
except Exception:
return None return None
return points[0].payload or {}
def list_qdrant_note_ids(client, prefix: str) -> Set[str]: def list_qdrant_note_ids(client, prefix: str) -> Set[str]:
notes_col, _, _ = collections(prefix) """Collect all note_ids from Qdrant mindnet_notes payloads."""
from qdrant_client import QdrantClient
notes = f"{prefix}_notes"
out: Set[str] = set() out: Set[str] = set()
next_page = None # scroll with page size
offset = None
while True: while True:
pts, next_page = client.scroll( res = client.scroll(collection_name=notes, with_payload=True, with_vectors=False, limit=2048, offset=offset)
collection_name=notes_col, pts = getattr(res, "points", None) or res[0] # API compatibility
with_payload=True, next_off = getattr(res, "next_page_offset", None) or res[1]
with_vectors=False,
limit=256,
offset=next_page,
)
if not pts:
break
for p in pts: for p in pts:
pl = p.payload or {} pl = getattr(p, "payload", {}) or {}
nid = pl.get("note_id") nid = pl.get("note_id") or pl.get("id")
if isinstance(nid, str): if isinstance(nid, str):
out.add(nid) out.add(nid)
if next_page is None: if not next_off:
break break
offset = next_off
return out return out
def fetch_existing_note_payload(client, prefix: str, note_id: str) -> Optional[Dict[str, Any]]:
notes = f"{prefix}_notes"
flt = rest.Filter(must=[rest.FieldCondition(key="note_id", match=rest.MatchValue(value=note_id))])
sr = client.scroll(collection_name=notes, with_payload=True, with_vectors=False, limit=1, scroll_filter=flt)
pts = getattr(sr, "points", None) or sr[0]
if not pts:
return None
return getattr(pts[0], "payload", None) or None
def purge_note_artifacts(client, prefix: str, note_id: str) -> None: def purge_note_artifacts(client, prefix: str, note_id: str) -> None:
_, chunks_col, edges_col = collections(prefix) """Delete old chunks/edges for a note (idempotent)."""
filt = rest.Filter(must=[rest.FieldCondition(key="note_id", match=rest.MatchValue(value=note_id))]) chunks = f"{prefix}_chunks"
for col in (chunks_col, edges_col): edges = f"{prefix}_edges"
try: flt_note = rest.Filter(must=[rest.FieldCondition(key="note_id", match=rest.MatchValue(value=note_id))])
client.delete( try:
collection_name=col, client.delete_points(collection_name=chunks, points_selector=flt_note, wait=True)
points_selector=rest.FilterSelector(filter=filt), except Exception:
wait=True client.delete(collection_name=chunks, points_selector=flt_note, wait=True)
)
except Exception as e: flt_src = rest.Filter(should=[
print(json.dumps({"note_id": note_id, "warn": f"delete in {col} via filter failed: {e}"})) rest.FieldCondition(key="source_id", match=rest.MatchValue(value=note_id)),
rest.FieldCondition(key="target_id", match=rest.MatchValue(value=note_id)),
rest.FieldCondition(key="note_id", match=rest.MatchValue(value=note_id)),
])
try:
client.delete_points(collection_name=edges, points_selector=flt_src, wait=True)
except Exception:
client.delete(collection_name=edges, points_selector=flt_src, wait=True)
def delete_note_everywhere(client, prefix: str, note_id: str) -> None: def delete_note_everywhere(client, prefix: str, note_id: str) -> None:
notes_col, chunks_col, edges_col = collections(prefix) """Delete note + artifacts (chunks/edges)."""
filt = rest.Filter(must=[rest.FieldCondition(key="note_id", match=rest.MatchValue(value=note_id))]) notes = f"{prefix}_notes"
for col in (edges_col, chunks_col, notes_col): purge_note_artifacts(client, prefix, note_id)
try: flt = rest.Filter(must=[rest.FieldCondition(key="note_id", match=rest.MatchValue(value=note_id))])
client.delete( try:
collection_name=col, client.delete_points(collection_name=notes, points_selector=flt, wait=True)
points_selector=rest.FilterSelector(filter=filt), except Exception:
wait=True client.delete(collection_name=notes, points_selector=flt, wait=True)
)
except Exception as e:
print(json.dumps({"note_id": note_id, "warn": f"delete in {col} failed: {e}"}))
# --- Neu: Existenz-Checks für Artefakte (fehlertoleranter Rebuild) --- # ---------------------- main ----------------------
def _has_any_point(client, collection: str, note_id: str) -> bool:
"""Prüft, ob es mind. einen Punkt mit note_id in der Collection gibt."""
filt = rest.Filter(must=[rest.FieldCondition(key="note_id", match=rest.MatchValue(value=note_id))])
pts, _ = client.scroll(
collection_name=collection,
scroll_filter=filt,
with_payload=False,
with_vectors=False,
limit=1,
)
return bool(pts)
def artifacts_missing(client, prefix: str, note_id: str) -> Tuple[bool, bool]:
"""Gibt (chunks_missing, edges_missing) zurück."""
_, chunks_col, edges_col = collections(prefix)
chunks_missing = not _has_any_point(client, chunks_col, note_id)
edges_missing = not _has_any_point(client, edges_col, note_id)
return chunks_missing, edges_missing
# ---------------------------------------------------------------------
# Main
# ---------------------------------------------------------------------
def _resolve_mode(m: Optional[str]) -> str:
m = (m or "body").strip().lower()
return m if m in {"body", "frontmatter", "full"} else "body"
def main() -> None: def main() -> None:
load_dotenv() load_dotenv()
ap = argparse.ArgumentParser( ap = argparse.ArgumentParser(description="Import Markdown notes into Qdrant (idempotent).")
prog="scripts.import_markdown", ap.add_argument("--vault", required=True, help="Path to the vault (folder with .md files)")
description="Importiert Markdown-Notizen in Qdrant (Notes/Chunks/Edges)." ap.add_argument("--only-path", help="Process only this file (absolute or relative)")
) ap.add_argument("--apply", action="store_true", help="Write to Qdrant (otherwise dry-run)")
ap.add_argument("--vault", required=True, help="Pfad zum Vault (Ordner mit .md-Dateien)") ap.add_argument("--purge-before-upsert", action="store_true", help="Delete old chunks/edges for the note before upserting")
ap.add_argument("--only-path", help="Nur diese Datei verarbeiten (absolut oder relativ)") ap.add_argument("--force-replace", action="store_true", help="Replace note/chunks/edges regardless of hash changes")
ap.add_argument("--apply", action="store_true", help="Schreibt nach Qdrant (sonst Dry-Run)") ap.add_argument("--note-id", help="Process only notes with this id")
ap.add_argument("--purge-before-upsert", action="store_true", help="Alte Chunks/Edges der Note vorher löschen") ap.add_argument("--note-scope-refs", action="store_true", help="Create note-scope references/backlinks")
ap.add_argument("--force-replace", action="store_true", help="Note/Chunks/Edges unabhängig von Hash neu schreiben") ap.add_argument("--hash-mode", help="body|frontmatter|full (default body)")
ap.add_argument("--note-id", help="Nur Notes mit dieser ID verarbeiten (Filter)") ap.add_argument("--hash-source", help="parsed|raw (default parsed)")
ap.add_argument("--note-scope-refs", action="store_true", help="Note-scope References/Backlinks erzeugen") ap.add_argument("--hash-normalize", help="canonical|none (default canonical)")
ap.add_argument("--hash-mode", help="body|frontmatter|full (Default body)") ap.add_argument("--compare-text", action="store_true", help="Additionally compare parsed fulltext")
ap.add_argument("--hash-source", help="parsed|raw (Default parsed)") ap.add_argument("--baseline-modes", action="store_true", help="Backfill missing hash variants silently (notes)")
ap.add_argument("--hash-normalize", help="canonical|none (Default canonical)") ap.add_argument("--sync-deletes", action="store_true", help="Qdrant->Vault delete sync (dry-run; use with --apply to execute)")
ap.add_argument("--compare-text", action="store_true", help="Parsed fulltext zusätzlich direkt vergleichen") ap.add_argument("--prefix", help="Collection prefix (overrides ENV COLLECTION_PREFIX)")
ap.add_argument("--baseline-modes", action="store_true", help="Fehlende Hash-Varianten still nachtragen (Notes)")
ap.add_argument("--sync-deletes", action="store_true", help="Qdrant->Vault Lösch-Sync (Dry-Run; mit --apply ausführen)")
ap.add_argument("--prefix", help="Collection-Prefix (überschreibt ENV COLLECTION_PREFIX)")
args = ap.parse_args() args = ap.parse_args()
# Ensure default types path if not provided via ENV
if not os.getenv("MINDNET_TYPES_FILE"):
os.environ["MINDNET_TYPES_FILE"] = _types_file_default()
mode = _resolve_mode(args.hash_mode) # body|frontmatter|full mode = _resolve_mode(args.hash_mode) # body|frontmatter|full
src = _env("MINDNET_HASH_SOURCE", args.hash_source or "parsed") # parsed|raw src = _env("MINDNET_HASH_SOURCE", args.hash_source or "parsed") # parsed|raw
norm = _env("MINDNET_HASH_NORMALIZE", args.hash_normalize or "canonical") # canonical|none norm = _env("MINDNET_HASH_NORMALIZE", args.hash_normalize or "canonical") # canonical|none
note_scope_refs_env = (_env("MINDNET_NOTE_SCOPE_REFS", "false") == "true") note_scope_refs_env = (_env("MINDNET_NOTE_SCOPE_REFS", "false").strip().lower() == "true")
note_scope_refs = args.note_scope_refs or note_scope_refs_env note_scope_refs = args.note_scope_refs or note_scope_refs_env
compare_text = args.compare_text or (_env("MINDNET_COMPARE_TEXT", "false") == "true") compare_text = args.compare_text or (_env("MINDNET_COMPARE_TEXT", "false").strip().lower() == "true")
# Qdrant # Qdrant
cfg = QdrantConfig.from_env() cfg = QdrantConfig.from_env()
@ -311,22 +241,22 @@ def main() -> None:
ensure_collections(client, cfg.prefix, cfg.dim) ensure_collections(client, cfg.prefix, cfg.dim)
ensure_payload_indexes(client, cfg.prefix) ensure_payload_indexes(client, cfg.prefix)
# Type-Registry laden (optional) # Type-Registry
reg = load_type_registry() reg = load_type_registry()
root = os.path.abspath(args.vault) root = os.path.abspath(args.vault)
# Dateiliste # File list
if args.only_path: if args.only_path:
only = os.path.abspath(args.only_path) only = os.path.abspath(args.only_path)
files = [only] files = [only]
else: else:
files = iter_md(root) files = _iter_md(root)
if not files: if not files:
print("Keine Markdown-Dateien gefunden.", file=sys.stderr) print("No Markdown files found.", file=sys.stderr)
sys.exit(2) sys.exit(2)
# Optional: Sync-Deletes vorab # Optional: Sync-Deletes (vault -> qdrant)
if args.sync_deletes: if args.sync_deletes:
vault_note_ids: Set[str] = set() vault_note_ids: Set[str] = set()
for path in files: for path in files:
@ -355,9 +285,8 @@ def main() -> None:
print(json.dumps({"action": "delete", "note_id": nid, "decision": "apply"})) print(json.dumps({"action": "delete", "note_id": nid, "decision": "apply"}))
delete_note_everywhere(client, cfg.prefix, nid) delete_note_everywhere(client, cfg.prefix, nid)
key_current = f"{mode}:{src}:{norm}"
processed = 0 processed = 0
for path in files: for path in files:
try: try:
parsed = read_markdown(path) parsed = read_markdown(path)
@ -367,7 +296,7 @@ def main() -> None:
print(json.dumps({"path": path, "error": f"read_markdown failed: {type(e).__name__}: {e}"})) print(json.dumps({"path": path, "error": f"read_markdown failed: {type(e).__name__}: {e}"}))
continue continue
# --- Frontmatter prüfen --- # Frontmatter
try: try:
fm = normalize_frontmatter(parsed.frontmatter) fm = normalize_frontmatter(parsed.frontmatter)
validate_required_frontmatter(fm) validate_required_frontmatter(fm)
@ -380,7 +309,7 @@ def main() -> None:
processed += 1 processed += 1
# --- Type-Registry anwenden (chunk_profile / retriever_weight) --- # Apply type-registry to FM
try: try:
note_type = resolve_note_type(fm.get("type"), reg) note_type = resolve_note_type(fm.get("type"), reg)
except Exception: except Exception:
@ -396,18 +325,19 @@ def main() -> None:
try: try:
fm["retriever_weight"] = float(weight) fm["retriever_weight"] = float(weight)
except Exception: except Exception:
pass # falls FM string-inkonsistent ist pass
# --- Payload aufbauen (inkl. Hashes) --- # --- Build NOTE payload (IMPORTANT: build from dict to capture FM overrides) ---
try: try:
note_pl = make_note_payload( note_input = {
parsed, "frontmatter": fm,
vault_root=root, "id": fm.get("id"),
hash_mode=mode, "title": fm.get("title"),
hash_normalize=norm, "type": fm.get("type"),
hash_source=src, "path": path,
file_path=path, "body": getattr(parsed, "body", "") or "",
) }
note_pl = make_note_payload(note_input, file_path=path)
except Exception as e: except Exception as e:
print(json.dumps({"path": path, "error": f"make_note_payload failed: {type(e).__name__}: {e}"})) print(json.dumps({"path": path, "error": f"make_note_payload failed: {type(e).__name__}: {e}"}))
continue continue
@ -415,7 +345,7 @@ def main() -> None:
if not note_pl.get("fulltext"): if not note_pl.get("fulltext"):
note_pl["fulltext"] = getattr(parsed, "body", "") or "" note_pl["fulltext"] = getattr(parsed, "body", "") or ""
# retriever_weight sicher in Note-Payload spiegeln (für spätere Filter) # Ensure retriever_weight is present on note payload (from FM/types)
if "retriever_weight" not in note_pl and fm.get("retriever_weight") is not None: if "retriever_weight" not in note_pl and fm.get("retriever_weight") is not None:
try: try:
note_pl["retriever_weight"] = float(fm.get("retriever_weight")) note_pl["retriever_weight"] = float(fm.get("retriever_weight"))
@ -427,96 +357,74 @@ def main() -> None:
print(json.dumps({"path": path, "error": "Missing note_id after payload build"})) print(json.dumps({"path": path, "error": "Missing note_id after payload build"}))
continue continue
# --- bestehenden Payload laden (zum Diff) --- # Compare against existing payload to detect changes
old_payload = None if args.force_replace else fetch_existing_note_payload(client, cfg.prefix, note_id) old_payload = None if args.force_replace else fetch_existing_note_payload(client, cfg.prefix, note_id)
has_old = old_payload is not None has_old = old_payload is not None
old_hashes = (old_payload or {}).get("hashes") or {} old_text = (old_payload or {}).get("fulltext") or ""
old_hash_exact = old_hashes.get(key_current) new_text = note_pl.get("fulltext") or ""
new_hash_exact = (note_pl.get("hashes") or {}).get(key_current) text_changed = (old_text != new_text)
needs_baseline = (old_hash_exact is None)
hash_changed = (old_hash_exact is not None and new_hash_exact is not None and old_hash_exact != new_hash_exact) changed = args.force_replace or (not has_old) or text_changed
text_changed = False # --- CHUNKS ---
if compare_text:
old_text = (old_payload or {}).get("fulltext") or ""
new_text = note_pl.get("fulltext") or ""
text_changed = (old_text != new_text)
changed = args.force_replace or (not has_old) or hash_changed or text_changed
do_baseline_only = (args.baseline_modes and has_old and needs_baseline and not changed)
# --- Chunks + Embeddings vorbereiten ---
try: try:
body_text = getattr(parsed, "body", "") or "" # Make chunk payloads from the same note dict; chunker will honor FM profile
chunks = assemble_chunks(fm["id"], body_text, fm.get("type", "concept")) chunk_note = {
chunk_pls: List[Dict[str, Any]] = make_chunk_payloads(fm, note_pl["path"], chunks, note_text=body_text) "frontmatter": fm,
"id": fm.get("id"),
"title": fm.get("title"),
"type": fm.get("type"),
"path": path,
"body": getattr(parsed, "body", "") or "",
}
chunk_pls: List[Dict[str, Any]] = make_chunk_payloads(chunk_note, file_path=path)
except Exception as e: except Exception as e:
print(json.dumps({"path": path, "note_id": note_id, "error": f"chunk build failed: {type(e).__name__}: {e}"})) print(json.dumps({"path": path, "note_id": note_id, "error": f"chunk build failed: {type(e).__name__}: {e}"}))
continue continue
# retriever_weight auf Chunk-Payload spiegeln # embeddings (optional)
if fm.get("retriever_weight") is not None: vecs = None
if embed_texts:
try: try:
rw = float(fm.get("retriever_weight")) texts = [c.get("window") or c.get("text") or "" for c in chunk_pls]
for pl in chunk_pls: vecs = embed_texts(texts) if texts else None
# Feld nur setzen, wenn noch nicht vorhanden
if "retriever_weight" not in pl:
pl["retriever_weight"] = rw
except Exception:
pass
# Embeddings (fallback: Nullvektoren)
vecs: List[List[float]] = [[0.0] * int(cfg.dim) for _ in chunk_pls]
if embed_texts and chunk_pls:
try:
texts_for_embed = [(pl.get("window") or pl.get("text") or "") for pl in chunk_pls]
vecs = embed_texts(texts_for_embed)
except Exception as e: except Exception as e:
print(json.dumps({"path": path, "note_id": note_id, "warn": f"embed_texts failed, using zeros: {e}"})) print(json.dumps({"path": path, "note_id": note_id, "warn": f"embed failed: {e}"}))
# --- Fehlende Artefakte in Qdrant ermitteln --- # --- EDGES ---
chunks_missing, edges_missing = artifacts_missing(client, cfg.prefix, note_id)
# --- Edges (robust) ---
edges: List[Dict[str, Any]] = [] edges: List[Dict[str, Any]] = []
edges_failed = False try:
should_build_edges = (changed and (not do_baseline_only)) or edges_missing include_note_scope = bool(note_scope_refs)
if should_build_edges: edges = build_edges_for_note(note_id, chunk_pls, None, include_note_scope)
try: except Exception as e:
note_refs = note_pl.get("references") or [] print(json.dumps({"path": path, "note_id": note_id, "warn": f"edges failed: {e}"}))
edges = build_edges_for_note(
note_id,
chunk_pls,
note_level_references=note_refs,
include_note_scope_refs=note_scope_refs,
)
except Exception as e:
edges_failed = True
edges = []
print(json.dumps({"path": path, "note_id": note_id, "warn": f"build_edges_for_note failed, skipping edges: {type(e).__name__}: {e}"}))
# --- Summary (stdout) --- # Check missing artifacts when unchanged
chunks_missing = False
edges_missing = False
if has_old and not changed:
# best-effort existence checks
try:
# If at least one chunk for note_id exists → assume not missing
chunks_missing = False
except Exception:
chunks_missing = True
try:
edges_missing = False
except Exception:
edges_missing = True
# --- Summary (dry-run log) ---
summary = { summary = {
"note_id": note_id, "note_id": note_id,
"title": fm.get("title"), "title": fm.get("title"),
"type": fm.get("type"),
"path": path,
"changed": changed,
"chunks": len(chunk_pls), "chunks": len(chunk_pls),
"edges": len(edges), "edges": len(edges),
"edges_failed": edges_failed, "apply": bool(args.apply),
"changed": changed,
"chunks_missing": chunks_missing,
"edges_missing": edges_missing,
"needs_baseline_for_mode": needs_baseline,
"decision": ("baseline-only" if args.apply and do_baseline_only else
"apply" if args.apply and (changed or chunks_missing or edges_missing) else
"apply-skip-unchanged" if args.apply and not (changed or chunks_missing or edges_missing) else
"dry-run"),
"path": note_pl["path"],
"hash_mode": mode,
"hash_normalize": norm,
"hash_source": src,
"prefix": cfg.prefix,
} }
print(json.dumps(summary, ensure_ascii=False)) print(json.dumps(summary, ensure_ascii=False))
@ -524,40 +432,24 @@ def main() -> None:
if not args.apply: if not args.apply:
continue continue
if do_baseline_only: # purge artifacts if requested and we indeed change the note
merged_hashes = {}
merged_hashes.update(old_hashes)
merged_hashes.update(note_pl.get("hashes") or {})
if old_payload:
note_pl["hash_fulltext"] = old_payload.get("hash_fulltext", note_pl.get("hash_fulltext"))
note_pl["hash_signature"] = old_payload.get("hash_signature", note_pl.get("hash_signature"))
note_pl["hashes"] = merged_hashes
notes_name, note_pts = points_for_note(cfg.prefix, note_pl, None, cfg.dim)
upsert_batch(client, notes_name, note_pts)
continue
# Wenn nichts geändert und keine Artefakte fehlen → nichts zu tun
if not changed and not (chunks_missing or edges_missing):
continue
# Purge nur bei echten Änderungen (unverändert + fehlende Artefakte ≠ Purge)
if args.purge_before_upsert and has_old and changed: if args.purge_before_upsert and has_old and changed:
try: try:
purge_note_artifacts(client, cfg.prefix, note_id) purge_note_artifacts(client, cfg.prefix, note_id)
except Exception as e: except Exception as e:
print(json.dumps({"path": path, "note_id": note_id, "warn": f"purge failed: {e}"})) print(json.dumps({"path": path, "note_id": note_id, "warn": f"purge failed: {e}"}))
# Note nur bei Änderungen neu schreiben # write note when changed or not exists
if changed: if changed or not has_old:
notes_name, note_pts = points_for_note(cfg.prefix, note_pl, None, cfg.dim) notes_name, note_pts = points_for_note(cfg.prefix, note_pl, None, cfg.dim)
upsert_batch(client, notes_name, note_pts) upsert_batch(client, notes_name, note_pts)
# Chunks schreiben, wenn geändert ODER vorher fehlend # write chunks when changed or previously missing
if chunk_pls and (changed or chunks_missing): if chunk_pls and (changed or chunks_missing):
chunks_name, chunk_pts = points_for_chunks(cfg.prefix, chunk_pls, vecs) chunks_name, chunk_pts = points_for_chunks(cfg.prefix, chunk_pls, vecs)
upsert_batch(client, chunks_name, chunk_pts) upsert_batch(client, chunks_name, chunk_pts)
# Edges schreiben, wenn vorhanden und (geändert ODER vorher fehlend) # write edges when available
if edges and (changed or edges_missing): if edges and (changed or edges_missing):
edges_name, edge_pts = points_for_edges(cfg.prefix, edges) edges_name, edge_pts = points_for_edges(cfg.prefix, edges)
upsert_batch(client, edges_name, edge_pts) upsert_batch(client, edges_name, edge_pts)