Author Common-of-a-Martyr/Apostle categories and St. Andrew's proper Matins psalmody

Two categories live-verified: common-of-a-martyr (from St. Ignatius of
Antioch, whose own office is entirely Common — also confirms
Common-of-a-Martyr-Bishop redirects to this same scheme, and that none
of its 3 Duplex+ saints has a proper antiphon of his own) and
common-of-an-apostle (from St. Bartholomew). St. Andrew authored as the
second saint-level proof, sharing the apostle category's psalm numbers
in every slot with his own proper antiphon text.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

src/data/hours/matins-psalmody-overrides/categories/common-of-a-martyr.yml

@@ -0,0 +1,110 @@
+# Generic Common-of-a-Martyr Matins psalmody, live-verified against
+# Divinum Officium (Monastic Tridentinum 1617, command=prayMatutinum,
+# 2029-02-01 -- St. Ignatius of Antioch, Common of a Martyr-Bishop, whose
+# own rule file is "vide C2" i.e. entirely from this Common, no proper
+# antiphon of his own -- so his output *is* this category's generic
+# scheme, not a saint-specific deviation). Also confirmed
+# (data/hours/CommuneM/C2a.txt in the reference engine) that
+# Common-of-a-Martyr-Bishop's own Matins psalmody redirects outright to
+# this same Common-of-a-Martyr file -- the two categories share one
+# scheme, not two.
+#
+# This file is documentation/reference content only, not yet wired into
+# `hours/matins-psalmody-overrides.ts`'s resolution -- per this project's
+# "stay on the ferial fallback until proper antiphon text is authored
+# per-saint" decision (2026-08), a saint with no entry under
+# matins-psalmody-overrides/saints/ still falls all the way back to the
+# plain ferial weekday table, never to this generic Common text. Recorded
+# here so the next Common-of-a-Martyr(-Bishop) saint's own proper file
+# doesn't have to re-derive/re-verify these same shared psalm numbers and
+# versicles from scratch, and as the reference point for what "differs
+# from Common" means when authoring one (see
+# matins-psalmody-overrides/saints/st-lawrence.yml's own note on its one
+# genuine deviation, Ps 16 vs this file's Ps 64 in Nocturn 2).
+id: common-of-a-martyr
+nocturn1:
+  groups:
+    - psalms: [1]
+      antiphon:
+        la: "In lege Dómini * fuit volúntas ejus die ac nocte."
+        en: "His delight * was in the law of the Lord day and night."
+    - psalms: [2]
+      antiphon:
+        la: "Prǽdicans * præcéptum Dómini constitútus est in monte sancto ejus."
+        en: "The Lord hath set him * upon His holy hill, to declare His decree."
+    - psalms: [4]
+      antiphon:
+        la: "Fílii hóminum * scitóte quia Dóminus sanctum suum mirificávit."
+        en: "O ye sons of men, * know that the Lord hath set apart him that is holy for Himself."
+    - psalms: [5]
+      antiphon:
+        la: "Scuto bonæ voluntátis * tuæ coronásti eum Dómine."
+        en: "O Lord, Thou hast compassed him * with thy favour as with a shield."
+    - psalms: [8]
+      antiphon:
+        la: "In univérsa terra * glória et honóre coronásti eum."
+        en: "Thou hast crowned him * with glory and honour in all the earth."
+    - psalms: [10]
+      antiphon:
+        la: "Justus Dóminus, * et justítiam diléxit: æquitátem vidit vultus ejus."
+        en: "The righteous Lord * loveth righteousness; His countenance doth behold uprightness."
+  versicle:
+    v:
+      la: "Glória et honóre coronásti eum, Dómine."
+      en: "Thou hast crowned him with glory and honour, O Lord."
+    r:
+      la: "Et constituísti eum super ópera mánuum tuárum."
+      en: "And madest him to have dominion over the works of thy hands."
+nocturn2:
+  groups:
+    - psalms: [14]
+      antiphon:
+        la: "Habitábit * in tabernáculo tuo: requiéscet in monte sancto tuo."
+        en: "He shall dwell * in thy tabernacle, He shall rest upon thy holy hill."
+    - psalms: [20]
+      antiphon:
+        la: "Posuísti, Dómine, * super caput ejus corónam de lápide pretióso."
+        en: "O Lord, Thou hast set a crown * of precious stones upon his head."
+    - psalms: [23]
+      antiphon:
+        la: "Hic accípiet * benedictiónem a Dómino, et misericórdiam a Deo salutári suo; qui hæc est generátio quæréntium Dóminum."
+        en: "He shall receive * a blessing from the Lord, and mercy from God his Saviour."
+    - psalms: [63]
+      antiphon:
+        la: "Lætábitur justus * in Dómino et sperábit in eo, et laudabúntur omnes recti corde."
+        en: "The just shall rejoice * in the Lord, and shall hope in him: and all the upright in heart shall be praised."
+    - psalms: [64]
+      antiphon:
+        la: "Beátus * quem elegísti Dómine, habitábit in átriis tuis."
+        en: "Blessed is * he whom thou hast chosen: he shall dwell in thy courts."
+    - psalms: [91]
+      antiphon:
+        la: "Justus ut palma florébit: sicut cedrus Líbani multiplicábitur."
+        en: "The just shall flourish * like the palm tree: he shall grow up like the cedar of Libanus."
+  versicle:
+    v:
+      la: "Posuísti, Dómine, super caput ejus."
+      en: "O Lord, Thou hast set a crown of precious stones."
+    r:
+      la: "Corónam de lápide pretióso."
+      en: "Upon his head."
+nocturn3:
+  antiphon:
+    la: "Qui vult veníre post me, * ábnegat semetípsum, et tollet crucem suam, et sequátur me."
+    en: "If any man will come after me, * let him deny himself, and take up his cross daily, and follow me."
+  canticles:
+    - refs:
+        - { book: sir, chapter: 14, verses: "22" }
+        - { book: sir, chapter: 15, verses: "3-4" }
+        - { book: sir, chapter: 15, verses: "6" }
+    - refs:
+        - { book: jer, chapter: 17, verses: "7-8" }
+    - refs:
+        - { book: sir, chapter: 31, verses: "8-11" }
+  versicle:
+    v:
+      la: "Magna est glória ejus in salutári tuo."
+      en: "His glory is great in thy salvation."
+    r:
+      la: "Glóriam et magnum decórem impónes super eum."
+      en: "Honour and great majesty shalt Thou lay upon him."

