Thesis YAML Referenz

Feld-Level-Spezifikation fuer Thesis (Hypothesis) YAML-Definitionen.

Uebersicht

Eigenschaft	Wert
Dateiort	hypotheses/hyp_*.yaml
ID-Regel	hypothesis_id muss mit Dateiname (ohne .yaml) uebereinstimmen
Validator	python3 scripts/hypothesischeck.py
Compiler	python3 scripts/hypothesiscompile.py
Compiler Trockenlauf	python3 scripts/hypothesiscompile.py --check

Felder

Feld	Typ	Erforderlich	Gueltige Werte
hypothesis_id	string	ja	Muss mit Dateiname uebereinstimmen
short_code	string	ja	3-4 Grossbuchstaben; muss Vokal an Position 2 oder 3 haben; eindeutig
version	string	ja	Semantische Version (z.B. "1.0")
statement	dict	ja	{en, de, fr} dreisprachiger Text
category	string	ja	financial_anomaly | data_quality | compliance | operational
evidence	list	ja	Min 1 Eintrag; siehe Evidence-Block
verdict	dict	ja	Siehe Verdict-Block
interpretation	dict	ja	Alle 4 Status erforderlich; siehe Interpretations-Block

Evidence-Block

Feld	Typ	Erforderlich	Gueltige Werte
probe_id	string	ja	Muss auf existierende probes/*.yaml referenzieren
role	string	ja	primary | supporting | context | counter
weight	integer	ja	1-5

Regeln: Mindestens ein Eintrag muss role: primary haben. Alle referenzierten probe_id-Werte muessen eine entsprechende YAML-Datei haben.

Rolle	Auswirkung
primary	Muss Findings haben fuer “confirmed”
supporting	Staerkt den Evidence Score
context	Hintergrund, nicht entscheidend
counter	Reduziert Score wenn Findings existieren

Verdict-Block

Feld	Typ	Erforderlich	Gueltige Werte
thresholds.confirmed	float	ja	0.0-1.0
thresholds.plausible	float	ja	0.0-1.0
scaling	string	nein	binary | graduated

Regeln: 0 <= plausible < confirmed <= 1

Interpretations-Block

Erforderliche Schluessel: confirmed, plausible, not_observed, insufficient.

Jeder Schluessel bildet auf ein dreisprachiges Dict mit {en, de, fr} ab. Menschenlesbare Narrativvorlagen, die im Explorer fuer jeden Status angezeigt werden.

Status	Wann zugewiesen
confirmed	Evidence Score >= thresholds.confirmed
plausible	Evidence Score >= thresholds.plausible und < thresholds.confirmed
not_observed	Evidence Score < thresholds.plausible
insufficient	Nicht genug Daten zur Bewertung

Verdict-Ausgabe

Jede Thesis produziert eine Zeile pro Tenant in hypothesis_verdicts:

Spalte	Typ	Beschreibung
verdict_id	string	Deterministischer Surrogatschluessel
tenant_id	string	Tenant-Bezeichner
hypothesis_id	string	Thesis-Bezeichner
status	string	confirmed | plausible | not_observed | insufficient
evidence_score	float	Gewichteter Evidence Score (0.0-1.0)
finding_count	integer	Gesamt-Findings ueber alle Evidence Signals
money_at_risk	numeric	Summe von money_at_risk aller Evidence Signals
worst_severity	string	Hoechster Schweregrad ueber Evidence Signals

Siehe die englische Referenz fuer das vollstaendige Minimalbeispiel.