@finbheara/archive-client 0.9.0 → 0.11.0

package/README.md

@@ -87,6 +87,7 @@ 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 |
@@ -220,8 +221,9 @@ const r = await rel.dancers.resolve({
 });
 r.arm;         // "unique" | "ambiguous" | "none"
 r.candidates;  // [{ dancer_id, display, scope, score, evidence: { nameLevel, age, school, population, region }, prints, ... }]
-r.excluded;    // the candidates a contradiction set aside (why: "age" | "population" | "region")
-r.preferred;   // NON-BINDING: { dancer_id, why } where the school (else the region) singles one out; never moves arm
+r.excluded;    // the candidates a contradiction set aside (why: "age" | "population" | "region" | "school")
+r.preferred;   // NON-BINDING: { dancer_id, why } where the school (else the region, else recent rows) singles one out
+r.initials;    // an initials-only name with a school: { open, heldByDanceUp, refuted: [{ dancer_id, why, fact }], year }
 r.unlinked;    // rows printing a matched name that the release linked to no dancer
 
 await rel.dancers.search({ surname: "Quellan" });  // or { like: "a* quellan" }, or { name }
@@ -271,6 +273,28 @@ for a caller to weigh, and `arm` stays as counted. A `lineage` match ranks with
 each singles out neither. The `score` orders candidates and is no
 probability.
 
+AN INITIALS-ONLY NAME (`Butler, A`, every given field one letter) with a school the release
+resolves is narrowed by the evidence the question itself carries, where more than one candidate
+is left. A candidate is REFUTED only by a hard fact (`r.initials.refuted`, each with its `fact` in
+words):
+
+- `school`: every school row of the dancer up to the asked year reads to a school id (an id
+  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.
+- `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`).
+- `population`, `region`: the contradictions above.
+
+`r.initials.open` is every candidate no hard fact refutes. The arm is `unique` ONLY where exactly
+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.
+
 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
 overseas entry excepted. The release already applies that rule to each dancer-year it publishes:
@@ -365,11 +389,15 @@ 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`, `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`, `printed_age`,
+`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.