@finbheara/archive-client 0.11.0 → 0.13.0

package/README.md

@@ -87,7 +87,6 @@ c.features;   // [{ feature: "dancers", state: "full" | "missing", missing: [...
 | `feises`, `comps` | `feises.find`, `feises.series`, `comps.*`, `registrations.resolve` | 265 |
 | `comps.dance` | the `dance` a comp of `comps.*` carries: null, never refused, without it | 270 |
 | `results.stream`, `majors.stream` | `results.stream`, `results.entries` | 255 |
-| `results.printed_age` | the `printed_age` a row of `results.stream` and `results.entries` carries: null, never refused, without it | 271 |
 | `feises.dates` | `feises.dates` | 245 |
 | `dancers.records` | `dancers.records` | 215 |
 | `dancers.years` | `dancers.years` | 245 |
@@ -195,14 +194,19 @@ A release holds a feis-year once its results are captured and carries no calenda
 ```ts
 const a = await rel.schools.resolve("Ardvarna Academy of Irish Dance (Calgary, AB)", { region: "WCRO" });
 a.arm;          // "unique" | "ambiguous" | "none"
-a.candidates;   // [{ school_id, display, rows, by, prints, regions, places }]
+a.candidates;   // [{ school_id, display, rows, by, prints, regions, places, years? }]
 ```
 
 The rungs, the first that answers wins: a school id, a retired id followed to the live one, the
 print exactly as the release published it, then the print read by `@finbheara/domain`'s school
 reader at its filing key (`sn3`) and at its real words. `ambiguous` and `none` are answers: a
 best guess is never promoted to `unique`. `region` drops only a candidate the registry places in
-other regions, and keeps one it places nowhere. A print the reader refuses (a placeholder)
+other regions, and keeps one it places nowhere. `year` reads a print at that year, on a print
+rung only: where the print reaches two or more ids, the ids whose rows printed it that year are
+kept (a print one school took over from another names the one that held it then), else the ids
+that printed it last before that year, and where the year is before every one of them, all stay
+(`a.year`: `{ asked, narrowed }`, each candidate's `years: { lo, hi }`). A dancer question reads
+its school print at its own year. A print the reader refuses (a placeholder)
 answers `none` with the reason. An id (or a retired id followed) answers with every print its
 rows were published under and their rows, so it agrees with each print lookup of that school.
 
@@ -263,8 +267,8 @@ year with the asked age, or a dancer the release publishes in the other populati
 majors solo competitions and in none of the asked one's (listed in `excluded`, `why: "age"` or
 `"population"`, and a candidate contradicting both says `age`). A dancer published in both, or in
 neither, stays. A population word that names no one population (`mixed`) narrows nothing, and the
-answer says so (`r.population.note`). The school is evidence and order, never a reason
-to drop anyone: candidates whose latest school is the asked one, or one the lineage joins to it,
+answer says so (`r.population.note`). Outside the narrowing below, the school is evidence and
+order, never a reason to drop anyone: candidates whose latest school is the asked one, or one the lineage joins to it,
 come first, then those that ever danced for it, then the rest. A school row meets the asked school by its id, else by its print
 (one `rel.schools` resolves to the asked ids), so a latest print the release
 filed under no id is still `same`. `unique` is one candidate left after the age, never a best
@@ -282,7 +286,13 @@ words):
   followed through the redirects, a print read by `rel.schools`), and none of them is the asked
   school or a school its line had joined by that year (lineage edges dated in or before the asked
   year). A dancer with no school row, or a print no school reads, is unknown and never refuted. A
