tonus 0.9.0 → 0.10.0

package/dist/engines/chant/chant.js

@@ -1,4 +1,4 @@
-import { OFFICIA, MODI, CANTUS_QUERY_KEYS } from "./types.js";
+import { OFFICIA, MODI, CANTUS_QUERY_KEYS, assertOrdinaryCodes } from "./types.js";
 import { CORPUS_OVERLAP, CORPUS_FULL } from "../../data/corpus-overlap.js";
 import { attestationCutoff, chantAdmissible } from "./attest.js";
 import { GR_DATA, GR_SOURCE } from "../../data/gr.js";
@@ -9,11 +9,8 @@ import { AM_DATA, AM_SOURCE } from "../../data/am.js";
 import { NR_DATA, NR_SOURCE } from "../../data/nocturnale-romanum.js";
 // Office books — the antiphons and short responsories that fill weekday
 // office slots; see ChantSource in types.ts for why.
-import { AMS_DATA, AMS_SOURCE } from "../../data/ams.js";
 import { PSM_DATA, PSM_SOURCE } from "../../data/psm.js";
 // Further marked Solesmes books — see ChantSource in types.ts.
-import { CSE_DATA, CSE_SOURCE } from "../../data/cse.js";
-import { COT_DATA, COT_SOURCE } from "../../data/cot.js";
 import { KYRIALE } from "../../data/kyriale.js";
 import { entryToOrdinaryChant } from "./ordinary.js";
 function modusOf(mode) {
@@ -64,11 +61,12 @@ function chantFromGABC(query) {
     })();
     const office = (query.office
         ? (Array.isArray(query.office) ? query.office[0] : query.office)
-        : officeFromHeader ?? "or");
+        : officeFromHeader ?? "va");
     return [{
             id: `gabc:${incipit.toLowerCase().replace(/\s+/g, "_") || "untitled"}`,
             incipit,
             gabc: body,
+            books: ["user"],
             office,
             genus: OFFICIA[office] ?? office,
             mode: mode ?? null,
@@ -77,10 +75,53 @@ function chantFromGABC(query) {
             source: { book: "User", year: null, editor: null, code: "user" },
         }];
 }
