Layer 4 · Normalization

Trace-Builder

Markdown → strukturiertes JSON. Pro Section Konfidenz-Score, pro erwartetem Konzept Coverage-Status, pro Einwand Dialog- Thread mit Final-Status. Output ist die kanonische Audit-Trail- Datenstruktur für Layer 5 und alle abgeleiteten Views.

§ 4.1 · Output-Schema

Was im Trace-JSON steht.

Top-Level

RunTrace

data/run-traces/<run-id>_trace.json

{
  "run_id": "...",
  "pair_id": "...",
  "kind": "konzept_generation_with_pruefsv_dialog",
  "schema_version": "v0.1.0",
  "metadata": { ... },
  "run_config": { variant, label, values },
  "dialog_matching": { strategy, ... },
  "boxes": {
    "intake":     { ... },
    "analyze":    { preamble, ... },
    "generation": { topics: [9 sections] },
    "coverage":   { rows: [11 concepts] },
    "dialog":     { threads: [15 E-XX] },
    "verdict":    { verdict, begruendung }
  }
}

Section-Level

topics[i].confidence

scripts/build_run_trace.py:parse_eval_run()

{
  "score": 87,
  "label": "stark",
  "color": "green",
  "indicators": {
    "annahmen_count": 1,
    "hedge_count":    2,
    "u_flags":        { "(U-DATA)": 0, ... },
    "citation_count": 3
  }
}

§ 4.2 · Algorithmen

Drei Funktionen, eine Wahrheit.

§ 4.3 · Code-Pointer

Wo das passiert.

Builder

scripts/build_run_trace.py

~470 LOC · pair-aware (--pair Argument)

python scripts/build_run_trace.py \
    --pair pair_001 \
    --eval-run .scratch/agent_runs/<eval-md> \
    --dialog   .scratch/agent_runs/<dialog-md>

→ data/run-traces/<run-id>_trace.json

Synonym-Single-Source

data/ontology/synonyms.json

B29 · 22 Lemma-Familien

Eine Datei, drei Konsumenten:
  • build_run_trace.py (Coverage-Matrix)
  • Cognee-Inspector (Knowledge-Graph)
  • Schwarm-Score-Heuristik

Vermeidet Inkonsistenz zwischen Pipelines.

← Layer 3: PrüfSV-Schatten

→ Layer 5: Audit-Trail-Viewer

↑ Architektur-Übersicht