feat(examples): ship two real local calendars, with their limits stated

Poland and the Benedictines, in the flat INI form, installed beside the
invented diocesan example.

poland.ini -- 17 entries from the Calendarium Perpetuum pro Dioecesium
Poloniae (1964), promulgated under Rubricarum instructum and applying to the
1962 Missal. Transcribed from a published Polish EF ordo that names that same
calendar, cross-checked against missalemeum's supplement page for the two
formularies 1964 added (13 and 15 July). Date, Latin name and class were read
from the source for every entry; three classes could not be recovered from
the PDF's column layout and are marked INFERRED where they appear, with the
reasoning. The header carries an edition warning that is a real trap here:
the Proprium Poloniae of 1921 and 1934 is still bound into many missals and
carries an outdated arrangement of dioceses and ranks. It is not this
calendar, and it is exactly the kind of plausible wrong-edition source that
has cost this project time before.

benedictine.ini -- two entries, and the comment explaining why is the point of
shipping it. Counted across the Norcia ordo: 86 "I cl.", 43 "II cl.", ZERO
"III cl." and ZERO "IV cl.", against 103 "Semidup." and ~96 "Dup.". The
monastic rite uses the Roman classes at the top and the older Duplex /
Semiduplex grades below, exactly where the Roman calendar has III and IV
class. colitur's rank vocabulary cannot express those, so most Benedictine
propers cannot be written here at all -- a mismatch of vocabularies between
related rites, not a gap in the data. Rather than invent a Duplex -> Class3
mapping the source never states, that file ships only what its ordo gives in
Roman terms and lists roughly two dozen excluded feasts BY NAME, so the
omission is visible instead of silent.

Both headers say plainly that they are examples and not authorities: they are
transcriptions from published ordines, none of the five test layers can vouch
for either, and both should be checked against the reader's own ordo. The
cram test asserts only what we control -- that they parse, convert and apply
-- and says so.

They also demonstrate the precedence engine on real data: the Benedictine
Transitus is I class and takes 21 March with the Lenten feria commemorated,
and Maurus is II class and takes 15 January with Paul the First Hermit
commemorated.

1 files changed, 177 insertions, 0 deletions

