@finbheara/archive-client 0.36.0 → 0.38.0

package/README.md

@@ -104,6 +104,7 @@ c.features;   // [{ feature: "dancers", state: "full" | "missing", missing: [...
 | `calendar.expected` | each calendar stage's `expected`; absent, never refused, without it | 320 |
 | `calendar.next` | `calendar.next` | 320 |
 | `calendar.missing` | `calendar.missing` | 320 |
+| `calendar.filed` | the `filed` of `calendar.missing`; empty, never refused, without it | 320 |
 | `tabs`, `panels` | `tabs.query`, `tabs.stream`; `panels.query` | 184 |
 | `feis-panels` | `feisPanels.query` | 260 |
 | `staff.adjudicators` | `staff.adjudicators` | 230 |
@@ -324,6 +325,8 @@ r.initials;    // an initials-only name with a school: { open, heldByDanceUp, re
 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 }
+                                                    // at most `limit` (default 50, 0 for all);
+                                                    // `truncated` counts the rest
 await rel.dancers.get(1001);                        // every print and school of one dancer
 ```
 
@@ -509,6 +512,9 @@ await rel.majors.competitions({ event: "<event>", year: 2023 });
 await rel.majors.results({ dancer_id: 1001 });       // a dancer's majors
 ```
 
+A query keeps at most `limit` rows (default 500; `0` is no limit) and `truncated` says how many
+more there were. Check it is `0` before reading the rows as the whole answer.
+
 A row carries the prints and the ids that stand for them: the address, the competition's title
 and age, the place, the name and school as printed with the dancer and school ids. The majors are
 read from `majors.sqlite`, fetched on first use.
@@ -776,7 +782,7 @@ const n = await rel.calendar.next({ brand: "plf" });
 const m = await rel.calendar.missing({ stage: "results", kind: "platform-host" });
              // stage, platform, tier, kind; { items: [{ item_id, stage, feis_instance_id, kind,
              //   platform, expected, expected_basis, expected_n, grace_days, due, overdue_days,
-             //   hosts: [{ source, feis_id, url }], ... }], deferred }
+             //   hosts: [{ source, feis_id, url }], ... }], filed: [{ ..., filed }], deferred }
 ```
 
 ONE ROW PER FEIS INSTANCE, on the id its results carry: a feis-series instance (`<brand>.<year>`),
@@ -817,7 +823,9 @@ instance, or a feis-index listing no instance holds (`feis_instance_id` null, `i
 occurrence id). `kind` is `platform-host` (a capture platform lists it, so a scrape of it should
 bring it) or `listing-only` (only a calendar listing names it, no capture platform, and its results
 may be published nowhere capture reads). A stage a capture's not-found record defers is not listed:
-`deferred` counts those. A worklist, never an error.
+`deferred` counts those. A stage already in a filed capture ticket (`calendar.filed`, the publisher's
+filed record) is not in `items` either: `filed` lists it with its ticket (`owner/repo#N`), and it is
+never counted against the threshold a capture epic is drafted over. A worklist, never an error.
 
 ## Teachers and adjudicators
 
@@ -972,9 +980,9 @@ is passed to the dancer resolver as asked (`rel.dancers`, above).
     idq dancer [--release <spec>] <name> | --surname <s> | --like <glob> | --id <dancer_id>
                [--order surname-first|given-first] [--school <print|id>]
                [--yob <y> | --band <band> [--year <y>] | --comp <competition>] [--as-of <date>]
-               [--population girls|boys] [--oireachtas <region>[:<year>]] [--rows]
+               [--population girls|boys] [--oireachtas <region>[:<year>]] [--rows] [--limit <n>]
     idq results [--release <spec>] [--dancer <id>] [--feis <id>] [--comp <c>] [--school <s>] [--year <y>] [--limit <n>]
-    idq majors [--release <spec>] [--event <e>] [--year <y>] [--comp <c>] [--dancer <id>] [--rows]
+    idq majors [--release <spec>] [--event <e>] [--year <y>] [--comp <c>] [--dancer <id>] [--rows] [--limit <n>]
     idq stream [--release <spec>] --scope majors|transcribed|platform|all [--entries] [--event <e,...>]
                [--year <y> | --year <from>..<to>] [--tier <t,...>] [--category <c,...>]
                [--level <n,...>] [--dancer <id,...>] [--school <school_id>] [--primary]
