@finbheara/archive-client 0.16.1 → 0.17.0

package/README.md

@@ -228,9 +228,17 @@ unknown type, each dated where a year is known) read by `@finbheara/domain/schoo
 simple path between two schools, each with its flags (`relatedHops`, `maxYearGap`, `datedAfter`,
 `undated`, `provisional`, `redirected` and the rest), never a yes or a no. Pass a `policy`, your
 reading over those flags, and the answer carries its verdict (`l.policy.passes`), exact however
-many paths are listed. A retired id is followed to the live one. The release publishes no decision
-behind an edge, so a path carries no `confidence` here. A release that publishes no lineage
-refuses both calls by name.
+many paths are listed. A retired id is followed to the live one.
+
+A release that publishes the decision behind each edge (a lineage line's `decision` and
+`confidence`) gives each step its `link.decision` and `link.confidence`. A path's `confidence` is
+its weakest step's. Read it for what it is: the decision's probability that the two ids are
+not one school. It is not the probability that the edge's shape or year is right, nor that the
+two schools are linked at all: a decision whose alternative is two schools with no link counts
+that alternative inside its confidence. An edge no recorded decision backs has a `null` `decision`: its step reads
+`unbacked`, the path counts it in `flags.unbacked`, and the path's `confidence` is `null`. On a
+release that publishes neither field, no step carries either, no path is `unbacked`, and every
+path's `confidence` is `null`. A release that publishes no lineage refuses both calls by name.
 
 ## Dancers
 
@@ -287,7 +295,7 @@ earlier row at a joined school alone is no match. `r.school.lineage` lists the i
 asked ones. A release that publishes no lineage (feature `schools.lineage`) joins
 nothing and its answer carries no `lineage`, never refused. The line is read on the same school
 graph as `rel.schools.line` (`@finbheara/domain/school-graph`): untimed, every path, and as of a
-year, every path none of whose steps is dated after it (`LINE_AS_OF`).
+year, every path none of whose steps is dated after it, a rename at any year (`LINE_AS_OF`).
 
 `population` is how the dancer's published majors population meets the asked one: `same`,
 `contradicts`, `both`, `unknown`, `unasked`. A dancer's population is read only from its rows at
@@ -321,7 +329,8 @@ 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
+  year, and a rename at any year: one school under two names).
+  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. 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

package/dist/chunks/{index-hbb1dnnh.js → index-598c5w9d.js}

@@ -650,12 +650,31 @@ function linksOfLineage2(lines) {
     const k = `${from}\x00${to}\x00${r.shape}\x00${year}`;
     const was = seen.get(k);
     if (was === undefined)
-      seen.set(k, { from, to, shape: r.shape, year, provisional: r.provisional === true });
-    else if (r.provisional === true)
-      was.provisional = true;
+      seen.set(k, {
+        from,
+        to,
+        shape: r.shape,
+        year,
+        provisional: r.provisional === true,
+        ...backingOf(r)
+      });
+    else {
+      if (r.provisional === true)
+        was.provisional = true;
+      if (was.decision === undefined)
+        Object.assign(was, backingOf(r));
+    }
   }
   return [...seen.values()];
 }
+function backingOf(r) {
+  if (r.decision === undefined)
+    return {};
+  return {
+    decision: r.decision,
+    confidence: typeof r.confidence === "number" ? r.confidence : null
+  };
+}
 async function releaseSchoolGraph2(rel) {
   await rel.require("schools.lineage");
   await rel.fetch(LINEAGE_FILE2);
@@ -861,7 +880,10 @@ class SchoolResolver2 {
   }
 }
 
-var LINE_AS_OF = { name: "line-as-of", keep: (s) => !s.flags.datedAfter };
+var LINE_AS_OF = {
+  name: "line-as-of",
+  keep: (s) => !s.flags.datedAfter || s.link.shape === "rename"
+};
 function schoolLine(lineage, ids, year) {
   const reached = new Set(ids);
   for (const id of ids)

package/dist/cli.js

@@ -4,7 +4,7 @@ import {
   nameOrderOf,
   openRelease2,
   releases2
-} from "./chunks/index-hbb1dnnh.js";
+} from "./chunks/index-598c5w9d.js";
 import"./chunks/index-hne1wadw.js";
 import"./chunks/index-hghdy980.js";
 

package/dist/index.js

@@ -50,7 +50,7 @@ import {
   openCached2,
   ReleaseManager2,
   releases2
-} from "./chunks/index-hbb1dnnh.js";
+} from "./chunks/index-598c5w9d.js";
 import {
   cacheRoot2,
   repoOf2

package/dist/types/school-links.d.ts

@@ -8,6 +8,8 @@ export interface LineageLine {
     shape: string;
     year?: number | null;
     provisional?: boolean;
+    decision?: string | null;
+    confidence?: number | null;
 }
 export declare function linksOfLineage(lines: Iterable<LineageLine>): SchoolLink[];
 export declare function releaseSchoolGraph(rel: Release): Promise<SchoolGraph>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@finbheara/archive-client",
-	"version": "0.16.1",
+	"version": "0.17.0",
 	"description": "Open a versioned release of an Irish dance results archive: download, verify, decompress and cache it by tag, keep the cache, and resolve feises and schools against it",
 	"keywords": ["irish-dance", "results", "release", "cache", "sqlite"],
 	"license": "MIT",