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, 89 insertions, 0 deletions

diff --git a/data/ef/examples/benedictine.ini b/data/ef/examples/benedictine.ini
new file mode 100644
index 0000000..2ca9c89
--- /dev/null
+++ b/data/ef/examples/benedictine.ini
@@ -0,0 +1,89 @@
+; ---------------------------------------------------------------------------
+; BENEDICTINE PROPER -- a DELIBERATELY PARTIAL example, and the reason why is
+; the most useful thing in this file.
+;
+; SOURCE. Ordo Divini Officii ... juxta Ritum Romano-Monasticum et
+; Consuetudines Abbatiae Sancti Benedicti in Monte Nursiae, pro anno 2026
+; (the Monks of Norcia).
+;
+; WHY IT IS SHORT: THE MONASTIC RITE DOES NOT USE THE ROMAN RANKS.
+; The ordo's own vocabulary, counted across the whole document:
+;
+;     I cl.        86        III cl.        0
+;     II cl.       43        IV cl.         0
+;     Semidup.    103        Dup.          ~96
+;
+; It uses the 1960 class system at the TOP -- I and II class -- and the older
+; monastic Duplex / Semiduplex grades BELOW, exactly where the Roman calendar
+; has III and IV class. colitur's rank vocabulary is Class1..Class4. So a
+; Benedictine feast graded "Dup." or "Semidup." CANNOT BE FAITHFULLY
+; EXPRESSED here at all. This is not a gap in the data; it is a mismatch of
+; vocabularies between two related rites.
+;
+; Rather than invent a Dup. -> Class3 mapping the source never states, this
+; file ships ONLY the entries whose class the ordo gives in Roman terms and
+; whose row could be read unambiguously. Everything else is listed at the
+; bottom as excluded, by name, so the omission is visible rather than silent.
+;
+; TWO FURTHER LIMITS, both worth knowing before reusing this:
+;   1. It is "et Consuetudines Abbatiae" -- Norcia's own customs, not the
+;      generic Benedictine calendar. Another house's proper will differ.
+;   2. It is a 2026 ordo, one year, not a perpetual calendar. Any transferred
+;      or movable entry in it reflects that year's outcome, not the rule. The
+;      two entries below are fixed-date and unaffected.
+;
+; NOT AUTHORITATIVE. colitur's test layers assert things about the SHIPPED
+; universal calendar and cannot vouch for this file (see colitur-overlay(5)).
+;
+;   colitur convert benedictine.ini > benedictine.sexp
+;   colitur check benedictine.sexp
+; ---------------------------------------------------------------------------
+
+[overlay]
+id = benedictine-nursia
+
+; "21 SAB. Alb. | ! | IN TRANSITU S.P.N. BENEDICTI ... Dup. I cl."
+; The death of Our Holy Father Benedict, 21 March. I class in the monastic
+; calendar; in the Roman calendar 21 March is St Benedict at III class, so
+; this deliberately OVERRIDES the universal entry by naming a distinct slug on
+; the same date -- both will be candidates, and the I-class one wins.
+[transitus-of-our-holy-father-benedict]
+date    = 03-21
+rank    = class-1
+colour  = white
+name.la = In Transitu S.P.N. Benedicti Abbatis
+name.en = The Passing of Our Holy Father Benedict, Abbot
+
+; "15 ... S. MAURI ABB. (O.N.) | Dup. II cl."
+; (O.N.) = Ordinis Nostri, "of our Order" -- the ordo's own marker for a
+; proper feast of the Order. 39 entries carry it; this is the only one whose
+; class is given in Roman terms AND whose row reads unambiguously.
+[maurus-abbot]
+date    = 01-15
+rank    = class-2
+colour  = white
+name.la = S. Mauri Abbatis
+name.en = St Maurus, Abbot
+
+; ---------------------------------------------------------------------------
+; EXCLUDED, and why. Each of these is a real feast of the Order, present in
+; the ordo and marked (O.N.) or equivalent. None is written above, because its
+; grade is Duplex or Semiduplex -- which this format cannot express -- or
+; because its row could not be read unambiguously from the ordo's two-column
+; layout, and a guessed date is worse than an absent one.
+;
+;   Omnium Sanctorum O.N. (13 Nov)     Dup.       -- All Saints of the Order
+;   S. Scholasticae V. (10 Feb)        row unclear
+;   Ss. Placidi & Sociorum Mm. (5 Oct) row unclear
+;   S. Anselmi Ep. C. D. (21 Apr)      Dup.
+;   S. Bernardi Abb. D. (20 Aug)       Dup.
+;   S. Gertrudis Magnae V. (17 Nov)    (m.t.v.)
+;   S. Silvestri Abb. (26 Nov)         Dup.
+;   and ~20 further (O.N.) entries: Bede, Hildegard, Boniface, Frances of
+;   Rome, John Gualbert, Peter Damian, Leo IV, Robert, Bernard Ptolomei,
+;   Gregory VII, Augustine of Canterbury, and others.
+;
+; To use them, you need either a rank vocabulary colitur does not have, or a
+; deliberate decision -- yours, documented -- about how Duplex and Semiduplex
+; map onto class-3 and class-4. This file does not make that decision for you.
+; ---------------------------------------------------------------------------