diff --git a/data/ef/examples/poland.ini b/data/ef/examples/poland.ini
new file mode 100644
index 0000000..cf7934b
--- /dev/null
+++ b/data/ef/examples/poland.ini
@@ -0,0 +1,177 @@
+; ---------------------------------------------------------------------------
+; PROPER CALENDAR OF THE DIOCESES OF POLAND -- an EXAMPLE overlay.
+;
+; SOURCE. Calendarium Perpetuum pro Dioecesium Poloniae (1964), promulgated
+; under Pope John XXIII's motu proprio Rubricarum instructum (25 July 1960)
+; and applying to the 1962 Missale Romanum. Transcribed from the Rubrycela
+; Mszalna wedlug Nadzwyczajnej Formy Rytu Rzymskiego (grzegorzwielki.pl), a
+; published Polish EF ordo that states it follows that same 1964 calendar,
+; cross-checked against missalemeum's own supplement page for the calendar's
+; 1964 additions (13 and 15 July below).
+;
+; EDITION WARNING, and it is a real trap. The Proprium Poloniae of 1921 and
+; of 1934 is still bound into many missals and is easy to find. The Rubrycela
+; states plainly that those carry an outdated arrangement of dioceses and
+; outdated ranks. They are NOT this calendar. Anything you add here must come
+; from the 1964 calendar or later, not from a pre-war proprium that happens to
+; be to hand.
+;
+; WHAT IS AND IS NOT VERIFIED. Date, Latin name and class were read from the
+; ordo for every entry below. Three classes could not be read from it -- the
+; column carrying them was not recoverable from the PDF -- and are marked
+; INFERRED where they appear, with the reasoning. An inference is stated as an
+; inference here, never quietly written as though it were sourced.
+;
+; NOT AUTHORITATIVE. This is an example, shipped to show what a real local
+; calendar looks like. colitur's test layers assert things about the SHIPPED
+; universal calendar and cannot vouch for this file (see colitur-overlay(5)).
+; Check it against your own diocese's ordo before using it for anything that
+; matters: several of these feasts are proper to particular dioceses rather
+; than to all of Poland, and a diocesan calendar is not a national one.
+;
+;   colitur convert poland.ini > poland.sexp
+;   colitur check poland.sexp
+;   colitur day 2026 --overlay poland.sexp
+; ---------------------------------------------------------------------------
+
+[overlay]
+id = poland-1964
+
+; --- Principal patrons of Poland ------------------------------------------
+; Class INFERRED as class-1: RG 91 entries 12-13 rank the principal patron of
+; a place at I class, and the ordo marks both "PATRONI PRINCIPALIS POLONIAE".
+; The ordo's own class column was not recoverable for these two rows.
+[adalbert-of-prague]
+date    = 04-23
+rank    = class-1
+colour  = red
+name.la = S. Adalberti Episcopi et Martyris, Patroni Principalis Poloniae
+name.en = St Adalbert, Bishop and Martyr, Principal Patron of Poland
+name.pl = sw. Wojciecha, Biskupa i Meczennika, Glownego Patrona Polski
+
+[stanislaus-bishop-martyr]
+date    = 05-08
+rank    = class-1
+colour  = red
+name.la = S. Stanislai Episcopi et Martyris, Patroni Principalis Poloniae
+name.en = St Stanislaus, Bishop and Martyr, Principal Patron of Poland
+name.pl = sw. Stanislawa, Biskupa i Meczennika, Glownego Patrona Polski
+
+; --- Marian feasts of Poland ----------------------------------------------
+; Class INFERRED as class-1 for the same reason: Our Lady Queen of Poland is
+; the national patronal feast. The ordo's class column was not recoverable.
+[bvm-queen-of-poland]
+date    = 05-03
+rank    = class-1
+colour  = white
+name.la = B. Mariae Virginis Reginae Poloniae
+name.en = Our Lady, Queen of Poland
+name.pl = Najswietszej Maryi Panny Krolowej Polski
+
+; Read from the ordo as a particular ("part.") celebration -- proper to
+; certain places rather than universal in Poland. Class not recoverable;
+; class-2 is INFERRED and is the conservative reading.
+[bvm-czestochowa]
+date    = 08-26
+rank    = class-2
+colour  = white
+name.la = B. Mariae Virginis Claromontanae seu Czenstochoviensis
+name.en = Our Lady of Czestochowa
+name.pl = Najswietszej Maryi Panny Czestochowskiej
+
+; --- Secondary patrons, class read from the ordo ---------------------------
+[andrew-bobola]
+date    = 05-16
+rank    = class-2
+colour  = red
+name.la = S. Andreae Bobola Presbyteri et Martyris, Patroni Poloniae
+name.en = St Andrew Bobola, Priest and Martyr, Patron of Poland
+name.pl = sw. Andrzeja Boboli, Kaplana i Meczennika, Patrona Polski
+
+[stanislaus-kostka]
+date    = 11-13
+rank    = class-2
+colour  = white
+name.la = S. Stanislai Kostka Confessoris, Patroni Secundarii Poloniae
+name.en = St Stanislaus Kostka, Confessor, Secondary Patron of Poland
+name.pl = sw. Stanislawa Kostki, Wyznawcy, Drugorzednego Patrona Polski
+
+; --- Polish saints and beati, all class-3, all read from the ordo ----------
+[sadoc-and-companions]
+date    = 06-02
+rank    = class-3
+colour  = red
+name.la = Bb. Sadoc et Sociorum Martyrum
+name.en = Bl. Sadoc and Companions, Martyrs
+
+; The two formularies the 1964 calendar ADDED (missalemeum's supplement page
+; names exactly these two as new in 1964).
+[andrew-svorad-and-benedict]
+date    = 07-13
+rank    = class-3
+colour  = white
+name.la = Ss. Andreae Svorad et Benedicti Confessorum
+name.en = Sts Andrew Svorad and Benedict, Confessors
+
+[bruno-boniface-of-querfurt]
+date    = 07-15
+rank    = class-3
+colour  = red
+name.la = S. Brunonis Bonifatii de Querfurt Episcopi et Martyris
+name.en = St Bruno Boniface of Querfurt, Bishop and Martyr
+
+[simon-of-lipnica]
+date    = 07-18
+rank    = class-3
+colour  = white
+name.la = B. Simonis de Lipnica Confessoris
+name.en = Bl. Simon of Lipnica, Confessor
+
+[kinga]
+date    = 07-24
+rank    = class-3
+colour  = white
+name.la = S. Kingae Virginis
+name.en = St Kinga, Virgin
+
+[bronislava]
+date    = 09-01
+rank    = class-3
+colour  = white
+name.la = B. Bronislavae Virginis
+name.en = Bl. Bronislava, Virgin
+
+[wladislaus-of-gielniow]
+date    = 09-25
+rank    = class-3
+colour  = white
+name.la = B. Wladislai de Gielniow Confessoris
+name.en = Bl. Wladislaus of Gielniow, Confessor
+
+[john-of-dukla]
+date    = 10-01
+rank    = class-3
+colour  = white
+name.la = S. Ioannis de Dukla Confessoris
+name.en = St John of Dukla, Confessor
+
+[vincent-kadlubek]
+date    = 10-09
+rank    = class-3
+colour  = white
+name.la = B. Vincentii Kadlubek Episcopi et Confessoris
+name.en = Bl. Vincent Kadlubek, Bishop and Confessor
+
+[jacob-strzemie]
+date    = 10-21
+rank    = class-3
+colour  = white
+name.la = B. Iacobi Strzemie Episcopi et Confessoris
+name.en = Bl. Jacob Strzemie, Bishop and Confessor
+
+[salomea]
+date    = 11-17
+rank    = class-3
+colour  = white
+name.la = B. Salomeae Virginis
+name.en = Bl. Salomea, Virgin