feat(tools): map kv library variants to kb ids

pv-agent/.agents/MEMORY.md

@@ -5,14 +5,14 @@ Rollender Übergabe-Log für agent-Threads. Workflow: `.agents/SKILL.md`
 
 ## Current focus
 
-D24 ist validiert (beide 500-Euro-Fragen verifiziert beantwortet; think-Fix
-aktiv; Offline-Eval Recall@8 0,95; 95 Unit-Tests). M4-Richtung mit User
-geklärt (D25-Vorentscheidung): Odoo orchestriert und rechnet (System of
-Record), der Agent konsumiert nur das vorgegebene Ergebnis und prüft
-Plausibilität gegen die KB. Die Aufweichung der Privacy-Regel 8 (keine
-Lohndaten im Prompt) passiert bewusst erst im Rahmen der Odoo-Implementierung;
-der Test-Agent bleibt `knowledge_base_only`. Odoo-Modul-Bestand wird vom User
-verlinkt; danach D25/M4-Planung.
+D24 validiert (500-Euro-Fragen verifiziert, think-Fix, Offline-Eval Recall@8
+0,95). D25-Planung steht (planung.md Abschnitt 14): Odoo orchestriert und
+rechnet (System of Record), Agent prüft Plausibilität, kein Rückpfad;
+Privacy-Regel 8 wird erst per Feature-Flag `PV_REVIEW_MODE` im M4 aufgeweicht.
+Modul-Review abgeschlossen (`.oddo-module/`), KV-Varianten-Mapping gebaut
+(`tools/catalogs/kv_variant_map.json`, 439/614 abgedeckt, Seeds SI-2203/
+SI-2748 getestet). Als Nächstes: D25-Umsetzung — Agent-`review`-Modus (M4.2)
+und Odoo-Modul `l10n_at_payroll_agent` (M4.1).
 
 ## Completed (2026-09-16, Modul-Review/D25-Planung)
 
@@ -27,9 +27,9 @@ verlinkt; danach D25/M4-Planung.
   ×Jahr, DAG), lohnsteuer.py (§ 66/67/68 mit YTD-Freibetragsverbrauch),
   payslip_private (KommSt/DZ/FLAF-DB/SZ), sachbezuege/reisekosten. Parameter
   aus ÖGK-TASY-Export gegen offiziellen Report gespiegelt; 2027-Rahmen.
-  KV-Katalog `l10n.at.payroll.kv` mit versionierten `kv.wert`, Gruppen/Stufen,
-  CSV-Import-Wizard (Sprungwarnung >10 %) und `library_variant_id` auf die
-  KV-Library (SI-2203/SI-2748). D25-Planung steht in `planung.md`
+  KV-Katalog `l10n.at.payroll.kv` mit versionierten `kv.wert`, Gruppen/Stufen
+  und CSV-Import-Wizard (Sprungwarnung >10 %); `library_variant_id` verlinkt
+  auf die KV-Library (SI-2203/SI-2748). D25-Planung steht in `planung.md`
   Abschnitt 14: neues Modul `l10n_at_payroll_agent`, ir.config_parameter plus
   eigene Gruppe, serverseitiger Client, hart kodierte Kontext-Whitelist
   (facts key/value/note, keine Personendaten), Pilot-Workflow
@@ -37,7 +37,16 @@ verlinkt; danach D25/M4-Planung.
   Draft-Payslip, Agent liefert strukturiertes Verdict), Agent-M4.2:
   `mode=review` plus context-Schema, drei Beweisklassen, Injection-Abgrenzung
   und Feature-Flag `PV_REVIEW_MODE` (default aus). Nicht-Ziele fixiert.
-  Offen: Mapping Odoo-KV-SI-Codes ↔ KB kv-kvt-IDs.
+- **KV-Varianten-Mapping (Odoo ↔ KB, 2026-09-16):** Die KV-Library führt
+  bereits `wko/match-report.json` (wko_slug → oegb_variant_id; 407 matched /
+  32 low / 175 unmatched). `tools/build_kv_variant_map.py` erzeugt daraus
+  `tools/catalogs/kv_variant_map.json`: 105 Varianten (98 matched, 7 low),
+  439/614 KB-Einträge abgedeckt; je Variante `docs` mit kv_kvt_id + slug +
+  doctype als Paare, Low-Confidence markiert, Rest in `unmatched_kb_entries`
+  (WKO-aktuelle Dokumente ohne ÖGB-Gegenstück, z. B. KV-Abschluss-News).
+  Odoo kann pro `library_variant_id` die zugehörigen KB-Einträge auflösen;
+  Seed-Abdeckung SI-2203/SI-2748 testet
+  `tests/test_kv_variant_map.py`. Tests gesamt **98 grün**.
 
 ## Completed (2026-09-14)