+// Every printing's pages, by chant id then book code. Kept beside the corpus
+// rather than on the Chant: a caller gets the pages for the book they ASKED
+// about (see presentAs), and carrying all of them on every record would invite
+// reading the wrong volume's citation.
+const PAGES_BY_BOOK = new Map();
+/**
+ * The same chant, presented as the book the caller asked for.
+ *
+ * A melody printed in several books is stored once, under one owner, so its
+ * `source` and `pages` are the owner's. Ask `cantus({ source: "gr" })` and you
+ * mean the Graduale: you want the Graduale's bibliographic record and the
+ * Graduale's page numbers, not the Liber Usualis's because that is where the
+ * record happens to be filed. `books` is unchanged — the shelf is the shelf.
+ */
+// The owner's pages, and the whole map remembered for presentAs. A generated
+// record always carries the map (one key when one book prints it); a hand-built
+// Chant may carry a bare array, which is taken as it stands.
+function pagesFor(c, code) {
+    const byBook = c.pages;
+    if (Array.isArray(byBook))
+        return byBook;
+    const map = byBook;
+    PAGES_BY_BOOK.set(c.id, map);
+    return (code && map[code]) || Object.values(map)[0] || [];
+}
+function presentAs(chant, code) {
+    if (chant.source.code === code)
+        return chant;
+    const src = SOURCES[code];
+    if (!src)
+        return chant;
+    const pages = PAGES_BY_BOOK.get(chant.id)?.[code];
+    return { ...chant, source: src, pages: pages ?? chant.pages };
+}
 function withLabels(c, source) {
+    // `books` rides the generated data. The `??` is not defensive padding: the
+    // Kyriale is emitted by a different builder that never carried the field, and
+    // a chant printed by exactly one book is fully described by its own code. A
+    // record arriving without a listing is therefore listed under itself, which is
+    // true, rather than under nothing, which would make it unfindable by source.
     return {
         ...c,
         source,
+        // The one narrowing point: ChantData carries string[] so the generated
+        // literals do not hand tsc a 9-member union ~7,700 times over (TS2590).
+        books: (c.books?.length ? c.books : [source.code ?? "user"]),
+        pages: pagesFor(c, source.code),
         genus: OFFICIA[c.office] ?? c.office,
         modus: modusOf(c.mode),
     };
@@ -92,10 +133,7 @@ const CORPUS = [
     ...LH_DATA.map((c) => withLabels(c, LH_SOURCE)),
     ...AM_DATA.map((c) => withLabels(c, AM_SOURCE)),
     ...NR_DATA.map((c) => withLabels(c, NR_SOURCE)),
-    ...AMS_DATA.map((c) => withLabels(c, AMS_SOURCE)),
     ...PSM_DATA.map((c) => withLabels(c, PSM_SOURCE)),
-    ...CSE_DATA.map((c) => withLabels(c, CSE_SOURCE)),
-    ...COT_DATA.map((c) => withLabels(c, COT_SOURCE)),
 ];
 // The Kyriale, addressable but not shelved — ruled 2026-08-04.
 //
@@ -128,8 +166,7 @@ function byId() {
 export const SOURCES = {
     gr: GR_SOURCE, lu: LU_SOURCE, la: LA_SOURCE, lh: LH_SOURCE, am: AM_SOURCE, nr: NR_SOURCE,
     // office books — provenance, not acquisition
-    ams: AMS_SOURCE, psm: PSM_SOURCE,
-    cse: CSE_SOURCE, cot: COT_SOURCE,
+    psm: PSM_SOURCE,
 };
 // Tally a book's genre and mode distribution — computed once per code, cached.
 const _corpusCache = new Map();
@@ -213,7 +250,7 @@ function corpusLedger() {
     }
     _ledger = {
         count: byId().size,
-        listings: CORPUS.length,
+        listings: CORPUS.reduce((n, c) => n + c.books.filter((b) => b in SOURCES).length, 0),
         // Sum only what was measured: a book outside GregoBase reports null rather
         // than a false zero, and adding null in as 0 would understate the shelf
         // while looking like a total.
@@ -231,7 +268,10 @@ function oneCorpus(code) {
     const src = SOURCES[code];
     if (!src)
         throw new Error(`Unknown corpus code: "${code}" (expected ${Object.keys(SOURCES).join(", ")})`);
-    const chants = CORPUS.filter((c) => c.source.code === code);
+    // What the book PRINTS. Reading `source.code` here would count only the
+    // records this book happens to store, which is why the Antiphonarius used to
+    // report 1,422 of a book it holds 2,501 of.
+    const chants = CORPUS.filter((c) => c.books.includes(code));
     // Genre distribution — count by office code, descending by count.
     const officeCounts = new Map();
     // Mode distribution — count by mode 1–8; everything else (p/d/e, null) into one bucket.
@@ -332,6 +372,8 @@ export function getChants(query) {
     // source and report an id from any book as belonging to that one.
     const ids = toArray(query.id);
     const ordinaries = toArray(query.ordinary);
+    if (ordinaries)
+        assertOrdinaryCodes(ordinaries, "cantus");
     // The default pool is the SHELF. The Kyriale is not on it (see KYRIALE_CHANTS
     // above), so it is reached deliberately: by `id`, which must resolve any
     // chant tonus holds, or by `ordinary`, which asks for a part of the Mass and
@@ -350,7 +392,12 @@ export function getChants(query) {
     const sources = toArray(query.source);
     if (sources) {
         const set = new Set(sources);
-        out = out.filter((c) => c.source.code != null && set.has(c.source.code));
+        out = out
+            .filter((c) => c.books.some((b) => set.has(b)))
+            .map((c) => {
+            const asked = c.books.find((b) => set.has(b));
+            return asked ? presentAs(c, asked) : c;
+        });
     }
     const offices = toArray(query.office);
     if (offices) {

package/dist/engines/chant/data/masses.js

@@ -309,123 +309,123 @@ export function massesForRubric(rubric) {
 export const MASS_CENTURY = {
     // Mass I — Lux et Origo
     1: {
-        ky: { from: 10, to: 10, printed: "X. s." },
+        ke: { from: 10, to: 10, printed: "X. s." },
         gl: { from: 10, to: 10, printed: "X. s." },
         sa: { from: 10, to: 10, printed: "X. s." },
         ag: { from: 10, to: 10, printed: "X. s." },
     },
     // Mass II — Kyrie fons bonitatis
     2: {
-        ky: { from: 10, to: 10, printed: "X. s." },
+        ke: { from: 10, to: 10, printed: "X. s." },
         gl: { from: 13, to: 13, printed: "XIII. s." },
         ag: { from: 10, to: 10, printed: "X. s." },
     },
     // Mass III — Kyrie Deus sempiterne
     3: {
-        ky: { from: 11, to: 11, inferred: true, printed: "XI. s." },
+        ke: { from: 11, to: 11, inferred: true, printed: "XI. s." },
         gl: { from: 11, to: 11, printed: "XI. s." },
         sa: { from: 12, to: 12, alt: 11, printed: "(XI) XII. s." },
         ag: { from: 11, to: 12, printed: "XI-XII. s." },
     },
     // Mass IV — Cunctipotens Genitor Deus
     4: {
-        ky: { from: 10, to: 10, printed: "X. s." },
+        ke: { from: 10, to: 10, printed: "X. s." },
         gl: { from: 10, to: 10, printed: "X. s." },
         sa: { from: 11, to: 11, printed: "XI. s." },
         ag: { from: 13, to: 13, alt: 12, printed: "(XII) XIII. s." },
     },
     // Mass V — Kyrie magnæ Deus potentiæ
     5: {
-        ky: { from: 13, to: 13, printed: "XIII. s." },
+        ke: { from: 13, to: 13, printed: "XIII. s." },
         gl: { from: 12, to: 12, printed: "XII. s." },
         sa: { from: 12, to: 12, printed: "XII. s." },
         ag: { from: 12, to: 12, printed: "XII. s." },
     },
     // Mass VI — Kyrie Rex Genitor
     6: {
-        ky: { from: 10, to: 10, printed: "X. s." },
+        ke: { from: 10, to: 10, printed: "X. s." },
         gl: { from: 10, to: 10, printed: "X. s." },
         sa: { from: 11, to: 11, printed: "XI. s." },
         ag: { from: 11, to: 11, printed: "XI. s." },
     },
     // Mass VII — Kyrie Rex splendes
     7: {
-        ky: { from: 10, to: 10, printed: "X. s." },
+        ke: { from: 10, to: 10, printed: "X. s." },
         gl: { from: 12, to: 12, printed: "XII. s." },
         sa: { from: 11, to: 11, printed: "XI. s." },
         ag: { from: 15, to: 15, printed: "XV. s." },
     },
     // Mass VIII — de Angelis
     8: {
-        ky: { from: 15, to: 16, printed: "XV-XVI. s." },
+        ke: { from: 15, to: 16, printed: "XV-XVI. s." },
         gl: { from: 16, to: 16, printed: "XVI. s." },
         sa: { from: 12, to: 12, alt: 11, printed: "(XI) XII. s." },
         ag: { from: 15, to: 15, printed: "XV. s." },
     },
     // Mass IX — Cum Jubilo
     9: {
-        ky: { from: 12, to: 12, printed: "XII. s." },
+        ke: { from: 12, to: 12, printed: "XII. s." },
         gl: { from: 11, to: 11, printed: "XI. s." },
         sa: { from: 14, to: 14, printed: "XIV. s." },
         ag: { from: 13, to: 13, alt: 10, printed: "(X) XIII. s." },
     },
     // Mass X — Alme Pater
     10: {
-        ky: { from: 11, to: 11, printed: "XI. s." },
+        ke: { from: 11, to: 11, printed: "XI. s." },
         gl: { from: 15, to: 15, printed: "XV. s." },
         sa: { from: null, to: null, printed: "?. s." },
         ag: { from: 12, to: 12, printed: "XII. s." },
     },
     // Mass XI — Orbis factor
     11: {
-        ky: { from: 14, to: 16, alt: 10, printed: "(X) XIV-XVI. s." },
+        ke: { from: 14, to: 16, alt: 10, printed: "(X) XIV-XVI. s." },
         gl: { from: 10, to: 10, printed: "X. s." },
         sa: { from: 10, to: 10, printed: "X. s." },
         ag: { from: 14, to: 14, printed: "XIV. s." },
     },
     // Mass XII — Pater cuncta
     12: {
-        ky: { from: 12, to: 12, printed: "XII. s." },
+        ke: { from: 12, to: 12, printed: "XII. s." },
         gl: { from: 12, to: 12, inferred: true, printed: "XII. s." },
         sa: { from: 13, to: 13, printed: "XIII. s." },
         ag: { from: 11, to: 11, printed: "XI. s." },
     },
     // Mass XIII — Stelliferi Conditor orbis
     13: {
-        ky: { from: 11, to: 11, printed: "XI. s." },
+        ke: { from: 11, to: 11, printed: "XI. s." },
         gl: { from: 12, to: 12, printed: "XII. s." },
         sa: { from: 13, to: 13, printed: "XIII. s." },
         ag: { from: null, to: null, printed: "? s." },
     },
     // Mass XIV — Jesu Redemptor
     14: {
-        ky: { from: 10, to: 10, inferred: true, printed: "X. s." },
+        ke: { from: 10, to: 10, inferred: true, printed: "X. s." },
         gl: { from: 10, to: 10, printed: "X. s." },
         sa: { from: 12, to: 12, inferred: true, printed: "XII. s." },
         ag: { from: 13, to: 13, printed: "XIII. s." },
     },
     // Mass XV — Dominator Deus
     15: {
-        ky: { from: 11, to: 13, printed: "XI-XIII. s." },
+        ke: { from: 11, to: 13, printed: "XI-XIII. s." },
         gl: { from: 10, to: 10, printed: "X. s." },
         sa: { from: 10, to: 10, printed: "X. s." },
         ag: { from: 14, to: 14, alt: 12, printed: "(XII) XIV. s." },
     },
     // Mass XVI
     16: {
-        ky: { from: 11, to: 13, printed: "XI-XIII. s." },
+        ke: { from: 11, to: 13, printed: "XI-XIII. s." },
         sa: { from: 13, to: 13, printed: "XIII. s." },
         ag: { from: 10, to: 11, printed: "X-XI. s." },
     },
     // Mass XVII
     17: {
-        ky: { from: 15, to: 17, alt: 10, printed: "(X) XV-XVII. s." },
+        ke: { from: 15, to: 17, alt: 10, printed: "(X) XV-XVII. s." },
         sa: { from: 11, to: 11, printed: "XI. s." },
         ag: { from: 13, to: 13, printed: "XIII. s." },
     },
     // Mass XVIII — Deus Genitor alme
     18: {
-        ky: { from: 11, to: 11, printed: "XI. s." },
+        ke: { from: 11, to: 11, printed: "XI. s." },
         sa: { from: 13, to: 13, printed: "XIII. s." },
         ag: { from: 12, to: 12, printed: "XII. s." },
     },

package/dist/engines/chant/ordinary.js

@@ -5,7 +5,7 @@ import { MASSES, AD_LIB, WHOLE_MASS_RUBRICS, partWithinEra, } from "./data/masse
 import { KYRIALE } from "../../data/kyriale.js";
 import { attestationCutoff, eraCutoff, chantAdmissible } from "./attest.js";
 import { CANTUS_QUERY_KEYS } from "./types.js";
-import { KY_SOURCE, MODI, ORDINARIA, } from "./types.js";
+import { KY_SOURCE, MODI, ORDINARIA, OFFICIA, assertOrdinaryCodes, } from "./types.js";
 const ORDINARY_OFFICES = new Set(Object.keys(ORDINARIA));
 const MODE_PAIRS = [[1, 2], [3, 4], [5, 6], [7, 8]];
 const CREDO_PRIORITY = ["IV", "III", "I", "II", "V", "VI"];
@@ -279,13 +279,17 @@ function selectCredoCode(feast, allowed, year) {
 export function entryToOrdinaryChant(entry) {
     const ordinary = ORDINARY_OFFICES.has(entry.office)
         ? entry.office
-        : "ky";
+        : "ke";
     return {
         id: entry.id,
         incipit: entry.incipit,
         gabc: entry.gabc,
-        office: "or",
-        genus: "Ordinarium",
+        books: ["ky"],
+        office: "ky",
+        // The genus follows the office code, as everywhere else — OFFICIA.ky.
+        // It read "Ordinarium" while the office read "or", which was tonus's own
+        // pairing; GregoBase files these under ky = Kyriale.
+        genus: OFFICIA.ky,
         mode: entry.mode ? String(entry.mode) : null,
         modus: entry.mode ? (MODI[String(entry.mode)] ?? null) : null,
         pages: [],
@@ -353,7 +357,7 @@ function ordinaryForFeast(feast, pinMass, filterModes, admissible) {
         return best ? entryToOrdinaryChant(best) : null;
     };
     const results = [];
-    const ky = pick("ky");
+    const ky = pick("ke");
     if (ky)
         results.push(ky);
     // Gloria is omitted under the gloria-less rubrics — penitential Sundays and
@@ -452,6 +456,9 @@ export function getOrdinary(query) {
         throw new Error(`ordinarium: unknown query key(s) ${unknown.map((k) => `"${k}"`).join(", ")} ` +
             `(expected ${[...ORDINARIUM_QUERY_KEYS].join(", ")}).`);
     }
+    if (query.ordinary) {
+        assertOrdinaryCodes(Array.isArray(query.ordinary) ? query.ordinary : [query.ordinary], "ordinarium");
+    }
     const feasts = toArray(query.feast);
     assertFeasts(feasts, "ordinarium");
     // `mode` accepts a scalar or an array, with cantus's semantics: match any.

package/dist/engines/chant/psalm.js

@@ -36,6 +36,10 @@ function verseToChant(v, mode, differentia, intonation, inDirectum, solemn) {
         id: `psalm:${v.psalm}:${v.verse}`,
         incipit: v.half1.slice(0, 40),
         gabc,
+        // Empty, and meaningfully so: a verse pointed to a tone at request time is
+        // not a printing of any book on the shelf, which is exactly why no
+        // `cantus({ source })` can ever return one.
+        books: [],
         office: "ps",
         genus: "Psalmus",
         mode: String(mode),

package/dist/engines/chant/types.d.ts

@@ -1,7 +1,7 @@
 import type { Season, Grade, Feast } from "../cal/types.js";
 export type { Season, Grade, Feast };
-export type OfficeCode = "an" | "al" | "ca" | "co" | "gr" | "hy" | "in" | "of" | "ps" | "re" | "rb" | "se" | "tr" | "tp" | "or" | "im" | "pa" | "su";
-export type OrdinaryCode = "ky" | "gl" | "cr" | "sa" | "ag" | "be" | "it" | "as" | "va";
+export type OfficeCode = "an" | "al" | "ca" | "co" | "gr" | "hy" | "in" | "of" | "ps" | "re" | "rb" | "se" | "tr" | "tp" | "or" | "ky" | "va" | "im" | "pa" | "su";
+export type OrdinaryCode = "ke" | "gl" | "cr" | "sa" | "ag" | "be" | "it" | "as" | "va";
 /**
  * The books a chant can come from. `source` is PROVENANCE, not an acquisition
  * unit: a book appears here because some chant the liturgy asks for is found in
@@ -24,7 +24,7 @@ export type OrdinaryCode = "ky" | "gl" | "cr" | "sa" | "ag" | "be" | "it" | "as"
  * dies" — the Friday Vespers antiphon the widening was for. Every chant tonus
  * now ships carries rhythmic notation.
  */
-export type ChantSource = "gr" | "lu" | "la" | "lh" | "am" | "nr" | "ams" | "psm" | "cse" | "cot";
+export type ChantSource = "gr" | "lu" | "la" | "lh" | "am" | "nr" | "psm";
 export type CanonicalHour = "matutinum" | "laudes" | "prima" | "tertia" | "sexta" | "nona" | "vesperae" | "completorium";
 /** The eight canonical hours in the order they are sung, Matins first. The
  *  order is the content: a day's office read out of sequence is not the day's
@@ -38,6 +38,18 @@ export declare const CANTUS_QUERY_KEYS: Set<string>;
 export declare const MODI: Readonly<Record<string, string>>;
 export declare const OFFICIA: Readonly<Record<OfficeCode, string>>;
 export declare const ORDINARIA: Readonly<Record<string, string>>;
+/**
+ * An ordinary code the vocabulary above does not carry is a MALFORMED query,
+ * not a no-match, and both doors that take one say so here.
+ *
+ * The query contract makes a no-match `[]` and a malformation a throw, and an
+ * unknown code cannot be a no-match: there is no chant it failed to find,
+ * because it never named a part of the Mass. The 0.10.0 rename is why this is
+ * a guard rather than a comment — `ky` was the Kyrie through 0.9.1 and is the
+ * Kyriale roll-up now, so the one code most likely to arrive stale is the one
+ * that would otherwise return an empty list and look like an answer.
+ */
+export declare function assertOrdinaryCodes(codes: readonly string[], method: string): void;
 export declare const KY_SOURCE: Chant["source"];
 export interface Chant {
     id: string;
@@ -61,6 +73,22 @@ export interface Chant {
         scanSource?: string | null;
         code?: ChantSource | "user" | "ky";
     };
+    /**
+     * Every book that PRINTS this chant, the one storing the record first.
+     *
+     * A melody printed in several books is stored once and listed under each, so
+     * `books` — not `source.code` — is what `cantus({ source })` and `corpus(code)`
+     * read. `source` names the book the record is filed under; `books` names the
+     * shelf. Until 2026-08-31 the two were conflated, which stored the 928 chants
+     * the Graduale and the Liber Usualis share twice over while hiding the 1,079
+     * the Usualis shares with the Antiphonarius from `corpus("la")` entirely.
+     *
+     * `books[0]` is the owner. A chant that IS a printing carries its own code
+     * even when no book on the shelf holds it — "user" for raw GABC, "ky" for a
+     * Kyriale printing. It is empty only for a chant that is not a printing at
+     * all: a psalm verse pointed to a tone at request time.
+     */
+    books: (ChantSource | "user" | "ky")[];
     ordinary?: OrdinaryCode;
     ordinarium?: string;
     mass?: number;
@@ -151,7 +179,7 @@ export interface CantusQuery {
     office?: OfficeCode | OfficeCode[];
     source?: ChantSource | ChantSource[];
     /**
-     * A part of the Mass ordinary — `"ky"` for the Kyries, `"gl"` the Glorias,
+     * A part of the Mass ordinary — `"ke"` for the Kyries, `"gl"` the Glorias,
      * and so on. This is the door to the Kyriale, which is addressable but not
      * shelved (it is a partition of the Graduale, not a book), so it is absent
      * from `source` and from an unfiltered search. Asking for an ordinary can

package/dist/engines/chant/types.js

@@ -33,14 +33,36 @@ export const OFFICIA = Object.freeze({
     se: "Sequentia",
     // Reported in the pre-cut tallies, not shipped — see OfficeCode above.
     im: "Improperia", // the Good Friday Reproaches (Popule meus)
-    pa: "Antiphona Mariana", // Marian antiphons outside the office cycle
+    pa: "Prosa",
     su: "Supplicatio", // litanies and supplications (the Easter Vigil litany)
     tr: "Tractus",
-    tp: "Tonus Peregrinus",
-    or: "Ordinarium",
+    // ── Corrected 2026-08-31 against GregoBase's own vocabulary ──────────────
+    // These three were read off the two-letter codes rather than off the source,
+    // and two of them named the wrong thing entirely. GregoBase's include/txt.php
+    // carries $txt['usage']: or = Toni Communes, tp = Tropa, pa = Prosa. `or` was
+    // the costly one — tonus stamped "Ordinarium" on it and used the code for the
+    // Mass ordinary, which meant a genus tonus invented was sitting on a genus the
+    // database already had, and 132 real Toni Communes chants were dropped at the
+    // extractor for want of a mapping.
+    tp: "Tropa",
+    or: "Toni Communes",
+    // The Mass ordinary's roll-up, and GregoBase's word for it: the database files
+    // every ordinary chant under office-part `ky`. The part itself rides
+    // `ordinary` (ke · gl · cr · sa · ag · …), which is the identity every query
+    // and the census bin on; this is the genus above them.
+    ky: "Kyriale",
+    // The catch-all, and GregoBase's own name for it. A chant whose office-part
+    // tonus does not recognise used to fall to `or`, which was harmless while `or`
+    // was a label tonus had invented and is not now that it means Toni Communes —
+    // an unknown chant would have been filed as a recitation formula, and the
+    // census excludes those. NOTE for review: `va` is also an ORDINARY code (Vidi
+    // aquam). Office codes and ordinary codes are separate vocabularies — `ky`
+    // lived in both until today — but if that overlap is unwanted, this is the
+    // one to rename, not the ordinary.
+    va: "Varia",
 });
 export const ORDINARIA = Object.freeze({
-    ky: "Kyrie eleison",
+    ke: "Kyrie eleison",
     gl: "Gloria",
     cr: "Credo",
     sa: "Sanctus",
@@ -50,6 +72,27 @@ export const ORDINARIA = Object.freeze({
     as: "Asperges",
     va: "Vidi aquam",
 });
+/**
+ * An ordinary code the vocabulary above does not carry is a MALFORMED query,
+ * not a no-match, and both doors that take one say so here.
+ *
+ * The query contract makes a no-match `[]` and a malformation a throw, and an
+ * unknown code cannot be a no-match: there is no chant it failed to find,
+ * because it never named a part of the Mass. The 0.10.0 rename is why this is
+ * a guard rather than a comment — `ky` was the Kyrie through 0.9.1 and is the
+ * Kyriale roll-up now, so the one code most likely to arrive stale is the one
+ * that would otherwise return an empty list and look like an answer.
+ */
+export function assertOrdinaryCodes(codes, method) {
+    const unknown = codes.filter((c) => !(c in ORDINARIA));
+    if (unknown.length) {
+        throw new Error(`${method}: unknown ordinary code(s) ${unknown.map((c) => `"${c}"`).join(", ")} ` +
+            `(expected ${Object.keys(ORDINARIA).join(", ")}).` +
+            (unknown.includes("ky")
+                ? ` The Kyrie is "ke" from 0.10.0 — "ky" is now the Kyriale genus (OFFICIA.ky).`
+                : ""));
+    }
+}
 // The Kyriale's bibliographic identity. NOT a ChantSource: `ky` is a partition
 // of the Graduale, not a book of its own (chant.ts, CORPUS), so it is not a
 // value `cantus({ source })` takes and not a row in the shelf. This record