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 przy pierwszym uzyciu.

🔴 WERSJA PRZYPIETA: adeu==1.30.0 (zmierzone 2026-08-24). Wszystkie komendy nizej wolaja uvx --from adeu==1.30.0 adeu, nie gole uvx adeu. Powod nie jest kosmetyczny: adeu 1.31.0 (2026-08-03) przypiela sie twardo do fastmcp[apps]==4.0.0b1

• bety frameworka pod nowy spec MCP 2026-07-28 - i kazde wydanie od tamtej pory (do 3.0.0 z 2026-08-22) jest nieosiagalne dla uvx bez --prerelease=allow. Gole uvx adeu nie wybuchalo: cicho rozwiazywalo do 1.30.0 i konczylo exit 0, a SKILL.md deklarowal 1.7.5 - trzy rozne wersje w jednym skillu, zero sygnalu. To ten sam mechanizm co [[feedback_cicha_niekompletnosc_trzy_mechanizmy]] i ta sama regula pinu co przy @firecrawl/anydoc w CLAUDE.md.

Podniesienie pinu = swiadoma decyzja, nie efekt uboczny - i dzis oznacza wejscie na bete FastMCP 4. Nie robimy tego przed freezem PATRON 2.0.0. Powierzchnia CLI 1.30.0 (zweryfikowana): extract, init, diff, apply, accept-all, markup, sanitize, help.

Safety Tiers (KRYTYCZNE)

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

Workflow (4 kroki)

1. Czytaj - .docx do Markdown dla LLM

uvx --from adeu==1.30.0 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.

Rozszerzenie schematu - pola negocjacyjne (opcjonalne)

Kazdy obiekt modify moze dostac cztery dodatkowe pola. Sluza one memo negocjacyjnemu (krok 2a), NIE trafiaja do adeu ani do drugiej strony:

[
  {
    "type": "modify",
    "target_text": "kara umowna w wysokosci 20% wartosci umowy",
    "new_text": "kara umowna w wysokosci 5% wartosci umowy, lacznie nie wiecej niz 10%",
    "comment": "Proponujemy ograniczenie kary umownej.",
    "tier": 1,
    "rationale": "20% bez limitu lacznego to ekspozycja nieproporcjonalna do wartosci kontraktu.",
    "walkaway": "Maksymalnie 10% z limitem lacznym 15%. Powyzej tego nie podpisujemy.",
    "precedent": "Umowa z kontrahentem X (2025): 5% z limitem 10% przeszlo bez sporu."
  }
]

Rozdzial widocznosci jest twardy: comment widzi druga strona (komentarz w track changes), rationale/walkaway/precedent zostaja w memo wewnetrznym.

Framework Tier 1-3 - kategorie ryzyka

Brak tier = pozycja nieskategoryzowana; memo wypisze ja osobno jako zaleglosc do klasyfikacji przez prawnika.

2a. Memo negocjacyjne (opcjonalne, dokument WEWNETRZNY)

# sciezka scripts/ wzgledem katalogu tego skilla; z katalogu sprawy podaj pelna
python scripts/memo_negocjacyjne.py edits.json -o memo.md --tytul "Umowa serwisowa - kontrahent X"
python scripts/memo_negocjacyjne.py edits.json --adeu edits_adeu.json   # kopia bez pol memo, do kroku 3

Generuje memo w Markdown: zmiany pogrupowane wg tierow, naglowek poufnosci, licznik zmian per tier, przy kazdej pozycji rationale / walkaway / precedent. Skrypt zero-dep (Python stdlib). Walidacja: tier spoza 1-3 lub tier 1 bez walkaway = exit 1.

Granica governance: memo to draft do rozmowy, nie automat. Negocjacje prowadzi czlowiek - skrypt przygotowuje mu mape pozycji, niczego nie wysyla i nie rozstrzyga. Memo NIGDY nie idzie do drugiej strony (naglowek poufnosci jest w szablonie na stale). Do adeu apply podawaj kopie z --adeu - pola negocjacyjne nie moga trafic do pliku wymienianego z kontrahentem.