-  dancer that ever danced for the asked school's line is never refuted by the school.
+  dancer that ever danced for the asked school's line is never refuted by the school. For an
+  adult-category question (the asked band is the adult band, read by `@finbheara/domain`:
+  `Adult`, `Advanced Adult`, `Adult Beginner`, `Open Adult`, `Adult Masters`), a row the
+  candidate danced under 18 (at every birth year of its window, in the row's latest year)
+  refutes nothing where the candidate is 18 or over in the asked year, however long ago the row
+  is: many adult dancers danced as children at another school. An and-over band (`O18`,
+  `18 & Over`, `18+`), `Senior`, a year of birth and a youth question are unchanged.
 - `age`: the birth window misses the asked band even with one band's dance-up (`DANCE_UP_YEARS`
   of `@finbheara/domain/age`: a dancer may enter the band one year older than the dancer's own). A
   candidate the age set aside that the dance-up holds stays open (`r.initials.heldByDanceUp`).
@@ -292,8 +302,31 @@ words):
 one candidate is open and the age did not set it aside: the candidates the school refuted then
 move to `excluded` (`why: "school"`). Otherwise the arm stays `ambiguous` with every candidate,
 and where the school and the region single out no one, `preferred` names the only open candidate
-with a row in the asked year or the year before. A full given name is never narrowed this way: two
-full given names that differ are two names, and the school only orders them.
+with a row in the asked year or the year before.
+
+A FULL GIVEN NAME with a school the release resolves is narrowed the same way (`r.fullName`, the
+same shape as `r.initials`), with one more hard fact:
+
+- `given`: a candidate the name met only through an initial print (`Quellan, A.`) that also
+  printed a full given name the names package relates in no way to the asked one is another
+  dancer. An initial-only candidate, a variant or a diminutive (`nameKinship`) stays.
+
+A candidate at another school is set aside only by the hard school fact, never for being
+elsewhere: a dancer who ever danced for the asked school's line stays open.
+
+THE WIDENED PASSES (`r.widened`), only where the name as asked is left with no one, so a widened
+match never answers over an exact one:
+
+- `birth-conflict`: a birth window the release flags (`birth.conflict`) is read one year wider on
+  each side, and the candidate says so (`candidate.widened`).
+- `name-form`: the name read in its other forms by `@finbheara/names`: `composeNames` (a print
+  that left out a second surname, a middle name or a given name's letters, or a double-barrelled
+  surname read as its parts) or else `nameKinship` (a given name's variant or diminutive). Such a
+  candidate's `nameLevel` is `form` and `evidence.form` lists the tolerances. A form is set
+  aside only by the hard school fact (`why: "name-form"`, the fact in `r.fullName.refuted` or
+  `r.initials.refuted` where the answer was narrowed): every school row of the dancer, to the
+  asked year, reads outside the asked school's line. A dancer with no school row, or a print no
+  school reads, is unknown and stays.
 
 THE REGIONAL OIREACHTAS (`oireachtas: { region, year? }`). A dancer enters one
 residence-qualifying regional Oireachtas a year. Two regionals in one year are two dancers, the
@@ -389,15 +422,11 @@ competition beside its own fields: `competition`, `event`, `year`, `tier`, `comp
 `date_printed`, `source`, `round`, and at a feis its `feis_id`, `feis_date_lo` and
 `feis_date_hi`. Its own: `address`, `section`, `card`, `place`, `place_printed`, `tie`,
 `relative_place`, `atts`, `withdrawn`, `qualifier`, `name_printed`, `name`, `school_printed`,
-`school_loc`, `school_id`, `dancer_id`, `dancer_scope`, `yob`, `yob_printed`, `printed_age`,
-`points_printed`, `platform_dancer_id`, `primary_source`, and its key in the release, `file` and `line` (one
+`school_loc`, `school_id`, `dancer_id`, `dancer_scope`, `yob`, `yob_printed`, `points_printed`,
+`platform_dancer_id`, `primary_source`, and its key in the release, `file` and `line` (one
 `(file, line)` is one row, where an `address` may carry one row per section). Rows come in the
 release's own order, a competition's rows together.
 
-`printed_age` is the dancer's own age as the row printed it (`9`), verbatim, null where the row
-printed none. It is a print, never a reading of a birth year. A release older than the column
-answers null for every row, and `rel.capability("results.printed_age")` says which.
-
 The scopes: `majors` reads the majors (tiers T1 to T3), `transcribed` the transcribed rows of
 every tier, `platform` every row a results platform published, `all` every row.