Document cleanup roadmap: split PR #90 and DUnitX-first

[omonien]

For Markus — please read this first

This PR is documentation only. It records the agreed cleanup strategy so the following product/test PRs have a shared context.

The core idea

Open contribution PR #90 (ChaCha20-Poly1305) currently mixes two independent concerns:

1. AEAD architecture / multi-call authenticated modes (touches GCM/CCM contracts)
2. ChaCha20 / XChaCha20 / Poly1305 feature work (new algorithms, SIMD, etc.)

Merging that as one unit would force an all-or-nothing review of a large change set and make regressions hard to attribute. The roadmap therefore says:

• Do not merge PR Basically a first implementation of the chacha20 Poly1305 algorithm #90 as a single unit
• Treat it as a donor / reference branch
• Split later into: AEAD architecture package first, then ChaCha features on top

Binding work order (short)

1. Repo hygiene + this roadmap
2. DUnit → DUnitX migration (DUnit kept for comparison)
3. Fix red tests that the full suite already shows (Keccak vectors, GCM multi-chunk)
4. Only then: AEAD architecture from PR Basically a first implementation of the chacha20 Poly1305 algorithm #90 concern A
5. Then: ChaCha/Poly1305 from PR Basically a first implementation of the chacha20 Poly1305 algorithm #90 concern B

Why tests first?

Architecture and cipher merges need one trustworthy automated suite. Dual DUnit/DUnitX with incomplete coverage weakens the signal when we start touching cipher modes.

What to review

• Docs/Cleanup-Roadmap.md only
• Does the split of PR Basically a first implementation of the chacha20 Poly1305 algorithm #90 and the ordering match how you want to steer the project?

Risk

None (docs only). Easy to amend later.

Note

Later PRs (DUnitX, GCM) may extend this file. This PR is the initial planning snapshot for discussion.

[omonien]

Cleanup package index (for review)

Hallo Markus — hier die Übersicht der sechs getrennten PRs gegen development. Sie hängen thematisch zusammen, sind aber bewusst einzeln review- und mergebar.

Paket A — Fundament

PR	Thema	Art
#95	Align .gitignore with DelphiStandards	Hygiene
#96 (dieser PR)	Cleanup-Roadmap: PR #90 splitten, DUnitX zuerst	Docs / Strategie
#97	DUnitX-Migration, DUnit bleibt zum Vergleich	Test-Infrastruktur

Paket B — Rote Suite / Produktkorrekturen

PR	Thema	Art
#98	Keccak-Unit-Tests (Vektoren, Unicode expected, pure KATs)	nur Tests
#99	GCM Multi-Call Streaming (GHASH + CTR, Tag in Done)	Produktfix
#100	SHA3/Keccak große Puffer / HashBenchmark (#94)	Produktfix + Demo

Empfohlene Reihenfolge

1. Document cleanup roadmap: split PR #90 and DUnitX-first #96 (dieser PR) — strategischer Überblick
2. Align .gitignore with DelphiStandards template #95 — trivial, jederzeit
3. DUnitX migration: full suite parity, keep DUnit for comparison #97 — Test-Fundament
4. Fix Keccak unit tests and add pure Keccak known-answer tests #98 → Fix SHA3/Keccak large-buffer Absorb OutOfRange (closes #94) #100 → Fix GCM multi-call Encode/Decode streaming (GHASH + CTR) and multi-chunk tests #99 — die drei Fixes (#99 GCM am sorgfältigsten)

#98, #99 und #100 sind untereinander unabhängig.

Bewusst nicht in diesem Paket

• AEAD-Architektur aus PR Basically a first implementation of the chacha20 Poly1305 algorithm #90 (Concern A)
• ChaCha20 / XChaCha20 / Poly1305 (Concern B)
• DUnit endgültig entfernen

Details und Begründungen stehen in den jeweiligen PR-Beschreibungen und in Docs/Cleanup-Roadmap.md (dieser PR).