redline-docx-pl

name	redline-docx-pl
description	Redlining polskich umow i pism w .docx z natywnymi Word Track Changes - bez niszczenia formatowania OOXML. Czyta .docx do Markdown (CriticMarkup) dla LLM, aplikuje zmiany jako sledzone (w:ins/w:del) + komentarze, i robi sanitize przed wyslaniem (strip metadanych autora, last-modified-by, rsid, timestampy - RODO przy wysylce pisma). Silnik = adeu (MIT). Use when the user wants to nanosic poprawki w umowie/pismie .docx, zrobic redline/tryb sledzenia zmian, czytac docx dla LLM bez utraty formatowania, przygotowac pismo do wyslania (usunac metadane autora z Worda), porownac dwie wersje .docx, lub mentions track changes / sledzenie zmian / redline / .docx / DOCX.
license	MIT
attribution	[{"source":"dealfluence/adeu","url":"https://github.com/dealfluence/adeu","license":"MIT","relationship":"dependency","note":"Silnik konwersji i aplikacji zmian, wolany przez uvx. Skill go opakowuje, nie wywodzi sie z jego kodu.\n"},{"source":"evolsb/legal-redline-tools","url":"https://github.com/evolsb/legal-redline-tools","license":"MIT","relationship":"pattern-only","note":"Wzorce memo negocjacyjnego (tier/rationale/walkaway/precedent) i skanera placeholderow. Oba skrypty napisane od zera pod realia polskie.\n"},{"source":"genspark-ai/genoffice","url":"https://github.com/genspark-ai/genoffice","license":"Apache-2.0","relationship":"vendored","note":"packages/docx-engine wendorowany do vendor/docx-engine (commit 8f52328, Apache-2.0). Silnik round-trip po bajtach. Zmierzony 2026-08-05 (round-trip, sledzone zmiany, tabele), NIE wpiety w workflow skilla - sledzonych zmian nie robi poprawnie na sciezce blokowej. Szczegoly i wykaz zmian w vendor/docx-engine/NOTICE i README.md.\n"}]
allowed-tools	["Bash","Read","Write","Edit"]
data-residency	local
requires-human-approval	true
pii-egress	none

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), skan_placeholder.py, memo_negocjacyjne.py (pisza tylko nowe pliki raportu/memo)	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"