tonus 0.9.0 → 0.10.0

package/docs/api/chant.md

@@ -9,9 +9,9 @@ carries page-level provenance back to its book.
 
 - [Chant](#chant)
   - [The corpora](#the-corpora)
-    - [The cut](#the-cut)
+    - [The shelf is the books](#the-shelf-is-the-books)
   - [The books — `corpus`](#the-books--corpus)
-    - [The ledger of the cut — `full`](#the-ledger-of-the-cut--full)
+    - [What the book holds — `full`](#what-the-book-holds--full)
   - [Retrieval — `cantus`](#retrieval--cantus)
     - [Reaching the ordinary — `ordinary`](#reaching-the-ordinary--ordinary)
     - [On chant ids](#on-chant-ids)
@@ -30,33 +30,29 @@ carries page-level provenance back to its book.
 
 ## The corpora
 
-Nine Solesmes books, extracted from
+Six Solesmes books, extracted from
 [GregoBase](https://gregobase.selapa.net/), joined by the Divinum Officium
 propers, office, and psalter, plus the Nocturnale Romanum for the night office:
 
-| Source | Book                              | Edition            | Chants |
-| ------ | --------------------------------- | ------------------ | ------ |
-| `gr`   | Graduale Romanum                  | Solesmes, 1961     | 780    |
-| `lu`   | The Liber Usualis                 | Solesmes, 1961     | 707    |
-| `la`   | Liber antiphonarius               | Solesmes, 1960     | 160    |
-| `lh`   | Liber Hymnarius                   | Solesmes, 1983     | 25     |
-| `am`   | Antiphonale Monasticum            | Solesmes, 1934     | 576    |
-| `ams`  | Antiphonale Monasticum Solesmense | Solesmes, 1935     | 11     |
-| `psm`  | Psalterium Monasticum             | Solesmes, 1981     | 11     |
-| `cse`  | Cantus selecti                    | Solesmes, 1957     | 11     |
-| `cot`  | Chants of the Church              | Solesmes, 1956     | 16     |
-| `nr`   | Nocturnale Romanum                | Sandhofe, 2002     | 470    |
-
-**2,187 chants in all**, plus the Mass ordinary (120 settings, reached by
-[`ordinary`](#reaching-the-ordinary--ordinary) rather than by book). The books
-hold 10,156 between them; tonus ships only what the calendar calls for on some
-day of the year, so a chant with no day to be sung on is not here. See
-[The cut](#the-cut) below.
-
-The ten books list 2,767 rows for those 2,187 chants: a melody printed in two
-books is stored once and listed under both.
-
-`am`, `ams`, and `psm` are the monastic (Benedictine) books; the rest are
+| Source | Book                    | Edition        | Chants |
+| ------ | ----------------------- | -------------- | ------ |
+| `gr`   | Graduale Romanum        | Solesmes, 1961 | 1,373  |
+| `lu`   | The Liber Usualis       | Solesmes, 1961 | 2,446  |
+| `la`   | Liber antiphonarius     | Solesmes, 1960 | 2,506  |
+| `lh`   | Liber Hymnarius         | Solesmes, 1983 | 361    |
+| `am`   | Antiphonale Monasticum  | Solesmes, 1934 | 1,448  |
+| `psm`  | Psalterium Monasticum   | Solesmes, 1981 | 60     |
+| `nr`   | Nocturnale Romanum      | Sandhofe, 2002 | 1,564  |
+
+**7,840 chants in all**, the Mass ordinary among them (120 settings, reached by
+[`ordinary`](#reaching-the-ordinary--ordinary) rather than by book). That is the
+books themselves: tonus carries what they print, whether or not the calendar
+reaches it.
+
+The seven books list 9,758 rows for those 7,840 chants: a melody printed in two
+books is stored once and listed under each, with each book's own page citation.
+
+`am` and `psm` are the monastic (Benedictine) books; the rest are
 Roman. Every book here bears the rhythmic markings the score engine reads; that
 is the admission rule. `nr` is the night-office repertoire (responsories,
 antiphons) from the
@@ -64,37 +60,48 @@ antiphons) from the
 community restitution, the one non-Solesmes source, admitted because it carries
 those marks too.
 
-### The cut
+### The shelf is the books
 
-The corpus is **assignment-driven**: a chant ships when some day of the
-liturgical year calls for it. The calendar is walked year by year until it stops
-finding new assignments (39 years, in the event), and what it never reaches is
-not shipped — 10,156 book chants become 2,187.
+The corpus was **assignment-driven** until 2026-08-31: a chant shipped only when
+some day of the liturgical year called for it, and 10,156 book chants became
+2,187. That gate is gone. The shelf now carries the books whole.
 
-Everything here answers "what was sung on this day". A query for a chant the
-calendar never calls for returns nothing.
+The reason is that the gate answered four questions with one silence. A chant
+absent from the shelf might be genuinely superseded repertoire, or printed in an
+edition the calendar does not address, or proper to a sanctorale the calendar
+does not enumerate, or simply missed by the matcher that places texts on days —
+and nothing downstream could tell those apart, because the chant was not there
+to ask about. Worse, the population every `census` measurement was taken against
+was itself the product of that gate, so "how typical is this chant" quietly meant
+"how typical among the chants one rite happened to call for".
+
+Whether a day calls for a chant is now a question for the day verbs — `festum`,
+`proprium`, `officium` — which answer it directly and say what their tables
+hold. It is not a filter on the shelf. `cantus` and `corpus` ask what the books
+print; that a chant has no day to be sung on is a fact about the calendar, not a
+reason it should be unfindable.
 
 ## The books — `corpus`
 
 `corpus(code)` returns one book's bibliographic identity and a breakdown of what
-it holds — how many chants, in what genres, in what modes. `corpus({ book })` is
+it holds: how many chants, in what genres, in what modes. `corpus({ book })` is
 the same question in the query form every other verb uses; both spellings return
 one answer.
 
-`corpus()` with no argument returns **the whole shelf** — the rollup plus every
+`corpus()` with no argument returns **the whole shelf**, the rollup plus every
 book's ledger:
 
 ```js
 tonus.corpus();
-// { count: 2187,      // chants tonus holds, each counted once
-//   listings: 2767,   // rows on the shelf — a chant in two books appears twice
-//   total: 10156,     // what the books hold, before the cut
-//   genera: [ { office: "an", genus: "Antiphona", count: 693 }, … ],
-//   modes:  [ { mode: "1", modus: "Modus I", count: 392 }, … ],
-//   books:  [ …10 Corpus entries, in registry order ] }
+// { count: 7840,      // chants tonus holds, each counted once
+//   listings: 9758,   // rows on the shelf — a chant in two books appears twice
+//   total: 9811,     // what the books hold, before dedup
+//   genera: [ { office: "an", genus: "Antiphona", count: 3959 }, … ],
+//   modes:  [ { mode: "1", modus: "Modus I", count: 1520 }, … ],
+//   books:  [ …7 Corpus entries, in registry order ] }
 ```
 
-**`count` is the number of chants** — the one to quote. `listings` is how long
+**`count` is the number of chants**, the one to quote. `listings` is how long
 the shelf is: a melody printed in several books is stored once and listed under
 each, so the shelf runs longer than the repertory. The breakdowns describe the
 same population `count` does, so `genera` and `modes` sum to it.
@@ -128,42 +135,44 @@ interface Corpus {
 }
 ```
 
-### The ledger of the cut — `full`
+### What the book holds — `full`
 
-Every `Corpus` carries `full`: what the book HELD, before the keep set ran, in
+Every `Corpus` carries `full`: what the book holds in GregoBase's catalogue, in
 the same genera/modes shape as the shipped counts.
 
 ```js
 const am = tonus.corpus("am");
-am.count;             // 576  — antiphons and the rest tonus kept
-am.full.total;        // 1456 — what the Antiphonale Monasticum holds
-am.genera[0];         // { office: "an", genus: "Antiphona", count: 458 }
+am.count;             // 1448 — chants tonus lists under the Antiphonale
+am.full.total;        // 1456 — what GregoBase catalogues for the book
+am.genera[0];         // { office: "an", genus: "Antiphona", count: 1045 }
 am.full.genera[0];    // { office: "an", genus: "Antiphona", count: 1049 }
 ```
 
-Reading the two tallies side by side names what was left out — 1,049 antiphons
-in the book, 458 sung.
+The two now sit close, because the shelf carries the book rather than a
+selection from it. What remains between them is what the extractor drops for
+reasons of its own — a chant GregoBase marks as a duplicate of another, or one
+whose GABC will not parse — not a liturgical judgement.
 
-Only the extractor can measure this. By the time tonus loads, the keep set has
-already run, so the pre-cut tally is read from an artifact rather than derived.
-Every shelved book reports one, including the Nocturnale, whose tally comes
-from its own extract rather than from GregoBase.
+Only the extractor can measure `full`. By the time tonus loads, its record is
+one per chant, so the catalogue tally is read from an artifact rather than
+derived. Every shelved book reports one, including the Nocturnale, whose tally
+comes from its own extract rather than from GregoBase.
 
 The metadata is drawn from GregoBase's own catalogue. The `genera` list is the
 office distribution (descending by count); `modes` counts modes I–VIII, with a
 final `mode: null` bucket for chants outside the eight modes (psalm tones and the
 like) so the counts reconcile with `count`.
 
-**Overlap.** tonus keeps one copy of each chant (the Liber Usualis is the primary
-source; the Antiphonarius and Hymnarius fill gaps), so a book's stored `count`
-undercounts what it holds. `total` is the full pre-dedup count, `unique` the
+**Overlap.** tonus stores one copy of each chant — the Liber Usualis owns the
+record where several books print it — but LISTS it under every book that does,
+so `count` is what a book prints rather than what it happens to store. `total` is the full pre-dedup count, `unique` the
 chants a book alone has, and `shared` how many it holds in common with each other
 book (by GregoBase chant id). These reveal, for instance, that the Liber Usualis
 is largely the Graduale and the Antiphonarius bound together (it shares hundreds
 of chants with each), while the Antiphonale Monasticum is almost entirely its own.
 
 The Nocturnale (`nr`) is compared differently, because it has no GregoBase
-catalogue: its counts come from its own extract, and it shares **nothing** —
+catalogue: its counts come from its own extract, and it shares **nothing**, so
 `unique` is all 1,564 chants it holds. That is a measurement, not a gap. The
 nocturnale–GregoBase crosswalk is a route to metadata, not a claim that the two
 books print the same chant, so it does not count as sharing.
@@ -234,11 +243,20 @@ name:
 
 | `office` | `genus`   | `office` | `genus`      | `office` | `genus`            |
 | -------- | --------- | -------- | ------------ | -------- | ------------------ |
-| `an`     | Antiphona | `hy`     | Hymnus       | `rb`     | Responsorium Breve |
-| `al`     | Alleluia  | `in`     | Introitus    | `se`     | Sequentia          |
-| `ca`     | Canticum  | `of`     | Offertorium  | `tr`     | Tractus            |
-| `co`     | Communio  | `ps`     | Psalmus      | `tp`     | Tonus Peregrinus   |
-| `gr`     | Graduale  | `re`     | Responsorium | `or`     | Ordinarium         |
+| `an`     | Antiphona | `hy`     | Hymnus       | `se`     | Sequentia          |
+| `al`     | Alleluia  | `in`     | Introitus    | `tr`     | Tractus            |
+| `ca`     | Canticum  | `of`     | Offertorium  | `tp`     | Tropa              |
+| `co`     | Communio  | `ps`     | Psalmus      | `or`     | Toni Communes      |
+| `gr`     | Graduale  | `re`     | Responsorium | `ky`     | Kyriale            |
+| `im`     | Improperia| `rb`     | Resp. Breve  | `va`     | Varia              |
+| `pa`     | Prosa     | `su`     | Supplicatio  |          |                    |
+
+The labels are GregoBase's own vocabulary (`$txt['usage']`), not tonus's
+gloss. Three were corrected in 0.10.0: `tp` reads **Tropa** (it had said
+"Tonus Peregrinus"), `or` reads **Toni Communes** (it had said "Ordinarium"),
+and `pa` reads **Prosa**. `ky` is the Mass ordinary's roll-up genus — the
+part itself rides `ordinary` (`ke`, `gl`, `cr`, …), and `va` is the
+catch-all for a chant whose office-part tonus does not recognise.
 
 ```ts
 interface Chant {
@@ -249,7 +267,9 @@ interface Chant {
   genus: string; // Latin genre name, "Antiphona", "Introitus" …
   mode: string | null; // raw from source: "1"–"8", differentia forms ("2d", "8g"), "p"/"d"/"e" …
   modus: string | null; // Latin mode name, "Modus I"–"Modus VIII"
-  pages: { page: string; sequence: number; extent: number }[];
+  books: (ChantSource | "user" | "ky")[]; // every book that prints it
+  pages: { page: string; sequence: number; extent: number }[]; // the presented book's
+
   source: {
     book: string;
     year: number | null;
@@ -282,7 +302,7 @@ interface CantusQuery {
 The Mass ordinary is addressable but not shelved. `ordinary` is the door:
 
 ```js
-tonus.cantus({ ordinary: "ky" });            // all 31 Kyries
+tonus.cantus({ ordinary: "ke" });            // all 31 Kyries
 tonus.cantus({ ordinary: "gl", mode: 4 });   // mode-4 Glorias
 tonus.cantus({ ordinary: ["as", "va"] });    // the sprinkle antiphons
 ```
@@ -295,18 +315,18 @@ A plain search does not sweep it in: `{ mode: 5 }` returns the shelf. Ask for a
 Kyrie and you get Kyries.
 
 For the setting a given DAY calls for, [`ordinarium`](#the-ordinary--ordinarium)
-is the verb — it applies the Kyriale's own rubrics. This is flat retrieval.
+is the verb, and it applies the Kyriale's own rubrics. This is flat retrieval.
 
 ### On chant ids
 
-An id's prefix names **the catalogue the identifier came from** — not the book
+An id's prefix names **the catalogue the identifier came from**, not the book
 the chant is printed in, and not a claim about who the melody belongs to. A
 chant carrying `gregobase:1210` is a Solesmes book chant that GregoBase happens
-to have catalogued; the corpus is assembled from ten books, and GregoBase is
+to have catalogued; the corpus is assembled from seven books, and GregoBase is
 one source among several.
 
 The prefix is therefore **not a namespace you can query against**. GregoBase
-holds 18,148 chants; tonus ships 1,717 of them — 9.5% — because the corpus is
+holds 18,148 chants; tonus ships 1,717 of them (9.5%), because the corpus is
 assignment-driven, so an id copied from the GregoBase site will usually return
 `[]` here. That is not a lookup failure; it means no day of the calendar calls
 for that chant. The two prefixes in the shipped corpus are `gregobase:` (1,717)
@@ -322,7 +342,7 @@ to a chant rather than to a printing.
 `before: 1098` keeps only chants a manuscript of the 10th century or earlier
 already holds. This is **evidence, not existence**: the dates come from
 CANTUS's manuscript index, a terminus ante quem, so the filter answers "what
-is attested by then," never "what existed then" — and a chant with no dated
+is attested by then," never "what existed then." A chant with no dated
 witness is excluded rather than assumed old. CANTUS dates only to the century,
 so a year admits the centuries that have CLOSED before it (`before: 1098` →
 through the 900s).
@@ -339,7 +359,7 @@ tonus.ordinarium({ feast: easter }); // the ordinary the view attests
 ```
 
 What happens to a slot the view excludes differs by verb, on the rubric's
-own logic: `ordinarium` **re-picks** — the Kyriale offers ranked
+own logic: `ordinarium` **re-picks**, because the Kyriale offers ranked
 alternatives by design, so the rotation runs over the admissible pool and
 the day still sings. `proprium` and `officium` have no pool
 of alternatives, so an excluded chant **falls silent**. A `before` given to a
@@ -371,15 +391,15 @@ interface PropriumQuery extends CantusQuery {
 ## The ordinary — `ordinarium`
 
 `ordinarium(query?)` retrieves the fixed chants of the Mass from the
-Kyriale. A feast drives mass selection through its `masses` list — the
+Kyriale. A feast drives mass selection through its `masses` list, the
 masses the day's Kyriale RUBRIC appoints, derived as described in
 [calendar.md](calendar.md#the-days-feasts--festum); `mass` pins a kyriale
 number directly. Where the rubric names several masses, the year rotates
 through them (same feast, same year → same answer, every time), and sibling
 printings under one number (Mass I prints two dismissals; Mass XVII prints
 Kyrie A/B/C) rotate with it. Slots resolve independently, which the book
-licenses outright — "chants from one Mass may be used together with those
-from others" — with one exception, the book's own: **"the Ferial Masses
+licenses outright ("chants from one Mass may be used together with those
+from others") with one exception, the book's own: **"the Ferial Masses
 excepted."** Under a ferial rubric the sung ordinary is not gathered from
 several masses; only the dismissal travels.
 
@@ -397,10 +417,10 @@ tonus.ordinarium({ feast: easter });
 
 The **Gloria follows the day's rank rubric, not its season**: the ferial
 masses print none (XVI, XVIII) and the penitential-Sunday mass none (XVII),
-while a I-class feast inside Advent or Lent — the Immaculate Conception —
+while a I-class feast inside Advent or Lent (the Immaculate Conception)
 keeps its Gloria. At a Gloria-less Mass the dismissal is the Benedicamus
 Domino, and a mass with no dismissal of its own borrows one exactly as the
-book directs: "Benedicamus Domino **as in Mass II**" — so a green feria
+book directs: "Benedicamus Domino **as in Mass II**," so a green feria
 sings Mass XVI whole with the Mass II Benedicamus. The ad libitum appendix
 is a **solemnity boost**, reachable only under the festal rubrics (it takes
 its turn in the rotation once every _n + 1_ years); it never reaches a
@@ -418,13 +438,13 @@ and selected by season: **Vidi aquam** (`va`) in Paschaltide, **Asperges
 me** (`as`) otherwise.
 
 ```js
-tonus.ordinarium({ ordinary: "ky" }); // every Kyrie
+tonus.ordinarium({ ordinary: "ke" }); // every Kyrie
 tonus.ordinarium({ mass: 9, ordinary: "gl" }); // Gloria of Cum jubilo
 ```
 
 | `ordinary` | `ordinarium`                                  |
 | ---------- | --------------------------------------------- |
-| `ky`       | Kyrie eleison                                 |
+| `ke`       | Kyrie eleison                                 |
 | `gl`       | Gloria                                        |
 | `cr`       | Credo                                         |
 | `sa`       | Sanctus                                       |
@@ -475,7 +495,7 @@ seasonal ordo and returned in liturgical order. With no feast, each resolves
 for the [default epoch](index.md#dates).
 
 **Matins is returned flat.** The night office answers like any other hour,
-its responsories drawn from the Nocturnale Romanum (`nr`) — but the
+its responsories drawn from the Nocturnale Romanum (`nr`). But the
 three-nocturn, twelve-psalm division is not modelled: the chants are right,
 their grouping into nocturns is not expressed.
 
@@ -492,7 +512,7 @@ interface OfficiumQuery extends CantusQuery {
 }
 ```
 
-The eight hours ship as [`HORAE`](index.md#the-appendix), Matins first — read
+The eight hours ship as [`HORAE`](index.md#the-appendix), Matins first. Read
 them from there rather than transcribing them, and an unrecognised `hora`
 throws rather than matching nothing, so a misspelling cannot read as an empty
 hour.
@@ -507,9 +527,9 @@ tonus.officium({ hora: "vespers" });  // throws: unknown hora "vespers"
 
 ### One cursus, the Benedictine
 
-tonus assembles a single office — the monastic cursus — with no option to
+tonus assembles a single office (the monastic cursus) with no option to
 choose another. The chants come from the Antiphonale Monasticum (`am`) and its
-companions; the psalmody follows the Benedictine distribution — the little
+companions; the psalmody follows the Benedictine distribution, the little
 hours take the gradual psalms (Terce 119–121, Sext 122–124, None 125–127),
 with Sunday and Monday walking their portions of Ps 118 instead; Prime walks
 Pss 1–19 across the week (Sunday opens Ps 118); and Compline is the fixed
@@ -530,7 +550,7 @@ the opening formula is included, as it is for a psalm's first verse.
 mediant, as a psalm sung without an antiphon; `solemn` uses a tone's
 ornamented mediant where it has one. Canticles are addressed by name:
 `benedictus`, `magnificat`, `nunc dimittis`, `benedicite`. (The Te Deum
-is not psalmody — it carries its own melody and is not addressable here.)
+is not psalmody: it carries its own melody and is not addressable here.)
 
 ```js
 tonus.psalmus({ psalm: 109, verse: "1a", mode: 1 });

package/docs/api/heavens.md

@@ -168,12 +168,12 @@ and moves with precession; a table carrying "March 21" would be wrong for most
 of the period this library models, and wrong differently every century.
 
 **What is omitted, and why.** The exaltation degrees Ptolemy gives (the Sun at
-19° Arietis and the rest) are not carried — the sign is the resolution anything
-here reads. Nor are the lunar nodes' exaltations, because the nodes are not
+19° Arietis and the rest) are not carried, because the sign is the resolution
+anything here reads. Nor are the lunar nodes' exaltations, because the nodes are not
 tonus bodies. Five signs exalt nobody: that silence is the tradition's, not a
 gap in the table.
 
-The `melothesia` is the *homo signorum* of medieval calendars — Aries at the
+The `melothesia` is the *homo signorum* of medieval calendars, Aries at the
 head down to Pisces at the feet. It was practice, not decoration: phlebotomy
 was timed against it, and while the Moon stood in a sign its member was not to
 be touched. Sourced from Ptolemy's *Tetrabiblos* I.17 and I.19
@@ -216,7 +216,7 @@ The doctrinae:
 Sphere pitches are computed directly from the doctrina's pure ratios,
 anchored at the temperamentum's A4, so historical coherence holds:
 `temperamentum("ptolemy-intense")` with `harmonia({ doctrina: "ptolemy" })`
-gives pure Ptolemaic intervals throughout — Sun→Jupiter a pure 3/2,
+gives pure Ptolemaic intervals throughout: Sun→Jupiter a pure 3/2,
 Sun→Saturn a pure 2/1. The temperamentum's scale governs pitch naming and
 the imprint.
 
@@ -322,7 +322,7 @@ h.tabula.find((r) => r.name === "Jupiter");
 ```
 
 `ratio` is the doctrina's own fraction against the mese, the primary datum of
-the whole scheme — `spn` and `hz` are that ratio sounded against A4, not
+the whole scheme. `spn` and `hz` are that ratio sounded against A4, not
 independent claims. Comparing doctrinae means comparing these: the table
 under [Theory & Context](#theory--context) is what the field returns.
 
@@ -364,7 +364,7 @@ The doctrina ratios are reconstructed from the primary texts through
 Joscelyn Godwin's syntheses, mapping each body to a Greek tone-name and
 deriving its ratio by Pythagorean interval arithmetic normalized to the
 mese (Sun = 1/1). The full method, the taxonomy, and the decisions taken
-along the way are documented at the data — see `DOCTRINAE` in
+along the way are documented at the data. See `DOCTRINAE` in
 [`harmonia/data/doctrines.ts`](https://github.com/jeffreypierce/tonus/blob/main/src/engines/harmonia/data/doctrines.ts).
 The same arithmetic is laid out from the tuning side in
 [tuning.md](tuning.md#theory--context).
@@ -385,7 +385,7 @@ The resulting ratios, by sphere from the outermost:
 
 The single pitch separating Pythagoras from Boethius is Venus: a whole
 tone above the Sun in the disjunct system (9/8, B durum), a semitone in
-the conjunct (256/243, B molle) — the origin of the durum/molle
+the conjunct (256/243, B molle). This is the origin of the durum/molle
 distinction that runs through all of medieval music theory.
 
 ## Sources

package/docs/api/index.md

@@ -4,7 +4,7 @@ The technical center of tonus: the full public API, the conventions every method
 obeys, and the error contract. The API is **fourteen methods on the `tonus`
 namespace**, no sub-namespaces.
 
-**[Orreliquum — the library at work →](https://jeffreypierce.github.io/orreliquum/)**
+**[Interactive demo](https://orreliquum.com/)**
 
 ```js
 import tonus from "tonus";
@@ -12,6 +12,7 @@ import tonus from "tonus";
 
 - [The methods](#the-methods) — by engine
 - [The appendix](#the-appendix) — the canonical constant tables
+- [The entries](#the-entries) — the four subpaths, and what each holds
 - [Full contents](#full-contents) — every method and section
 - [Conventions](#conventions) — Latin/English, dates, determinism, error contracts, bibliography
 
@@ -88,7 +89,7 @@ table of codes or English keeps English.
 | ----------- | -------------------------------------------------------------------------- |
 | `HORAE`     | the eight canonical hours, Matins first — the order is the content         |
 | `OFFICIA`   | office code → the Latin genus (`an` → "Antiphona")                         |
-| `ORDINARIA` | ordinary code → the Latin name (`ky` → "Kyrie eleison")                    |
+| `ORDINARIA` | ordinary code → the Latin name (`ke` → "Kyrie eleison")                    |
 | `MODI`      | mode number → the Latin name (`"1"` → "Modus I")                           |
 | `SOURCES`   | book code → its bibliographic record; the codes `cantus({ source })` takes |
 
@@ -123,9 +124,42 @@ is for.
 | `CENSUS_GROUPS` | the field groups → `{ offset, count }`; the keys are the valid `by:` values **and** the `profile` keys |
 | `CENSUS_ORDER`  | every censused chant id, in block order — so membership is a lookup, not a `try/catch`                 |
 
-Use these to pool blocks without reproducing the distance rule — see [the census
+Use these to pool blocks without reproducing the distance rule. See [the census
 contract](census.md#distance-is-cosine-per-field-group).
 
+## The entries
+
+The fourteen methods and every table above are on the root, and stay there. Four
+subpath entries hold what the root index was carrying without being asked to:
+the **anatomy** of a return value, and the types whose values a caller had to
+spell by hand against a query or an option bag.
+
+```js
+import { cantus, corpus } from "tonus/corpus";
+import { inscriptio } from "tonus/inscriptio";
+import type { Note, Phrase } from "tonus/score";
+```
+
+| Entry              | Holds                                                                     |
+| ------------------ | ------------------------------------------------------------------------- |
+| `tonus/corpus`     | the shelf and its vocabulary — `cantus`, `corpus`, `SOURCES`, `HORAE` …   |
+| `tonus/score`      | what a `Score` is made of — `Note`, `Phrase`, `Syllable`, `Metrics` …     |
+| `tonus/inscriptio` | the drawing surface — `inscriptio`, `Theme`, `TrackName`, `NoteGeometry`  |
+| `tonus/census`     | one chant against the corpus — `census`, `CENSUS_BLOCK_FLOATS`            |
+
+Nothing is hidden by the split. The verbs stay on the namespace — the export law
+puts them there — and the types a root signature names (`Score`, `Chant`,
+`Cadence`, `Metrics`, `Imprint`) stay on the root as well, because the root's own
+signatures name them. What moved off is what only a caller already **holding** a
+`Score` could reach.
+
+Each entry also surfaces types that were reachable through a signature but
+nameable nowhere: `ChantSource` and `OfficeCode` (the codes `cantus({ source })`
+and `office` take), `Theme` and `TrackName` (what an `opts` bag accepts), and
+`CENSUS_BLOCK_FLOATS` (the stride a caller decoding a block had to get by
+counting `CENSUS_GROUPS`). That drift — a value you must pass but cannot name —
+is what the entries exist to stop.
+
 ## Full contents
 
 Every method and every section, page by page, in dependency order. Pages later in
@@ -218,7 +252,7 @@ Other fields carry only one register. Latin-only, _e.g._ `genus`, `ordinarium`,
 `incipit`, `differentia`, `accentus`. English-only, _e.g._ `date`, `velocity`, `hz`.
 
 Display strings live in exported maps (_e.g._ `SEASON_LABEL`),
-never as label fields on objects — the maps are [the appendix](#the-appendix).
+never as label fields on objects. The maps are [the appendix](#the-appendix).
 
 ### Dates
 
@@ -238,14 +272,14 @@ an ensemble) it is seeded, so the same seed yields byte-identical output.
 
 ### Error contract
 
-- Query functions return `[]` on no match, never throw — but an **empty or
+- Query functions return `[]` on no match, never throw. But an **empty or
   unknown-key query** throws (a mistyped filter is a bug, not an empty result):
   `festum({ month: 12 })` and `cantus({})` throw rather than silently resolving a
   plausible-looking answer.
 - Builder functions throw `Error` with a descriptive message on invalid input.
 - `notatio` throws on invalid `Chant` input.
 - `inscriptio` throws on a non-`Score` argument or an unknown notation species.
-- `temperamentum.tonus()` throws if `mode` is `"auto"` — mode must be set
+- `temperamentum.tonus()` throws if `mode` is `"auto"`. Mode must be set
   explicitly.
 - Malformed `comma`, ratio, or Scala input throws `RangeError`; custom scales
   must supply 7 or 12 steps, beginning at `1/1` (a degree list) or ending at