@@ -1009,9 +1017,20 @@ is passed to the dancer resolver as asked (`rel.dancers`, above).
     idq resolve dancer [<name>] [--school s] [--comp <feis>/<code> | --yob y | --band b --year y]
                        [--oireachtas <region>[:<year>]]
     idq resolve registrations
+    idq resolve teacher|adjudicator [<name|TD number>]
 
 `stream` (and `tabs --stream`) prints one JSON line per row (or entry, or cell), as it reads them. `dancer` prints the results of the one dancer where the answer is unique (every candidate's with
-`--rows`). `--json` prints the call's answer as it is. `--cache` and `--repo` override the defaults.
+`--rows`), and `--id` every row of the one dancer. `--json` prints the call's answer as it is.
+
+A LIMIT THAT CUTS AN ANSWER SAYS SO. `results`, `majors --comp|--dancer` (500 rows) and a
+`dancer` search (50 candidates) take `--limit <n>`, and `--limit 0` is no limit. Where the limit
+cut the answer, one line goes to stderr, in text and `--json` alike, and stdout is unchanged:
+
+    answered 500 of 979 rows: pass --limit 979 (or --limit 0 for all) for the rest
+
+A `dancer` search prints the same line of its candidates, and each trajectory it reads (one per
+candidate, 500 rows each) that was cut prints `answered 500 of 979 rows of dancer <id>: pass --id
+<id> for all of them`. `--cache` and `--repo` override the defaults.
 
 `update` moves to the newest published release, as a package manager's `update` moves to the newest
 version: it fetches it (verified as every download is), builds every index it knows, and only then
@@ -1058,7 +1077,10 @@ only when the release is published: `teams`, `events`) answers from the pinned r
 `resolve` speaks JSON lines: one answer per line out, and with no positional question the
 questions are JSON lines on stdin, one per line (`{feis, code, year?, title?}`,
 `{name, school?, age?, population?, oireachtas?}`,
-`{name, school?, codes, feis, year?, population?, oireachtas?}`). A line that is no JSON object,
+`{name, school?, codes, feis, year?, population?, oireachtas?}`, and for `teacher` and
+`adjudicator` `{name}` or the TD number under the key `StaffPerson` carries it in, the number read
+first where a line has both, each answered by `rel.staff.teacher` / `rel.staff.adjudicator`, one
+`StaffAnswer` a line). A line that is no JSON object,
 or no question of its kind, answers `{tag, line, error}` and the other lines still answer. The
 exit is non-zero where any line erred. A dancer's age may be given as a comp
 (`{"comp": "<feis>/<code>"}`, or `--comp` on the command line): `rel.registrations.dancer` reads

package/dist/chunks/{index-c08q1b0d.js → index-z9zxdmw5.js}

@@ -769,6 +769,12 @@ var FEATURES2 = [
     since: 320,
     calls: "calendar.missing"
   },