src/data/hours/matins-psalmody-overrides/categories/common-of-an-apostle.yml

@@ -0,0 +1,102 @@
+# Generic Common-of-an-Apostle Matins psalmody, live-verified against
+# Divinum Officium (Monastic Tridentinum 1617, command=prayMatutinum,
+# 2026-08-24 -- St. Bartholomew, whose own Nocturn 1 opens with the
+# generic "In omnem terram" antiphon rather than a proper one of his own,
+# i.e. this Common's own default scheme). Cross-checked against St.
+# Andrew's own proper Matins (2026-11-30): identical psalm numbers in
+# every slot across all three nocturns, only the antiphon text differs
+# (his own proper text narrating his call and martyrdom) -- confirming
+# the psalm *numbers* here are the shared Common-of-an-Apostle pool, same
+# pattern already established for Common-of-a-Martyr (see that category
+# file's own doc comment).
+#
+# Reference/documentation content only, not wired into
+# `hours/matins-psalmody-overrides.ts`'s resolution -- see
+# common-of-a-martyr.yml's own doc comment for why (the "stay on the
+# ferial fallback until proper antiphon text is authored per-saint"
+# decision, 2026-08).
+id: common-of-an-apostle
+nocturn1:
+  groups:
+    - psalms: [18]
+      antiphon:
+        la: "In omnem terram * exívit sonus eórum, et in fines orbis terræ verba eórum."
+        en: "Their sound * hath gone forth into all the earth: and their words unto the ends of the world."
+    - psalms: [33]
+      antiphon:
+        la: "Clamavérunt justi, * et Dóminus exaudívit eos."
+        en: "The just cried * and the Lord heard them."
+    - psalms: [44]
+      antiphon:
+        la: "Constítues eos * príncipes super omnem terram: mémores erunt nóminis tui, Dómine."
+        en: "Thou shalt make them princes * over all the earth. They shall remember thy name, O Lord."
+    - psalms: [46]
+      antiphon:
+        la: "Príncipes populórum * congregáti sunt cum Deo Ábraham."
+        en: "The princes of the people * are gathered together, with the God of Abraham."
+    - psalms: [60]
+      antiphon:
+        la: "Dedísti hereditátem * timéntibus nomen tuum, Dómine."
+        en: "Thou hast given an inheritance * to them that fear thy name, O Lord."
+    - psalms: [63]
+      antiphon:
+        la: "Annuntiavérunt * ópera Dei, et facta ejus intellexérunt."
+        en: "They declared * the works of God, and understood his doings."
+  versicle:
+    v:
+      la: "In omnem terram exívit sonus eórum."
+      en: "Their sound hath gone forth into all the earth:"
+    r:
+      la: "Et in fines orbis terræ verba eórum."
+      en: "And their words unto the ends of the world."
+nocturn2:
+  groups:
+    - psalms: [74]
+      antiphon:
+        la: "Exaltabúntur * córnua justi, allelúja."
+        en: "The horns of the just * shall be exalted. Alleluia."
+    - psalms: [95]
+      antiphon:
+        la: "Annuntiavérunt * inter gentes glóriam Dómini, in ómnibus pópulis mirabília ejus."
+        en: "Declare his glory among the Gentiles: * his wonders among all people."
+    - psalms: [96]
+      antiphon:
+        la: "Lux orta est * justo, allelúja, rectis corde lætítia, allelúja."
+        en: "Light is risen * to the just, alleluia, and joy to the right of heart. Alleluia."
+    - psalms: [97]
+      antiphon:
+        la: "Déxtera Dómini * salvávit eos, et bráchium sanctum ejus, allelúja."
+        en: "His right hand hath wrought for him salvation, * and his arm is holy, alleluia."
+    - psalms: [98]
+      antiphon:
+        la: "Custodiébant * testimónia ejus, et præcépta ejus, allelúja."
+        en: "They kept his testimonies, * and the commandment which he gave them. Alleluia."
+    - psalms: [100]
+      antiphon:
+        la: "Perambulábant * in innocéntia cordis sui, in medio domus tuæ."
+        en: "I walked in the innocence of my heart, * in the midst of my house."
+  versicle:
+    v:
+      la: "Constítues eos príncipes super omnem terram."
+      en: "Thou shalt make them princes over all the earth."
+    r:
+      la: "Mémores erunt nóminis tui, Dómine."
+      en: "They shall remember thy name, O Lord."
+nocturn3:
+  antiphon:
+    la: "Gaudéte * et exsultáte, quia nómina vestra scripta sunt in cælis, dicit Dóminus."
+    en: "Be glad and rejoice, * for your names are written in heaven, said the Lord."
+  canticles:
+    - refs:
+        - { book: isa, chapter: 61, verses: "6-9" }
+    - refs:
+        - { book: sap, chapter: 3, verses: "7-9" }
+    - refs:
+        - { book: sap, chapter: 10, verses: "17-21" }
+  versicle:
+    v:
+      la: "Nimis honoráti sunt amíci tui, Deus."
+      en: "Thy friends, O Lord, are made exceedingly honourable."
+    r:
+      la: "Nimis confortátus est principátus eórum."
+      en: "Their principality is exceedingly strengthened."

