epub-translator-studio

09. Backlog do uzgodnienia

Status:

• M1 wdrozone w kodzie i dokumentacji (2026-02-08),
• M2 wdrozone w kodzie i CI (2026-02-08),
• M3 zrealizowane: Wiki backend aktywny, opublikowane strony Home, _Sidebar, Workflow-and-Recovery (Issue 7 domkniete),
• M4 domkniete: memory-first translation (cache + decision memory + adaptive prompting), z domknietymi metrykami ledgera/retry/timeout i eksportem release notes,
• M5 zrealizowane: EPUB-aware segmentacja i integralnosc markup (­, inline tags),
• M6 zrealizowane: diff-aware retranslation + semantic diff gate do recenzji,
• M7 domkniete: pelny series manager (termy + style rules + lorebook + historia), prompt augmentation kontekstem serii, orchestrator batch serii + raport.
• Increment Async I/O: zrealizowany etap preflight providerow/pluginow (asynchroniczne health-checki i telemetryka), bez zmiany deterministycznego pipeline translacji.
• Milestone M3-M7 i ich issue sa domkniete na GitHub.
• Milestone M8 jest domkniety (issue: #45-#49 zamkniete).
• Milestone M9 jest domkniety (#51 zamkniete jako issue-umbrella).
• Milestone M10 jest domkniety (#53-#55 zamkniete).
• Security hardening CI/repo zostal wdrozony (CodeQL, Dependabot updates, gate HIGH,CRITICAL, blokujacy gate CVE).

Cel

Zamienic roadmape na konkretne, mierzalne zadania z jasnym zakresem i kryteriami akceptacji.

Aktywne milestone’y

1. Brak otwartych milestone’ow (stan po domknieciu M10).
2. M10: Easy Mode Delivery Tracks (domkniety)
3. M8: Async Runtime + Release Automation (domkniety)

M8: Async Runtime + Release Automation

Status M8: domkniety.

Issue #45: Async translation dispatcher z kontrolowana wspolbieznoscia i rate-limit

• Zakres:
  • io_concurrency provider-aware dla zapytan API,
  • semafor i kolejka requestow bez naruszenia idempotencji,
  • kompatybilnosc z retry/backoff/cancel i ledgerem.
• Done:
  • brak duplikatow ledgera przy io_concurrency > 1,
  • zgodnosc wynikow dla io_concurrency = 1,
  • testy regresji i benchmark wydajnosci.

Issue #46: Mocniejsze typowanie i walidacja kontraktow runtime

• Zakres:
  • doprecyzowanie kontraktow typow w modulach runtime/provider/repository,
  • check typow w CI (uzgodniony scope),
  • runtime validation wejsc i payloadow.
• Done:
  • type-check przechodzi,
  • bledne kontrakty sa wyłapywane early-fail,
  • brak regresji funkcjonalnych.

Issue #47: Automatyzacja release notes (CHANGELOG + metryki runtime)

• Zakres:
  • generator release notes,
  • workflow CI do draft release,
  • standard sekcji: zmiany/ryzyka/migracja/testy.
• Done:
  • jedna komenda buduje gotowy draft .md,
  • CI publikuje artefakt i szkic release.

Issue #48: Telemetryczny health-check providerow (historia + trendy)

• Zakres:
  • trwały zapis pomiarow health-check,
  • trend/failure streak w UI,
  • progi alertow i retencja.
• Done:
  • historia pomiarow zapisywana i czytelna w dashboardzie,
  • testy DB i prezentacji danych przechodza.

Issue #49: Konfigurowalne language guards dla dowolnego jezyka docelowego

• Zakres:
  • UI/config dla guard profili (hint words, chars, progi),
  • import/export profili,
  • integracja z target_lang runtime.
• Done:
  • mozna dodac nowy profil jezykowy bez zmiany kodu,
  • profile sa walidowane i trwale,
  • testy custom guardow przechodza.

M9: Easy Mode One-File Workflow

Status M9: domkniety (issue umbrella #51 zamkniete; realizacja rozbita na M10).

Issue #51: Easy Mode umbrella

• Status:
  • zamkniete na GitHub jako issue-umbrella,
  • zakres podzielony na mniejsze, wdrazalne strumienie w M10 (#53, #54, #55).

M10: Easy Mode Delivery Tracks

Status M10: domkniety.

Issue #53: Prompt Router: segment-aware system prompt selection

• Zakres:
  • routing promptu systemowego zaleznie od typu segmentu i kroku runu,
  • spojnosc doboru promptow miedzy translacja i redakcja,
  • testy wyboru promptu i fallbackow.
• Done:
  • prompt jest wybierany deterministycznie wg reguly segmentowej,
  • fallback nie przerywa runu przy brakach konfiguracji,
  • testy regresji przechodza.

Issue #54: Easy Startup: auto-pathing and auto-resume (no-config)

• Zakres:
  • automatyczne podpowiadanie sciezek input/output/cache,
  • automatyczne wznowienie po bezpiecznym wykryciu stanu pending/running,
  • ograniczenie liczby decyzji wymaganych od nowego uzytkownika.
• Done:
  • uzytkownik moze zaczac run bez recznego konfigurowania pelnego zestawu sciezek,
  • scenariusz resume dziala przewidywalnie po przerwaniu,
  • testy integracyjne startup/resume przechodza.

Issue #55: Reliability UX: silent wait-and-retry for transient provider errors

• Zakres:
  • cichy mechanizm wait-and-retry dla bledow chwilowych providera,
  • czytelny sygnal w logu/statusie bez blokowania UX,
  • zachowanie idempotencji ledgera przy retry.
• Done:
  • transient fail nie powoduje natychmiastowego hard-fail runu,
  • retry nie duplikuje segmentow ani wpisow ledgera,
  • telemetry retry jest widoczna i testowana.

M1: UI Consistency + UX Telemetry

Status M1: zrealizowane.

Issue 1: Ujednolicenie statusow etapow (Tkinter classic + horizon)

• Zakres:
  • jedno slownictwo i mapowanie statusow (idle/pending/running/ok/error) w obu interfejsach,
  • jeden format podsumowania projektu.
• Done:
  • te same statusy widoczne w obu wariantach Tkinter (classic i horizon),
  • test manualny: ten sam projekt pokazuje zgodne statusy po odswiezeniu UI.

Issue 2: Panel “Ostatnie akcje” (inline timeline)

• Zakres:
  • timeline ostatnich zdarzen runu/projektu bez otwierania osobnego popupu,
  • stale miejsce na ekranie glownym.
• Done:
  • min. 20 ostatnich wpisow,
  • wpis zawiera czas + krok + status + skrot komunikatu.

Issue 3: Mini-metryki runu

• Zakres:
  • czas runu,
  • segmenty przetworzone,
  • hit-rate cache/TM.
• Done:
  • metryki widoczne po zakonczeniu runu w obu wariantach Tkinter,
  • brak regresji aktualnego logowania.

M2: CI Hardening + Test Coverage

Status M2: zrealizowane.

Issue 4: Testy jednostkowe parsera EPUB

• Zakres:
  • testy OPF/spine/manifest,
  • testy bezpiecznej segmentacji XHTML (inline tags).
• Done:
  • testy uruchamiane w CI,
  • minimalne pokrycie dla krytycznych sciezek parsera.

Issue 5: Smoke runtime/UI Tkinter

• Zakres:
  • smoke uruchomienia GUI i warstwy runtime (project-tkinter/scripts/smoke_gui.py),
  • szybka walidacja startu i podstawowych przejsc statusow projektu.
• Done:
  • zielony smoke w PR checks,
  • czytelny raport bledu przy regresji.

Issue 6: Skan sekretow i zaleznosci

• Zakres:
  • skan sekretow w CI,
  • podstawowy audit zaleznosci.
• Done:
  • workflow blokuje merge przy krytycznych wynikach.

M3: Workflow + Docs + Wiki

Status M3: zrealizowane (3/3 issue zamkniete).

Issue 7: Inicjalizacja i utrzymanie Wiki

• Zakres:
  • utworzenie pierwszej strony wiki (Home),
  • dodanie menu bocznego i linkow do docs/.
• Done:
  • /wiki dziala bez przekierowania na strone repo,
  • wiki ma minimum 1 strone i sidebar.

Status: zrealizowane (Wiki backend aktywny i zsynchronizowany skryptem publikacji).

Postep:

• pakiet stron wiki opublikowany: Home, _Sidebar, Workflow-and-Recovery,
• backend Wiki aktywny (epub-translator-studio.wiki.git),
• publikacja wykonywana skryptem project-tkinter/scripts/publish_wiki.ps1.

Issue 8: Release checklist i changelog discipline

• Zakres:
  • szablon release notes z sekcjami: zmiany, ryzyka, migracja, testy,
  • checklista przed tagiem/release.
• Done:
  • kazdy release ma jednolity opis i jasny scope.

Status: zrealizowane.

Issue 9: Dokumentacja “2 komputery” + odzyskiwanie po awarii

• Zakres:
  • dopisanie scenariuszy odzyskiwania (db/cache/lock),
  • szybki playbook “co robic po crashu”.
• Done:
  • instrukcja krok-po-kroku w docs/03 lub nowym rozdziale.

Status: zrealizowane.

M4: Memory-First Translation Engine

Status M4: zrealizowane.

Issue #26: Segment cache + hash reuse (book memory)

• Zakres:
  • zapis hash(segment) -> translation na poziomie ksiazki,
  • reuse juz przetlumaczonych segmentow bez ponownego kosztu API,
  • raport cache hit/miss po runie.
• Done:
  • ponowny run tej samej ksiazki reuzywa gotowe segmenty,
  • cache jest odporny na restart aplikacji,
  • metryki cache sa widoczne w podsumowaniu runu.

Status: zrealizowane:

1. ledger segmentow jest seedowany upfront dla calego EPUB (PENDING dla calego zakresu),
2. restart runu korzysta z ledgera (COMPLETED) bez utraty idempotentnosci,
3. ledger jest czyszczony z nieaktualnych segmentow po zmianie zrodla,
4. metryki ledgera sa eksportowane do widoku release notes (Studio Tools -> Dashboard),
5. telemetry retry/timeouts per provider (Google/Ollama) jest widoczne w runtime i historii runow,
6. alert progowy ERROR > N jest pokazywany bezposrednio przy pasku ledgera.

Issue #34: Model-specific prompt presets (GUI)

• Zakres:
  • katalog presetow promptow z filtrowaniem po provider i mode,
  • szybkie zastosowanie presetu z GUI (Apply preset) bez recznego przepisywania promptu,
  • testy jednostkowe logiki ladowania i filtrowania presetow.
• Done:
  • presety Gemini widoczne w sekcji Silnik i parametry batch,
  • zapis aktywnego presetu i promptu jest trwaly (UI state SQLite),
  • testy presetow przechodza lokalnie i w CI.

Status: zrealizowane.

Issue #27: Human-in-the-loop decision memory + adaptive few-shot

• Zakres:
  • zapamietywanie zatwierdzonych decyzji redaktora (segment_hash -> approved_translation),
  • automatyczne budowanie few-shot kontekstu dla kolejnych segmentow tej samej ksiazki,
  • priorytet decyzji redaktora nad surowym wynikiem modelu.
• Done:
  • narzedzie podpowiada kolejne tlumaczenia na bazie zatwierdzonych fragmentow,
  • decyzje redaktora sa trwale i wersjonowane,
  • wzrost spojnosci terminow bez recznego glosariusza.

M5: EPUB-Aware Segmentation + Markup Integrity

Status M5: zrealizowane.

Issue #28: EPUB-aware segmentacja (dialogi, cytaty, inline tags)

• Zakres:
  • segmentacja respektuje granice logiczne EPUB (dialogi, cytaty, naglowki),
  • nie rozcina krytycznych struktur inline (<i>, <b>, <a>),
  • testy regresji na trudnych fragmentach dialogowych.
• Done:
  • brak rozcietych dialogow i uszkodzen struktury XHTML po segmentacji,
  • testy parsera przechodza dla przypadkow dialog/cytat/inline,
  • output zachowuje poprawnosc renderingu.

Status: zrealizowane:

1. edytor klasyczny ma tokeny inline ([[TAG###]]) z blokada modyfikacji tagow,
2. tokenizacja dziala na poziomie nested-inline chips (open/close) z granularna edycja tylko tekstu miedzy tokenami,
3. zapis segmentu nie splaszcza struktury inline XHTML,
4. dodano dodatkowe testy regresji nested-inline (roundtrip tokenow).

Issue #33: Ochrona ­ i encji typograficznych

• Zakres:
  • zachowanie ­,   i kluczowych encji podczas translacji/redakcji,
  • walidator integralnosci encji przed/po runie,
  • raport roznic encji do szybkiej kontroli.
• Done:
  • brak utraty ­ po runie,
  • automatyczny test integralnosci encji przechodzi,
  • brak regresji czytelnosci na malych ekranach czytnikow. Status: zrealizowane: 1. walidator integralnosci encji porownuje przed/po runie (­,   i warianty numeryczne/Unicode), 2. raport roznic encji jest emitowany w logu runtime ([ENTITY-INTEGRITY]), 3. test regresyjny wykrywa utrate encji.

M6: Smart Retranslation + Semantic Diff QA

Status M6: zrealizowane.

Issue #29: Diff-aware retranslation po zmianie zrodla

• Zakres:
  • wykrywanie zmienionych segmentow po edycji EPUB zrodlowego,
  • retranslacja tylko zmienionych (plus opcjonalne sasiedztwo N),
  • reuse cache/TM dla niezmienionych fragmentow.
• Done:
  • raport changed/reused/retranslated,
  • brak potrzeby pelnej retranslacji po drobnych poprawkach,
  • skrocony czas runu dla malych zmian. Status: zrealizowane: 1. cache-prefix traktowany jest jako sygnal zmiany segmentu (diff-aware), 2. zmienione segmenty sa retranslowane zamiast slepego reuse, 3. runtime emituje raport [M6-DIFF] changed/reused/retranslated.

Issue #30: Semantic diff gate (embedding) dla recenzji

• Zakres:
  • porownanie semantyczne wersji tlumaczenia (embedding-based),
  • oznaczanie “zmiana sensu” vs “zmiana kosmetyczna”,
  • priorytetyzacja segmentow do recenzji manualnej.
• Done:
  • segmenty o niskiej roznicy semantycznej moga byc auto-accepted,
  • segmenty o wysokiej roznicy trafiaja na liste recenzji,
  • raport QA pokazuje progi i decyzje bramki semantycznej. Status: zrealizowane: 1. semantic gate porownuje poprzednia i nowa wersje tlumaczenia (score 0..1), 2. segmenty ponizej progu trafiaja automatycznie do qa_findings jako SEMANTIC_DIFF, 3. raport runtime pokazuje liczbe findings i aktywne progi.

M7: Series Style Memory + Batch Library

Status M7: zrealizowane.

Issue #31: Profile stylu serii (tone memory)

• Zakres:
  • profile stylu/tonu reuzywalne miedzy tomami,
  • przypisanie projektu do profilu stylu,
  • import/eksport i wersjonowanie profili.
• Done:
  • ten sam profil mozna stosowac w wielu ksiazkach serii,
  • profile sa latwe do backupu i przenoszenia,
  • widoczna poprawa spojnosci stylu miedzy tomami.

Status:

• zrealizowane:
  1. projekty maja series_id i volume_no,
  2. autodetekcja serii z metadanych EPUB (OPF),
  3. osobna baza serii (data/series/<slug>/series.db),
  4. panel Series manager (termy + style_rules + lorebook + historia zmian change_log),
  5. merge slownika serii z glosariuszem projektu na etapie runu,
  6. prompt augmentowany automatycznie kontekstem serii (style/lore/approved terms),
  7. import/export profilu serii (series_profile.json).

Issue #32: Batch library + opcjonalny tor LoRA/QLoRA

• Zakres:
  • batch processing wielu EPUB z jednym profilem stylu,
  • zbiorczy raport jakosci/spojnosci dla calej serii,
  • eksperymentalny tor eksportu danych pod lokalny fine-tuning (LoRA/QLoRA).
• Done:
  • mozliwe uruchomienie wsadowe wielu ksiazek,
  • raport koncowy jest czytelny per ksiazka i globalnie,
  • dokumentacja oddziela tryb produkcyjny od eksperymentalnego fine-tuning.

Status:

• zrealizowane:
  1. orchestrator batch serii (queue po serii dla biezacego kroku translate/edit),
  2. uruchamianie run-all dla serii jednym kliknieciem,
  3. raport zbiorczy serii (series_batch_report_*.json/.md) z postepem i statusem projektow.
• poza zakresem M7:
  1. eksperymentalny tor LoRA/QLoRA pozostaje opcjonalnym backlogiem R&D.

Kolejnosc realizacji (zaktualizowana)

1. M8#45 (Async dispatcher) - najpierw.
2. M8#46 (typowanie/kontrakty) rownolegle z #45.
3. M8#48 (telemetria historii health-check) po bazowym async.
4. M8#47 (release automation) po ustabilizowaniu danych metryk.
5. M8#49 (custom language guards) jako increment UX/runtime.
6. M9#50 (Global Entity Glossary) jako pierwszy krok jakosci literackiej.
7. M9#52 (Dynamic Token Balancing) rownolegle z #50 po stabilizacji kontraktow.
8. M9#51 (Confidence/Risk scoring) po wdrozeniu #50 i #52.
9. M9#53 (MCP read-only) po ustabilizowaniu danych i score.
10. M9#54 (MCP write + audit gate) na koniec, po twardym modelu uprawnien.

Definicja publikacji milestone

Milestone publikujemy jako “gotowy do realizacji”, gdy:

1. kazde issue ma zakres + kryteria Done,
2. kazde issue ma etykiete i priorytet,
3. jest podana kolejnosc wdrozenia (co first, co later),
4. zespol zna zaleznosci miedzy issue.

This site is open source. Improve this page.