+  {
+    feature: "calendar.filed",
+    needs: ["results:feis_calendar_missing.deferred_kind"],
+    since: 320,
+    calls: "calendar.missing's `filed` (empty, never refused, without it)"
+  },
   {
     feature: "upcoming.entrants",
     needs: [
@@ -1496,7 +1502,7 @@ function queryResults(rel, db, q) {
     where.push("c.year = ?");
     args.push(q.year);
   }
-  const limit = q.limit ?? 500;
+  const asked = q.limit ?? 500;
   const all = rel.db(db).query(`SELECT ${COLUMNS2} FROM results r JOIN competitions c ON c.file = r.file AND c.line = r.competition_line
 			 WHERE ${where.join(" AND ")}
 			 ORDER BY c.year, c.event, r.competition, r.place IS NULL, r.place, r.address`).all(...args);
@@ -1504,11 +1510,11 @@ function queryResults(rel, db, q) {
     tag: rel.tag,
     db,
     asked: q,
-    rows: all.slice(0, limit).map((r) => ({
+    rows: (asked === 0 ? all : all.slice(0, asked)).map((r) => ({
       ...r,
       dancer_scope: r.dancer_id === null ? null : r.dancer_id >= FEIS_LOCAL_ID_FLOOR2 ? "per-release" : "stable"
     })),
-    truncated: Math.max(0, all.length - limit)
+    truncated: asked === 0 ? 0 : Math.max(0, all.length - asked)
   };
 }
 
@@ -2231,6 +2237,7 @@ class DancerResolver2 {
         asked: q,
         arm: "none",
         candidates: [],
+        truncated: 0,
         excluded: [],
         unlinked: [],
         refused: asked.printsNoName() ? "the print names no person" : "the print reads as no person (a bare word is a surname: search it)"
@@ -2342,7 +2349,13 @@ class DancerResolver2 {
     return this.capped(a, q.limit);
   }
   capped(a, limit = 50) {
-    return { ...a, candidates: a.candidates.slice(0, limit) };
+    if (limit === 0 || a.candidates.length <= limit)
+      return a;
+    return {
+      ...a,
+      candidates: a.candidates.slice(0, limit),
+      truncated: a.candidates.length - limit
+    };
   }
   async get(dancerId) {
     const db = await this.rel.indexDb("dancers");
@@ -2600,6 +2613,7 @@ class DancerResolver2 {
       asked: q,
       arm: kept.length === 0 ? "none" : kept.length === 1 ? "unique" : "ambiguous",
       candidates: kept,
+      truncated: 0,
       excluded,
       ...preferred !== undefined ? { preferred } : {},
       unlinked: [...unlinked].map(([print, rows]) => ({ print, rows })).sort((a, b) => b.rows - a.rows || (a.print < b.print ? -1 : 1)),
@@ -4014,31 +4028,34 @@ class CalendarFinder2 {
     const rows = db.query(`SELECT * FROM feis_calendar_missing${where.length === 0 ? "" : ` WHERE ${where.join(" AND ")}`}
 				 ORDER BY CASE stage WHEN 'results' THEN 0 ELSE 1 END,
 				          CASE kind WHEN 'platform-host' THEN 0 ELSE 1 END, platform, due, item_id`).all(...args);
-    const live = rows.filter((r) => r.deferred === null || r.deferred === undefined);
+    const isDeferred = (r) => r.deferred !== null && r.deferred !== undefined;
+    const isFiled = (r) => isDeferred(r) && r.deferred_kind === "filed";
+    const item = (r) => ({
+      item_id: r.item_id,
+      stage: r.stage,
+      feis_instance_id: r.feis_instance_id ?? null,
+      feis_brand_id: r.feis_brand_id ?? null,
+      tier: r.tier,
+      name_printed: r.name_printed ?? null,
+      date_lo: r.date_lo ?? null,
+      date_hi: r.date_hi ?? null,
+      occurrence_ids: json(r.occurrence_ids, []),
+      feis_ids: json(r.feis_ids, []),
+      kind: r.kind,
+      platform: r.platform,
+      expected: r.expected,
+      expected_basis: r.expected_basis,
+      expected_n: r.expected_n === null || r.expected_n === undefined ? null : Number(r.expected_n),
+      grace_days: Number(r.grace_days),
+      due: r.due,
+      overdue_days: Number(r.overdue_days),
+      hosts: json(r.hosts, [])
+    });
     return {
       tag: this.rel.tag,
-      items: live.map((r) => ({
-        item_id: r.item_id,
-        stage: r.stage,
-        feis_instance_id: r.feis_instance_id ?? null,
-        feis_brand_id: r.feis_brand_id ?? null,
-        tier: r.tier,
-        name_printed: r.name_printed ?? null,
-        date_lo: r.date_lo ?? null,
-        date_hi: r.date_hi ?? null,
-        occurrence_ids: json(r.occurrence_ids, []),
-        feis_ids: json(r.feis_ids, []),
-        kind: r.kind,
-        platform: r.platform,
-        expected: r.expected,
-        expected_basis: r.expected_basis,
-        expected_n: r.expected_n === null || r.expected_n === undefined ? null : Number(r.expected_n),
-        grace_days: Number(r.grace_days),
-        due: r.due,
-        overdue_days: Number(r.overdue_days),
-        hosts: json(r.hosts, [])
-      })),
-      deferred: rows.length - live.length
+      items: rows.filter((r) => !isDeferred(r)).map(item),
+      filed: rows.filter(isFiled).map((r) => ({ ...item(r), filed: r.deferred })),
+      deferred: rows.filter((r) => isDeferred(r) && !isFiled(r)).length
     };
   }
   async get(id) {

package/dist/cli.js

@@ -21,7 +21,7 @@ import {
   latestCheck2,
   within,
   staleWarning2
-} from "./chunks/index-c08q1b0d.js";
+} from "./chunks/index-z9zxdmw5.js";
 import"./chunks/index-hghdy980.js";
 
 var USAGE_HEADER = "usage: idq <verb> [--cache <dir>] [--repo <owner/name>] [--json] [--live]";
@@ -199,20 +199,23 @@ var VERBS = [
       "--comp",
       "--as-of",
       "--population",
-      "--oireachtas"
+      "--oireachtas",
+      "--limit"
     ],
     bool: ["--rows"],
     usage: [
       "  dancer [--release <spec>] <name> | --surname <s> | --like <glob> | --id <dancer_id>",
       "         [--order surname-first|given-first] [--school <print|id>]",
       "         [--yob <y> | --band <U10> [--year <y>] | --comp <competition>] [--as-of <date>]",
-      "         [--population girls|boys] [--oireachtas <region>[:<year>]] [--rows]",
+      "         [--population girls|boys] [--oireachtas <region>[:<year>]] [--rows] [--limit <n>]",
       "                                    the dancers a name reaches, each with its evidence",
       "                                    (name level, age, school, population, region) and the arm;",
       "                                    --oireachtas is the regional the roster is for, its region in",
       "                                    the release's spelling (SRO, MAO), its year the --as-of year",
       "                                    where none is given; the results of",
-      "                                    the one dancer where one answers (or --rows for each)"
+      "                                    the one dancer where one answers (or --rows for each, 500",
+      "                                    rows a dancer; --id reads every row); at most --limit",
+      "                                    candidates (default 50, 0 for all)"
     ]
   },
   {
@@ -222,17 +225,20 @@ var VERBS = [
     usage: [
       "  results [--release <spec>] [--dancer <id>] [--feis <id>] [--comp <competition>]",
       "          [--school <print|id>] [--year <y>] [--limit <n>]",
-      "                                    the published result rows, prints and ids"
+      "                                    the published result rows, prints and ids; at most",
+      "                                    --limit rows (default 500, 0 for all)"
     ]
   },
   {
     verb: "majors",
-    value: ["--release", "--event", "--year", "--comp", "--dancer"],
+    value: ["--release", "--event", "--year", "--comp", "--dancer", "--limit"],
     bool: [],
     usage: [
       "  majors [--release <spec>] [--event <e>] [--year <y>] [--comp <competition>] [--dancer <id>]",
+      "         [--limit <n>]",
       "                                    the majors: every event and its years; an event's",
-      "                                    competitions; a competition's, an event's or a dancer's rows"
+      "                                    competitions; a competition's, an event's or a dancer's rows",
+      "                                    (at most --limit, default 500, 0 for all)"
     ]
   },
   {
@@ -424,7 +430,8 @@ var VERBS = [
       "           [--kind platform-host|listing-only]",
       "                                    the stages past their expected day plus the platform's",
       "                                    grace, the run in the last 365 days: hosts, urls, expected",
-      "                                    day, grace and days overdue; the deferred counted apart"
+      "                                    day, grace and days overdue; the filed (a capture ticket",
+      "                                    names them) and the deferred counted apart"
     ]
   },
   {
@@ -490,11 +497,15 @@ var VERBS = [
       "                 [--order <o>] [--as-of <date>] [--population girls|boys]",
       "                 [--oireachtas <region>[:<year>]]",
       "  resolve registrations",
+      "  resolve teacher|adjudicator [<name|TD number>]",
       "                                    JSONL out, one answer per line; with no positional the",
       "                                    questions are JSONL on stdin, one per line (a comp:",
       "                                    {feis, code, year?, title?}, a dancer: {name, school?, age?,",
       "                                    population?, oireachtas?}, a registration: {name, school?,",
-      "                                    codes[], feis, year?, population?, oireachtas?})"
+      "                                    codes[], feis, year?, population?, oireachtas?}, a teacher or",
+      "                                    adjudicator: {clrg} or {name}, the TD number first)",
+      "                                    A line that is no question answers {tag, line, error}, and",
+      "                                    the exit is 1 where any line erred"
     ]
   }
 ];
@@ -599,6 +610,21 @@ function printResults(a, say) {
     say("  * a feis-local dancer id: valid in this release only");
   say(`${a.rows.length} row(s) from ${a.db} in ${a.tag}${a.truncated > 0 ? `, ${a.truncated} more past the limit` : ""}`);
 }
+function cutNotice(shown, more, what = "rows") {
+  if (more <= 0)
+    return null;
+  const total = shown + more;
+  return `answered ${shown} of ${total} ${what}: pass --limit ${total} (or --limit 0 for all) for the rest`;
+}
+function limitOf(p) {
+  const v = p.flags.get("--limit");
+  if (v === undefined)
+    return {};
+  const n = Number(v);
+  if (!Number.isInteger(n) || n < 0)
+    throw new Error(`--limit takes a count (0 for no limit), not "${v}"`);
+  return { limit: n };
+}
 function printStaff(a, say) {
   say(`${a.arm}  ${a.role} "${a.asked}"  in ${a.tag}${a.refused !== undefined ? `  (refused: ${a.refused})` : ""}`);
   for (const p of a.people) {
@@ -660,6 +686,14 @@ function oireachtasFlag(v) {
   };
 }
 var checkDancer = (q) => typeof q.name !== "string" || q.name.trim() === "" ? "a dancer question needs name" : null;
+function staffAsked(q) {
+  if (q.clrg !== undefined && q.clrg !== null) {
+    const n = typeof q.clrg === "string" && q.clrg.trim() !== "" ? Number(q.clrg) : q.clrg;
+    return typeof n === "number" && Number.isInteger(n) && n > 0 ? String(n) : null;
+  }
+  return typeof q.name === "string" && q.name.trim() !== "" ? q.name.trim() : null;
+}
+var checkStaff = (q) => q.clrg !== undefined && q.clrg !== null && staffAsked(q) === null ? "a staff question's clrg is a TD number" : staffAsked(q) === null ? "a staff question needs name or clrg" : null;
 var checkRegistration = (r) => typeof r.name !== "string" || r.name.trim() === "" ? "a registration row needs name" : typeof r.feis !== "string" || r.feis.trim() === "" ? "a registration row needs feis" : !Array.isArray(r.codes) ? "a registration row needs codes[]" : null;
 async function resolveVerb(rel, what, args, p, say, stdin) {
   const year = p.flags.has("--year") ? Number(p.flags.get("--year")) : undefined;
@@ -742,8 +776,21 @@ async function resolveVerb(rel, what, args, p, say, stdin) {
       await each(lines, async () => answers[k++]);
       return errors > 0 ? 1 : 0;
     }
+    case "teacher":
+    case "adjudicator": {
+      const qs = args.length > 0 ? [{ line: 0, value: { name: args.join(" ") } }] : jsonLines(await stdin(), checkStaff);
+      let none = 0;
+      await each(qs, async (q) => {
+        const asked = staffAsked(q);
+        const a = what === "teacher" ? await rel.staff.teacher(asked) : await rel.staff.adjudicator(asked);
+        if (a.arm === "none")
+          none++;
+        return a;
+      });
+      return errors > 0 || args.length > 0 && none === 1 ? 1 : 0;
+    }
     default:
-      throw new Error("resolve comp|dancer|registrations");
+      throw new Error("resolve comp|dancer|registrations|teacher|adjudicator");
   }
 }
 var SCOPES = ["majors", "transcribed", "platform", "all"];
@@ -1129,7 +1176,7 @@ async function main(argv, io = {}) {
           const id = p.flags.get("--id");
           if (id !== undefined) {
             const d = await rel.dancers.get(Number(id));
-            const rows = d === null ? null : await rel.results.query({ dancer_id: d.dancer_id });
+            const rows = d === null ? null : await rel.results.query({ dancer_id: d.dancer_id, limit: 0 });
             out({ dancer: d, results: rows }, () => {
               if (d === null) {
                 say(`no dancer ${id} in ${rel.tag}`);
@@ -1157,7 +1204,7 @@ async function main(argv, io = {}) {
             ...p.flags.has("--as-of") ? { asOf: p.flags.get("--as-of") } : {},
             ...p.flags.has("--population") ? { population: p.flags.get("--population") } : {},
             ...oireachtasFlag(p.flags.get("--oireachtas")),
-            ...p.flags.has("--limit") ? { limit: Number(p.flags.get("--limit")) } : {}
+            ...limitOf(p)
           };
           const surname = p.flags.get("--surname");
           const like = p.flags.get("--like");
@@ -1177,6 +1224,12 @@ async function main(argv, io = {}) {
               printResults(t, say);
             }
           });
+          const cut = cutNotice(a.candidates.length, a.truncated, "candidates");
+          if (cut !== null)
+            log(cut);
+          for (const t of trajectories)
+            if (t.truncated > 0)
+              log(`answered ${t.rows.length} of ${t.rows.length + t.truncated} rows of dancer ${t.asked.dancer_id}: pass --id ${t.asked.dancer_id} for all of them`);
           return a.candidates.length === 0 ? 1 : 0;
         } finally {
           rel.close();
@@ -1191,10 +1244,13 @@ async function main(argv, io = {}) {
             ...p.flags.has("--comp") ? { competition: p.flags.get("--comp") } : {},
             ...p.flags.has("--school") ? { school_id: await schoolIdOf(rel, p.flags.get("--school")) } : {},
             ...p.flags.has("--year") ? { year: Number(p.flags.get("--year")) } : {},
-            ...p.flags.has("--limit") ? { limit: Number(p.flags.get("--limit")) } : {}
+            ...limitOf(p)
           };
           const a = await rel.results.query(q);
           out(a, () => printResults(a, say));
+          const cut = cutNotice(a.rows.length, a.truncated);
+          if (cut !== null)
+            log(cut);
           return a.rows.length === 0 ? 1 : 0;
         } finally {
           rel.close();
@@ -1213,9 +1269,12 @@ async function main(argv, io = {}) {
               ...dancer !== undefined ? { dancer_id: Number(dancer) } : {},
               ...event !== undefined ? { feis: event } : {},
               ...year !== undefined ? { year: Number(year) } : {},
-              ...p.flags.has("--limit") ? { limit: Number(p.flags.get("--limit")) } : {}
+              ...limitOf(p)
             });
             out(a, () => printResults(a, say));
+            const cut = cutNotice(a.rows.length, a.truncated);
+            if (cut !== null)
+              log(cut);
             return a.rows.length === 0 ? 1 : 0;
           }
           if (event !== undefined) {
@@ -1591,7 +1650,9 @@ async function main(argv, io = {}) {
                 for (const h of m.hosts)
                   say(`      ${h.source}  ${h.feis_id ?? "-"}  ${h.url ?? "-"}`);
               }
-              say(`${a.items.length} missing, ${a.deferred} deferred, in ${a.tag}`);
+              for (const m of a.filed)
+                say(`  ${m.due}  ${m.item_id}  ${m.stage}  ${m.kind}  ${m.platform}  run ${m.date_lo ?? "?"}  FILED ${m.filed}${m.name_printed !== null ? `  "${m.name_printed}"` : ""}`);
+              say(`${a.items.length} missing, ${a.filed.length} filed, ${a.deferred} deferred, in ${a.tag}`);
             });
             return a.items.length === 0 ? 1 : 0;
           }
@@ -1739,6 +1800,7 @@ export {
   USAGE_FOOTER,
   USAGE_HEADER,
   VERBS,
+  cutNotice,
   jsonLines,
   main,
   parseArgs,

package/dist/index.js

@@ -80,7 +80,7 @@ import {
   readLatestCheck2,
   latestCheck2,
   staleWarning2
-} from "./chunks/index-c08q1b0d.js";
+} from "./chunks/index-z9zxdmw5.js";
 import {
   cacheRoot2,
   repoOf2

package/dist/types/calendar.d.ts

@@ -93,9 +93,13 @@ export interface CalendarMissingQuery {
     tier?: string;
     kind?: CalendarMissingKind;
 }
+export interface CalendarFiled extends CalendarMissing {
+    filed: string;
+}
 export interface CalendarMissingAnswer {
     tag: string;
     items: CalendarMissing[];
+    filed: CalendarFiled[];
     deferred: number;
 }
 export interface CalendarGetAnswer {

package/dist/types/cli.d.ts

@@ -12,6 +12,7 @@ export interface Parsed {
     bools: Set<string>;
 }
 export declare function parseArgs(argv: readonly string[]): Parsed;
+export declare function cutNotice(shown: number, more: number, what?: string): string | null;
 type Line<T> = {
     line: number;
     value: T;

package/dist/types/dancers.d.ts

@@ -106,6 +106,7 @@ export interface DancerAnswer {
     asked: DancerQuery;
     arm: "unique" | "ambiguous" | "none";
     candidates: DancerCandidate[];
+    truncated: number;
     excluded: ExcludedCandidate[];
     preferred?: {
         dancer_id: number;

package/dist/types/index.d.ts

@@ -26,5 +26,5 @@ export { type EntryRow, type StreamCompetition, type StreamQuery, type StreamRow
 export { type FeisPanelSeat, FeisPanelFinder, PanelFinder, type PanelSeat, type RegisterRow, type TabAnswer, TabFinder, type TabQuery, type TabRow, type TabStreamQuery, } from "./tabs.js";
 export { EventFinder, type EventYear, type EventYearQuery, type ResultRoster, type RosterMember, type RosterTeam, TeamFinder, type TeamResult, } from "./teams.js";
 export { type EntrantCandidate, FIELD_STATES, type FieldComp, DEPARTURE_REASONS, type DepartureReason, type FieldState, type HeldOut, type UpcomingDeparture, type UpcomingDepartureAnswer, type UpcomingDepartureQuery, type UpcomingEntrant, type UpcomingEntrantAnswer, type UpcomingEntrantQuery, type UpcomingFeis, type UpcomingFeisAnswer, type UpcomingFeisQuery, type UpcomingFeisState, type UpcomingField, type UpcomingFieldAnswer, type UpcomingFieldQuery, UpcomingFinder, type UpcomingHost, } from "./upcoming.js";
-export { CALENDAR_STAGES, CALENDAR_STAGE_STATES, CALENDAR_TERMINALS, type CalendarAnswer, type CalendarEntry, type CalendarExpected, type CalendarExpectedBasis, type CalendarMissing, type CalendarMissingAnswer, type CalendarMissingHost, type CalendarMissingKind, type CalendarMissingQuery, type CalendarMissingStage, type CalendarNext, type CalendarNextAnswer, CalendarFinder, type CalendarGetAnswer, type CalendarQuery, type CalendarStage, type CalendarStageState, type CalendarStageValue, type CalendarTerminal, } from "./calendar.js";
+export { CALENDAR_STAGES, CALENDAR_STAGE_STATES, CALENDAR_TERMINALS, type CalendarAnswer, type CalendarEntry, type CalendarExpected, type CalendarExpectedBasis, type CalendarFiled, type CalendarMissing, type CalendarMissingAnswer, type CalendarMissingHost, type CalendarMissingKind, type CalendarMissingQuery, type CalendarMissingStage, type CalendarNext, type CalendarNextAnswer, CalendarFinder, type CalendarGetAnswer, type CalendarQuery, type CalendarStage, type CalendarStageState, type CalendarStageValue, type CalendarTerminal, } from "./calendar.js";
 export { ARCHIVE_TAG, type ArchiveTag, type ReleaseSpec, compareTagsNewestFirst, cutOf, parseArchiveTag, parseReleaseSpec, pickTag, renderArchiveTag, } from "./tag.js";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@finbheara/archive-client",
-	"version": "0.36.0",
+	"version": "0.38.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",