src/data/hours/matins-psalmody-overrides/saints/st-andrew.yml

@@ -0,0 +1,103 @@
+# Verified against Divinum Officium (Monastic Tridentinum 1617), live
+# prayMatutinum query (2026-08-18, checked against his own day outright,
+# 2026-11-30 -- "S. Andreæ Apostoli", not transferred that year). Second
+# live-verified proof for the Matins-psalmody-override mechanism, after
+# St. Lawrence (see matins-psalmody-overrides/saints/st-lawrence.yml) --
+# this one proves the Common-of-an-Apostle category (see
+# matins-psalmody-overrides/categories/common-of-an-apostle.yml), whose
+# generic scheme this file's own psalm numbers match exactly in every
+# slot across all three nocturns; only the antiphon text is proper to
+# Andrew (narrating his own call by the Sea of Galilee and his own
+# martyrdom on the cross), matching the same category-shares-psalm-
+# numbers/saint-carries-antiphons pattern already established for
+# Common-of-a-Martyr.
+#
+# New scripture chapters authored for the canticles:
+# data/scripture/{isa-61,sap-3,sap-10}.yml (sparse, only the cited
+# verses, same convention as sir-14.yml etc.).
+id: st-andrew
+category: common-of-an-apostle
+nocturn1:
+  groups:
+    - psalms: [18]
+      antiphon:
+        la: "Vidit Dóminus * Petrum et Andréam, et vocávit eos."
+        en: "The Lord saw Peter and Andrew, * and He called them."
+    - psalms: [33]
+      antiphon:
+        la: "Veníte post me, * dicit Dóminus, fáciam vos fíeri piscatóres hóminum."
+        en: "Follow Me, and I will make you fishers of men, * saith the Lord."
+    - psalms: [44]
+      antiphon:
+        la: "Relíctis rétibus suis, * secúti sunt Dóminum Redemptórem."
+        en: "And they left their nets, * and followed the Lord their Saviour."
+    - psalms: [46]
+      antiphon:
+        la: "Christus me misit, * ad istam provínciam, in qua non parvum pópulum aquisívi."
+        en: "Christ sent me * to this province, in which I have acquired not a small number of people."
+    - psalms: [60]
+      antiphon:
+        la: "Ego si crucis * patíbulum expavéscerem, † crucis glóriam non prædicárem."
+        en: "If I become terrified * at the gibbet of the Cross, I will not show forth the glory of the Cross."
+    - psalms: [63]
+      antiphon:
+        la: "Dignum sibi Dóminus * computávit Mártyrem, quem vocávit Apóstolum, dum esset in mari, allelúja."
+        en: "Whom the Lord called to be His Apostle, * when he was by the sea, him also He counted worthy to be His martyr. Alleluia."
+  versicle:
+    v:
+      la: "In omnem terram exívit sonus eórum."
+      en: "Their sound hath gone forth into all the earth:"
+    r:
+      la: "Et in fines orbis terræ verba eórum."
+      en: "And their words unto the ends of the world."
+nocturn2:
+  groups:
+    - psalms: [74]
+      antiphon:
+        la: "Videns Andréas * crucem, cum gáudio dicébat: † Quia amátor tui semper fui, et desiderávi te amplécti, o bona crux."
+        en: "Seeing the cross, * Andrew said with joy, I have always been your lover, and desired to embrace you, O good cross."
+    - psalms: [95]
+      antiphon:
+        la: "Diléxit Andréam * Dóminus in odórem suavitátis."
+        en: "Andrew was to the Lord as a sweet savour, * which He loved exceedingly."
+    - psalms: [96]
+      antiphon:
+        la: "Bíduo vivens * pendébat in cruce beátus Andréas pro Christi nómine, et docébat pópulum."
+        en: "The blessed Andrew hung alive upon the cross for two days * for Christ's Name's sake, and, all the while, he taught the people."
+    - psalms: [97]
+      antiphon:
+        la: "Non me permíttas, Dómine, * fámulum tuum a te separári: tempus est ut commendétur terræ corpus meum, et me ad te veníre jubéas."
+        en: "Suffer not thy servant, O Lord, to be parted from thee * the hour is come to lay my body in the earth, and for thee to bid me come unto thyself."
+    - psalms: [98]
+      antiphon:
+        la: "Andréas vero rogábat pópulum, * ut non impedíret passiónem ipsíus."
+        en: "But Andrew besought the people * not to hinder his passion."
+    - psalms: [100]
+      antiphon:
+        la: "Accipe me ab homínibus * et redde me magístro meo: ut per te me recípiat, qui per te me redémit, allelúja."
+        en: "Welcome me from among men and join me again to my Master; * that, as by thee He redeemed me, so by thee also He may take me unto Himself. Alleluia."
+  versicle:
+    v:
+      la: "Constítues eos príncipes super omnem terram."
+      en: "Thou shalt make them princes over all the earth."
+    r:
+      la: "Mémores erunt nóminis tui, Dómine."
+      en: "They shall remember thy name, O Lord."
+nocturn3:
+  antiphon:
+    la: "Unus ex duóbus, * qui secúti sunt Dóminum, erat Andréas, frater Simónis Petri, allelúja."
+    en: "One of the two * who followed the Lord was Andrew, the brother of Simon Peter, Alleluia."
+  canticles:
+    - refs:
+        - { book: isa, chapter: 61, verses: "6-9" }
+    - refs:
+        - { book: sap, chapter: 3, verses: "7-9" }
+    - refs:
+        - { book: sap, chapter: 10, verses: "17-21" }
+  versicle:
+    v:
+      la: "Nimis honoráti sunt amíci tui, Deus."
+      en: "Thy friends, O Lord, are made exceedingly honourable."
+    r:
+      la: "Nimis confortátus est principátus eórum."
+      en: "Their principality is exceedingly strengthened."