# Risk Register

Scales: likelihood and impact are Low, Medium, or High. The owner should update status at each project checkpoint.

| ID | Risk | Likelihood | Impact | Early indicator | Mitigation | Contingency | Owner | Status |
|---|---|---|---|---|---|---|---|---|
| R01 | No declared license for `Ransaka/TrOCR-Sinhala` | High | High | No license tag or file | Request explicit clarification; retain evidence; attribute upstreams | Keep repository research-only and do not publish weights | Researcher | Open |
| R02 | Synthetic-to-real domain shift | High | High | Validation improves while real CER remains weak | Use real frozen test benchmark; report gap; add pre-declared augmentation only in later exploratory phase | Publish negative result and design Phase 1 domain adaptation | Researcher | Open |
| R03 | Line segmentation confounds recognition | High | High | Errors cluster around bad crops or merged lines | Version segmentation pipeline; audit a deterministic sample; retain crop coordinates | Report recognition and segmentation failures separately | Researcher | Open |
| R04 | Older documents perform substantially worse | High | Medium | Period-level CER rises for early years | Report period-stratified metrics; document typography and degradation | Limit intended use and prioritize later historical augmentation | Researcher | Open |
| R05 | Test-set leakage during benchmark construction | Medium | High | References corrected after predictions are viewed | Freeze benchmark before evaluation; checksum manifests; blind correction workflow | Create a new untouched holdout | Researcher | Open |
| R06 | Too few independent real test units | Medium | Medium | Wide confidence intervals | Report paired bootstrap intervals and exact sample counts | Add a separately licensed benchmark without merging claims improperly | Researcher | Open |
| R07 | Colab or GPU interruption | Medium | Medium | Runtime disconnects or out-of-memory errors | Save each epoch; log revisions; use FP16 and gradient accumulation | Resume from last complete checkpoint under protocol rules | Researcher | Open |
| R08 | Non-deterministic training | Medium | Medium | Large seed-to-seed variance | Fix seeds; record environment; run three seeds | Increase runs in an explicitly amended protocol | Researcher | Open |
| R09 | Inconsistent text normalization | Medium | High | Metric changes across scripts | Centralize normalization; unit test examples; report raw and normalized scores | Recompute all systems using the corrected fixed pipeline | Researcher | Open |
| R10 | Baselines evaluated on different units | Medium | High | Page metrics compared with line metrics | Label evaluation unit in every table; run local baselines on identical lines | Treat published page results as context only | Researcher | Open |
| R11 | Surya terms change or are misinterpreted | Medium | Medium | Conflicting license thresholds | Pin version and archive current terms before use | Omit Surya and retain Tesseract as required baseline | Researcher | Open |
| R12 | Public documents contain personal names | Low | Medium | Named individuals appear in extracted text | Minimize retained text; preserve provenance; review redistribution | Release aggregate metrics and restricted examples only | Researcher | Open |
| R13 | Model card overstates readiness | Medium | High | Unqualified benchmark or production claims | Use release gates; distinguish page and line results; maintain limitations | Correct card and issue a new version note | Researcher | Open |
| R14 | Placeholder metrics mistaken for results | Medium | High | Zero values appear in metadata | Do not add `model-index` until results exist; use `TBD` only in prose | Remove incorrect metadata immediately | Researcher | Controlled |
| R15 | Dependency or dataset revision drift | Medium | Medium | Re-run changes without code edits | Pin revisions and environment; save lock file or environment export | Reproduce using the archived manifest | Researcher | Open |

## Review cadence

Review this register:

1. Before data download
2. Before the first training run
3. Before final-test evaluation
4. Before any public release

Close a risk only when evidence is recorded in the repository.