3. Aplikuj - natywne Track Changes

uvx --from adeu==1.30.0 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.

3a. Skan placeholderow - bramka "czy draft nie wychodzi z dziurami"

# sciezka scripts/ wzgledem katalogu tego skilla, jak w kroku 2a
python scripts/skan_placeholder.py umowa_redline.docx        # tez .md / .txt, wiele plikow naraz
python scripts/skan_placeholder.py umowa_redline.docx --json # raport maszynowy

Wykrywa niedokonczone pola: [...], [ ], [wstaw ...], [insert ...], TBD, DO UZUPELNIENIA, $X / $___, ciagi podkreslen ___, placeholder sygnatury NN/RR, puste pola dat (dnia __, [data]) i kwot ([kwota] oraz kazde 0,00 zl - czesty artefakt niewypelnionego pola; jezeli kwota zerowa jest zamierzona, odnotuj to przy przekazaniu). Raport plik:pozycja (paragraf w .docx, linia w tekscie) + fragment kontekstu.

Zero zaleznosci (Python stdlib, .docx czytany przez zipfile). Exit 0 = czysto, exit 1 = znaleziska. Kazde znalezisko blokuje wysylke - najpierw uzupelnij pole albo swiadomie zostaw (np. kwota do wpisania przez klienta) i odnotuj to przy przekazaniu draftu czlowiekowi.

4. Sanitize PRZED wyslaniem - RODO

uvx --from adeu==1.30.0 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 --from adeu==1.30.0 adeu diff v1.docx v2.docx          # wizualny diff dwoch wersji
uvx --from adeu==1.30.0 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.
• W vendor/docx-engine/ lezy DRUGI silnik (GenOffice, Apache-2.0), zweryfikowany pomiarowo, ale NIE wpiety w zaden krok workflow. Workflow stoi w calosci na adeu. Nie wolaj go z tego skilla, dopoki nie zapadnie decyzja opisana nizej.

Atrybucja

Silnik: adeu (c) 2026 Dealfluence Oy, licencja MIT.

Wzorce memo negocjacyjnego (pola tier/rationale/walkaway/precedent, grupowanie wg tierow) i skanera placeholderow: evolsb/legal-redline-tools (MIT). PATTERN, nie kod - oba skrypty napisane od zera pod polskie realia (wzorce PL: DO UZUPELNIENIA, NN/RR, dnia __, kwoty w zl) i pod format edits.json adeu zamiast ich wlasnego formatu redlines.

Silnik wendorowany (NIEAKTYWNY): vendor/docx-engine/ - packages/docx-engine z genspark-ai/genoffice (Apache-2.0, commit 8f52328), redystrybuowany razem z LICENSE i NOTICE zgodnie z sekcjami 4(b) i 4(d) tej licencji.

Szczegoly i snapshoty licencji: THIRD_PARTY_INSPIRATIONS.md.

Drugi silnik - dlaczego lezy nieaktywny

W vendor/docx-engine/ lezy silnik round-tripu po bajtach z GenOffice (Apache-2.0), zmierzony 2026-08-05 na pismach z maszyny WM. Nie zastepuje adeu i nie wolno go wolac z tego workflow.

Pomiar sledzonych zmian (2026-08-05 wieczor, 71 pism) rozstrzygnal, ze pole SaveBlock.revision NIE produkuje Word Track Changes: w:ins/w:del laduja na poziomie w:body, tekst usuniety zostaje w w:t zamiast w:delText, a niezalezny czytnik (adeu extract) nie widzi zmiany w zadnym z 71 plikow. Druga sciezka silnika (Run.ins/Run.del) jest poprawna, ale nie daje przewagi nad adeu. Osobno zmierzono patchTableCellTexts - odbudowuje komorke zamiast ja patchowac, wiec do edycji tabel takze sie nie nadaje bez wlasnej warstwy ochronnej.

Komplet liczb i rekomendacja: THIRD_PARTY_INSPIRATIONS.md (sekcja o genoffice) oraz vendor/docx-engine/README.md. Decyzja o jakimkolwiek wpieciu nalezy do WM.