@finbheara/archive-client 0.16.2 → 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
 

package/dist/chunks/{index-bpd2j026.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);

package/dist/cli.js

@@ -4,7 +4,7 @@ import {
   nameOrderOf,
   openRelease2,
   releases2
-} from "./chunks/index-bpd2j026.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-bpd2j026.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.2",
+	"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",