redline-docx-pl

Redline DOCX po polsku

Wrapper nad adeu (MIT, Dealfluence Oy) - dwukierunkowy konwerter miedzy .docx a Markdown (CriticMarkup), z aplikacja zmian z powrotem do .docx. Robi to, czego python-docx NIE potrafi: wstrzykuje natywne Word Track Changes (w:ins/w:del) i komentarze, zachowujac formatowanie, fonty i marginesy.

Cala praca lokalnie (uvx, brak chmury). Silnik testowany na polskim .docx 2026-05-22 (extract/apply/sanitize - patrz THIRD_PARTY_INSPIRATIONS.md).

Wymagania

uv (jezeli brak: pip install uv). adeu pobiera sie samo przez uvx adeu przy pierwszym uzyciu (wersja sprawdzona: 1.7.5).

Safety Tiers (KRYTYCZNE)

Przed wykonaniem każdej operacji ustal tier i zastosuj regułę:

Tier	Operacje	Reguła
R - Read-only	extract (czytanie .docx)	Bez potwierdzenia. Wykonaj od razu.
M - Mutating	apply, diff, apply --live	Pokaż użytkownikowi proponowane zmiany. Czekaj na potwierdzenie słowne.
D - Destructive	sanitize --accept-all (akceptuje wszystkie zmiany nieodwracalnie)	Użytkownik musi wpisać dosłownie: "potwierdzam" zanim wykonasz.

---

Workflow (4 kroki)

1. Czytaj - .docx do Markdown dla LLM

uvx adeu extract umowa.docx -o umowa.md

Zwraca czysty Markdown (+ opcjonalny Semantic Appendix: defined terms, cross-references, typos). LLM pracuje na semantyce, nie na surowym OOXML - kilkukrotnie mniej tokenow niz wrzucenie pliku w postaci binarnej.

2. Przygotuj liste zmian - edits.json

Format to lista obiektow modify (search-and-replace na tekscie, NIE na pozycji):

[
  {
    "type": "modify",
    "target_text": "sad wlasciwy dla siedziby Zleceniodawcy",
    "new_text": "Sad Arbitrazowy przy KIG w Warszawie",
    "comment": "Proponuje arbitraz zamiast sadu powszechnego."
  }
]

target_text musi byc jednoznaczny - adeu blokuje niejednoznaczne dopasowania ZANIM dotkna pliku (bramka walidacji). Jezeli fragment wystepuje kilka razy, doprecyzuj kontekst.

3. Aplikuj - natywne Track Changes

uvx adeu apply umowa.docx edits.json -o umowa_redline.docx --author "Kancelaria"

Daje umowa_redline.docx ze sledzonymi zmianami i komentarzami. Bez --author adeu wpisuje nazwe konta systemowego biezacego uzytkownika - zawsze podawaj --author jawnie, zeby nie wyciekla nazwa konta do dokumentu.

4. Sanitize PRZED wyslaniem - RODO

uvx adeu sanitize umowa_redline.docx -o umowa_clean.docx --keep-markup --author "Kancelaria" --report

Usuwa: creator, last modified by, template, rsid, custom XML parts; normalizuje timestampy; podmienia autorow track-changes/komentarzy na jedna nazwe. --keep-markup zachowuje sledzone zmiany (do negocjacji); bez tego (--accept-all) akceptuje wszystko i zwraca czysty dokument. Konczy werdyktem Result: CLEAN.

Zawsze rob sanitize przed wyslaniem pisma na zewnatrz. Word zostawia w metadanych nazwiska autorow, sciezki szablonow i historie edycji - to wyciek danych.

Pozostale komendy

uvx adeu diff v1.docx v2.docx          # wizualny diff dwoch wersji
uvx adeu apply --live edits.json       # edycja zywego dokumentu w Word (Windows + MS Word)

Integracja z let-it-be (PII PL)

sanitize czysci metadane Worda, ale NIE tresc. Do anonimizacji tresci (PESEL, NIP, nazwiska w fleksji) najpierw przepusc tekst przez let-it-be, potem redline:

1. let-it-be -> pseudonimizuj tresc pisma (PII -> tokeny)
2. praca/redline na zpseudonimizowanej wersji
3. adeu sanitize -> domkniecie metadanych przed wyslaniem

let-it-be = tresc (RODO art. 4 dane osobowe w tekscie); adeu sanitize = metadane pliku. Dwie rozne warstwy wycieku, obie trzeba domknac.

Ograniczenia

• Live MS Word tylko Windows + zainstalowany Word (backend Python).
• target_text na dopasowaniu tekstu - przy duplikatach trzeba kontekstu.
• adeu to narzedzie wspomagajace, NIE zastepuje weryfikacji przez prawnika.
• Silnik zewnetrzny (adeu, Dealfluence) - przy aktualizacji wersji zrob ponowny smoke test.

Atrybucja

Silnik: adeu (c) 2026 Dealfluence Oy, licencja MIT. Szczegoly i snapshot licencji: THIRD_PARTY_INSPIRATIONS.md.