@openmixer/plugin-qualify 0.14.1 → 0.16.0

package/dist/history-file.js

@@ -0,0 +1,133 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * The running-history file plugin-hostd writes and `plugin-qualify adjust --history` reads (plugin-hostd's `data/history.json`
+ * and `src/history.c`): a header line, then one line per plugin binary and host class,
+ *
+ *     history <uri> <binary digest> <host class> key=value ...
+ *
+ * The reader keeps the daemon's rules for what it reads: the header must be the one it knows, a line outside the grammar
+ * is not read (and counted, so the caller can say so), a second line of one plugin binary on one host class is not read,
+ * a value is a whole number or a decimal and never negative. It differs in one place on purpose: a key it does not know
+ * is not a reason to skip the line, it is kept on the record (`unknownKeys`) and the known keys are read, so a daemon
+ * that grows a key inside history/1 does not blind the qualifier. Nothing here writes the file; only the daemon does.
+ */
+/** The header line of the format this reader knows, plugin-hostd's `PHD_HISTORY_HEADER`. */
+export const HISTORY_HEADER = "# plugin-hostd history/1";
+/** The verb a record line starts with, plugin-hostd's `PHD_HISTORY_RECORD`. */
+export const HISTORY_RECORD = "history";
+/**
+ * PLUGIN_HOSTD_HISTORY_KEYS in the daemon's order, each with the field it fills and how its value is written. The words
+ * are plugin-hostd's (`data/history.json`); `history-file.test.ts` holds this table to them.
+ */
+const KEYS = [
+    { word: "first", field: "first", kind: "time" },
+    { word: "last", field: "last", kind: "time" },
+    { word: "windows_solo", field: "windowsSolo", kind: "count" },
+    { word: "windows_grouped", field: "windowsGrouped", kind: "count" },
+    { word: "cpu_p95_solo", field: "cpuP95Solo", kind: "decimal" },
+    { word: "cpu_max_solo", field: "cpuMaxSolo", kind: "decimal" },
+    { word: "pss_mb_solo", field: "pssMbSolo", kind: "decimal" },
+    { word: "xrun_windows_solo", field: "xrunWindowsSolo", kind: "count" },
+    { word: "xrun_windows_grouped", field: "xrunWindowsGrouped", kind: "count" },
+    { word: "crashes_solo", field: "crashesSolo", kind: "count" },
+    { word: "crashes_grouped", field: "crashesGrouped", kind: "count" },
+    { word: "restarts_grouped", field: "restartsGrouped", kind: "count" },
+    { word: "quarantines", field: "quarantines", kind: "count" },
+    { word: "last_crash", field: "lastCrash", kind: "time" },
+    { word: "last_crash_grouped", field: "lastCrashGrouped", kind: "time" },
+];
+/** The words of the keys this reader knows, in the daemon's order. */
+export const HISTORY_KEY_WORDS = KEYS.map((k) => k.word);
+const HEX = /^[0-9a-f]{64}$/;
+const WHOLE = /^[0-9]+$/;
+const DECIMAL = /^([0-9]+\.?[0-9]*|\.[0-9]+)([eE][+-]?[0-9]+)?$/;
+function number(text, kind) {
+    if (kind === "decimal") {
+        if (!DECIMAL.test(text))
+            return undefined;
+        const v = Number(text);
+        return Number.isFinite(v) ? v : undefined;
+    }
+    if (!WHOLE.test(text))
+        return undefined;
+    const v = Number(text);
+    return Number.isSafeInteger(v) ? v : undefined;
+}
+/** One record line, or the reason it is outside the grammar. */
+function parseRecord(words) {
+    if (words.length < 4 || words[0] !== HISTORY_RECORD)
+        return `not a ${HISTORY_RECORD} line with a uri, a digest and a host class`;
+    const [, uri, digest, hostClass] = words;
+    if (!HEX.test(digest))
+        return `${digest}: not a digest of 64 lowercase hex digits`;
+    const values = {};
+    const unknownKeys = {};
+    const seen = new Set();
+    for (const word of words.slice(4)) {
+        const eq = word.indexOf("=");
+        if (eq < 0)
+            return `${word}: not key=value`;
+        const key = word.slice(0, eq);
+        const text = word.slice(eq + 1);
+        if (seen.has(key))
+            return `${key}: given twice`;
+        seen.add(key);
+        const known = KEYS.find((k) => k.word === key);
+        if (known === undefined) {
+            unknownKeys[key] = text;
+            continue;
+        }
+        const v = number(text, known.kind);
+        if (v === undefined)
+            return `${key}=${text}: not ${known.kind === "decimal" ? "a decimal" : "a whole number"}, or negative`;
+        values[known.field] = v;
+    }
+    const counters = Object.fromEntries(KEYS.map((k) => [k.field, values[k.field] ?? 0]));
+    return { uri, digest, hostClass, ...counters, unknownKeys };
+}
+/**
+ * Read the text of a history file. A file whose first line (blank lines apart) is not the header is refused as a whole,
+ * as the daemon blocks it: a version this reader does not know is not read by guessing. Comment lines and blank lines
+ * after the header are skipped.
+ */
+export function readHistory(text) {
+    const lines = text.split("\n").map((l) => l.replace(/\r$/, ""));
+    const first = lines.findIndex((l) => l.trim() !== "");
+    if (first < 0)
+        return { ok: true, records: [], ignored: [] };
+    if (lines[first] !== HISTORY_HEADER) {
+        return {
+            ok: false,
+            problem: lines[first].startsWith("# plugin-hostd history/")
+                ? `${JSON.stringify(lines[first])} is a version this reader does not know (it reads ${HISTORY_HEADER})`
+                : "not a history file: it does not begin with " + HISTORY_HEADER,
+        };
+    }
+    const records = [];
+    const ignored = [];
+    for (let i = first + 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.trim() === "" || line.startsWith("#"))
+            continue;
+        const parsed = parseRecord(line.split(/[ \t]+/).filter((w) => w !== ""));
+        if (typeof parsed === "string") {
+            ignored.push({ line: i + 1, problem: parsed });
+        }
+        else if (records.some((r) => r.uri === parsed.uri && r.digest === parsed.digest && r.hostClass === parsed.hostClass)) {
+            ignored.push({ line: i + 1, problem: "a second line of one plugin binary on one host class" });
+        }
+        else
+            records.push(parsed);
+    }
+    return { ok: true, records, ignored };
+}
+/** The record of one plugin binary on one host class, or `undefined`. */
+export function findHistory(records, uri, digest, hostClass) {
+    return records.find((r) => r.uri === uri && r.digest === digest && r.hostClass === hostClass);
+}
+/** The host classes a history holds a record for, sorted. */
+export function historyClasses(records) {
+    return [...new Set(records.map((r) => r.hostClass))].sort();
+}
+//# sourceMappingURL=history-file.js.map

package/dist/history-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-file.js","sourceRoot":"","sources":["../src/history-file.ts"],"names":[],"mappings":"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"}

package/dist/host-admission.d.ts

@@ -0,0 +1,53 @@
+import type { HostProfile } from "./host-profiles.js";
+/** The profile ids whose verdict is measured by a run. */
+export declare const ADMITTED_HOSTS: readonly ["mod-host", "jalv"];
+export type AdmittedHost = (typeof ADMITTED_HOSTS)[number];
+/** The admitting host of a profile, or `undefined` when its verdict is judged from a declaration. */
+export declare function admittedHostOf(profile: HostProfile): AdmittedHost | undefined;
+/** What running the plugin under one host came to. */
+export interface HostAdmission {
+    readonly host: AdmittedHost;
+    /** False when the host could not be run (not installed): there is no evidence either way. */
+    readonly measured: boolean;
+    readonly admitted: boolean;
+    /** Why not: `<host>.resp-<n>`, `<host>.signal-<SIG>`, `mod-host.died-on-add`, `jalv.unknown-port-type`, `<host>.not-installed`, … */
+    readonly code?: string;
+    readonly params: Readonly<Record<string, string | number>>;
+}
+/** One command mod-host was sent and what came of it: its `resp` number, or how the host died. */
+export interface ModHostStep {
+    readonly cmd: "add" | "remove";
+    readonly resp?: number;
+    /** The signal that killed the host, or `exit` / `closed` when it went without one. */
+    readonly died?: string;
+}
+/** What `tools/mod-host-admit.mjs` printed. */
+export interface ModHostRun {
+    readonly installed: boolean;
+    readonly steps: readonly ModHostStep[];
+}
+/** The verdict of a mod-host run: the first step that did not answer `resp 0` decides. */
+export declare function classifyModHostRun(run: ModHostRun): HostAdmission;
+/** What `jalv -n <name> <uri>` did in its window. */
+export interface JalvRun {
+    readonly installed: boolean;
+    /** True when jalv was still running at the deadline and was stopped by the caller. */
+    readonly stillRunning: boolean;
+    readonly status: number | null;
+    readonly signal: string | null;
+    readonly stderr: string;
+}
+/** The verdict of a jalv run: alive at the deadline is hosted; a signal, an unknown port type, or an exit is not. */
+export declare function classifyJalvRun(run: JalvRun): HostAdmission;
+/** How long jalv must stay alive to count as hosting the plugin, in milliseconds. */
+export declare const JALV_HOSTED_MS = 3000;
+/** The wall clock of one whole mod-host admission, in milliseconds. */
+export declare const MOD_HOST_ADMISSION_MS = 30000;
+export interface AdmissionRuns {
+    readonly modHost: (uri: string) => ModHostRun;
+    readonly jalv: (uri: string) => JalvRun;
+}
+/** The runs against the installed hosts. */
+export declare const SPAWNED_ADMISSIONS: AdmissionRuns;
+/** One admission of `uri` under `host`. */
+export declare function admitPlugin(host: AdmittedHost, uri: string, runs?: AdmissionRuns): HostAdmission;

package/dist/host-admission.js

@@ -0,0 +1,96 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * HOST ADMISSION — a `mod-host` or `jalv` verdict is MEASURED by running the plugin under that host,
+ * one admission per plugin, not judged from a declaration. mod-host: `add`, `remove` on
+ * its socket, a fresh host after any death (`tools/mod-host-admit.mjs` does the run and prints what
+ * happened; one line of JSON). jalv: `jalv -n <name> <uri>` headless, hosted when it is still alive
+ * at the deadline. The classifiers here are pure: what the host answered goes in, a {@link HostAdmission}
+ * with the deciding code comes out; the runs are injected, so a test replays recorded answers.
+ */
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+/** The profile ids whose verdict is measured by a run. */
+export const ADMITTED_HOSTS = ["mod-host", "jalv"];
+/** The admitting host of a profile, or `undefined` when its verdict is judged from a declaration. */
+export function admittedHostOf(profile) {
+    return ADMITTED_HOSTS.find((h) => h === profile.id);
+}
+const admitted = (host) => ({ host, measured: true, admitted: true, params: {} });
+const refused = (host, code, params = {}) => ({
+    host,
+    measured: true,
+    admitted: false,
+    code: `${host}.${code}`,
+    params,
+});
+const notInstalled = (host) => ({ host, measured: false, admitted: false, code: `${host}.not-installed`, params: {} });
+/** The verdict of a mod-host run: the first step that did not answer `resp 0` decides. */
+export function classifyModHostRun(run) {
+    if (!run.installed)
+        return notInstalled("mod-host");
+    for (const s of run.steps) {
+        if (s.died !== undefined) {
+            if (s.died.startsWith("SIG"))
+                return refused("mod-host", `signal-${s.died}`, { step: s.cmd });
+            return s.cmd === "add" ? refused("mod-host", "died-on-add", { how: s.died }) : refused("mod-host", "died", { step: s.cmd, how: s.died });
+        }
+        if (s.resp === undefined)
+            return refused("mod-host", "no-answer", { step: s.cmd });
+        // mod-host answers an error as a negative number (`resp -102`); the code carries its magnitude
+        if (s.resp < 0)
+            return refused("mod-host", `resp-${-s.resp}`, { step: s.cmd, resp: s.resp });
+    }
+    if (run.steps.length === 0)
+        return refused("mod-host", "no-answer");
+    return admitted("mod-host");
+}
+const UNKNOWN_PORT_TYPE = /Mandatory port "([^"]*)" has unknown type/;
+/** The verdict of a jalv run: alive at the deadline is hosted; a signal, an unknown port type, or an exit is not. */
+export function classifyJalvRun(run) {
+    if (!run.installed)
+        return notInstalled("jalv");
+    if (run.stillRunning)
+        return admitted("jalv");
+    if (run.signal !== null)
+        return refused("jalv", `signal-${run.signal}`);
+    const port = UNKNOWN_PORT_TYPE.exec(run.stderr)?.[1];
+    if (port !== undefined)
+        return refused("jalv", "unknown-port-type", { port });
+    if (run.status !== 0 && run.status !== null)
+        return refused("jalv", `exit-${run.status}`);
+    return admitted("jalv");
+}
+/** How long jalv must stay alive to count as hosting the plugin, in milliseconds. */
+export const JALV_HOSTED_MS = 3000;
+/** The wall clock of one whole mod-host admission, in milliseconds. */
+export const MOD_HOST_ADMISSION_MS = 30000;
+const MOD_HOST_ADMIT = fileURLToPath(new URL("../tools/mod-host-admit.mjs", import.meta.url));
+/** The runs against the installed hosts. */
+export const SPAWNED_ADMISSIONS = {
+    modHost(uri) {
+        const r = spawnSync(process.execPath, [MOD_HOST_ADMIT, uri], { encoding: "utf8", timeout: MOD_HOST_ADMISSION_MS });
+        if (r.error !== undefined || r.status !== 0) {
+            throw new Error(`mod-host admission of ${uri} gave no answer (${r.error?.message ?? `exit ${String(r.status)}`}): ${(r.stderr ?? "").trim()}`);
+        }
+        return JSON.parse(r.stdout);
+    },
+    jalv(uri) {
+        const r = spawnSync("jalv", ["-n", "plugin-qualify", uri], { encoding: "utf8", timeout: JALV_HOSTED_MS, input: "" });
+        const code = r.error?.code;
+        if (code === "ENOENT")
+            return { installed: false, stillRunning: false, status: null, signal: null, stderr: "" };
+        return { installed: true, stillRunning: code === "ETIMEDOUT", status: r.status, signal: code === "ETIMEDOUT" ? null : r.signal, stderr: r.stderr ?? "" };
+    },
+};
+/** One admission of `uri` under `host`. */
+export function admitPlugin(host, uri, runs = SPAWNED_ADMISSIONS) {
+    try {
+        return host === "mod-host" ? classifyModHostRun(runs.modHost(uri)) : classifyJalvRun(runs.jalv(uri));
+    }
+    catch (e) {
+        // the run itself broke: nothing was learned about the plugin, so nothing is rated
+        return { host, measured: false, admitted: false, code: `${host}.admission-failed`, params: { problem: e instanceof Error ? e.message : String(e) } };
+    }
+}
+//# sourceMappingURL=host-admission.js.map

package/dist/host-admission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-admission.js","sourceRoot":"","sources":["../src/host-admission.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD;;;;;;;GAOG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC,0DAA0D;AAC1D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,MAAM,CAAU,CAAC;AAG5D,qGAAqG;AACrG,MAAM,UAAU,cAAc,CAAC,OAAoB;IACjD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC;AACtD,CAAC;AAaD,MAAM,QAAQ,GAAG,CAAC,IAAkB,EAAiB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;AAC/G,MAAM,OAAO,GAAG,CAAC,IAAkB,EAAE,IAAY,EAAE,SAAkC,EAAE,EAAiB,EAAE,CAAC,CAAC;IAC1G,IAAI;IACJ,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,KAAK;IACf,IAAI,EAAE,GAAG,IAAI,IAAI,IAAI,EAAE;IACvB,MAAM;CACP,CAAC,CAAC;AACH,MAAM,YAAY,GAAG,CAAC,IAAkB,EAAiB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,gBAAgB,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;AAgBpJ,0FAA0F;AAC1F,MAAM,UAAU,kBAAkB,CAAC,GAAe;IAChD,IAAI,CAAC,GAAG,CAAC,SAAS;QAAE,OAAO,YAAY,CAAC,UAAU,CAAC,CAAC;IACpD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;gBAAE,OAAO,OAAO,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YAC9F,OAAO,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3I,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,UAAU,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACnF,+FAA+F;QAC/F,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC;YAAE,OAAO,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACpE,OAAO,QAAQ,CAAC,UAAU,CAAC,CAAC;AAC9B,CAAC;AAYD,MAAM,iBAAiB,GAAG,2CAA2C,CAAC;AAEtE,qHAAqH;AACrH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,CAAC,GAAG,CAAC,SAAS;QAAE,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,GAAG,CAAC,YAAY;QAAE,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9C,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,MAAM,EAAE,mBAAmB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9E,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,OAAO,CAAC,MAAM,EAAE,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1F,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AACnC,uEAAuE;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAO3C,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,6BAA6B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE9F,4CAA4C;AAC5C,MAAM,CAAC,MAAM,kBAAkB,GAAkB;IAC/C,OAAO,CAAC,GAAG;QACT,MAAM,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,cAAc,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;QACnH,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CAAC,yBAAyB,GAAG,oBAAoB,CAAC,CAAC,KAAK,EAAE,OAAO,IAAI,QAAQ,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACjJ,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAe,CAAC;IAC5C,CAAC;IACD,IAAI,CAAC,GAAG;QACN,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACrH,MAAM,IAAI,GAAI,CAAC,CAAC,KAA2C,EAAE,IAAI,CAAC;QAClE,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAChH,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,KAAK,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;IAC3J,CAAC;CACF,CAAC;AAEF,2CAA2C;AAC3C,MAAM,UAAU,WAAW,CAAC,IAAkB,EAAE,GAAW,EAAE,OAAsB,kBAAkB;IACnG,IAAI,CAAC;QACH,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACvG,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,kFAAkF;QAClF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,mBAAmB,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACvJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -23,3 +23,9 @@ export * from "./probe-judge.js";
 export * from "./qualification-record.js";
 export * from "./probe-runner.js";
 export * from "./judge-cli.js";
+export * from "./whole-file.js";
+export * from "./qualify-sync.js";
+export * from "./host-admission.js";
+export * from "./history-file.js";
+export * from "./history-adjust.js";
+export * from "./adjust-cli.js";

package/dist/index.js

@@ -25,4 +25,10 @@ export * from "./probe-judge.js";
 export * from "./qualification-record.js";
 export * from "./probe-runner.js";
 export * from "./judge-cli.js";
+export * from "./whole-file.js";
+export * from "./qualify-sync.js";
+export * from "./host-admission.js";
+export * from "./history-file.js";
+export * from "./history-adjust.js";
+export * from "./adjust-cli.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD;;;GAGG;AACH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD;;;GAGG;AACH,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}

package/dist/lv2-loader.d.ts

@@ -1,5 +1,18 @@
 import type { PluginLoader } from "./loader.js";
-/** The plugins a bundle manifest declares: one statement per subject, `;`-separated predicates. */
+/** A plugin a manifest declares, with the files it names for it, each relative to the bundle, in the order named. */
+export interface ManifestPlugin {
+    readonly uri: string;
+    readonly files: readonly string[];
+    /** The basename of its `lv2:binary`, when it names one. */
+    readonly binary?: string;
+}
+/**
+ * Every plugin a bundle manifest declares and the files it names for it with `lv2:binary` or `rdfs:seeAlso`: the
+ * files plugin-hostd's pin holds besides `manifest.ttl` itself. A file named outside the bundle (an absolute IRI) is
+ * not one of them.
+ */
+export declare function manifestPlugins(ttl: string): ManifestPlugin[];
+/** The plugins a bundle manifest declares, each with its `lv2:binary` basename. */
 export declare function pluginsInManifest(ttl: string): {
     uri: string;
     binary?: string;
@@ -7,6 +20,7 @@ export declare function pluginsInManifest(ttl: string): {
 export declare const lv2Loader: PluginLoader;
 /**
  * Every `.lv2` bundle directly under the LV2 search path (`LV2_PATH`, else lilv's defaults). An
- * absent directory holds none; any other fs error propagates for the caller to name.
+ * absent directory holds none; any other fs error propagates for the caller to name. A bundle is
+ * a directory holding `manifest.ttl`: a dangling `.lv2` symlink or a plain `.lv2` file is not one.
  */
 export declare function lv2BundlesOnPath(env: Readonly<Record<string, string | undefined>>, home?: string): string[];

package/dist/lv2-loader.js

@@ -6,28 +6,167 @@
  * plugin, with its `lv2:binary` basename. Anything else shaped like a URI (`scheme:rest`) is one
  * plugin. A path that does not exist is not this loader's — the CLI refuses it by name.
  *
- * The manifest read is the subset every LV2 bundle's manifest uses (subject, `a lv2:Plugin`,
- * `lv2:binary <x.so>`), not a Turtle parser; `--all` goes through lilv itself.
+ * The manifest is read as plugin-hostd reads it to pin a plugin: statements of IRIs and prefixed names, with blank
+ * nodes and collections stepped over, not a whole Turtle parser. A plugin is a subject typed `lv2:Plugin`; its files
+ * are the ones the manifest names for it with `lv2:binary` or `rdfs:seeAlso`.
  */
 import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, join, resolve } from "node:path";
 const URI_SHAPE = /^[A-Za-z][A-Za-z0-9+.-]*:\S+$/;
-/** The plugins a bundle manifest declares: one statement per subject, `;`-separated predicates. */
-export function pluginsInManifest(ttl) {
-    const body = ttl.replace(/#[^\n>]*$/gm, "");
+const RDF_TYPE = "http://www.w3.org/1999/02/22-rdf-syntax-ns#type";
+const LV2_PLUGIN = "http://lv2plug.in/ns/lv2core#Plugin";
+const LV2_BINARY = "http://lv2plug.in/ns/lv2core#binary";
+const RDFS_SEE_ALSO = "http://www.w3.org/2000/01/rdf-schema#seeAlso";
+/** The words of a Turtle text: IRIs, prefixed names, literals (with their tag or type) and punctuation; comments dropped. */
+function turtleTokens(ttl) {
     const out = [];
-    const statement = /<([^>]+)>\s+((?:[^.<"]|<[^>]*>|"[^"]*")*)\./g;
-    for (let m = statement.exec(body); m !== null; m = statement.exec(body)) {
-        const [, subject, predicates] = m;
-        if (subject === undefined || predicates === undefined)
+    let i = 0;
+    while (i < ttl.length) {
+        const c = ttl[i];
+        if (/\s/.test(c))
+            i++;
+        else if (c === "#")
+            while (i < ttl.length && ttl[i] !== "\n")
+                i++;
+        else if (c === "<") {
+            const end = ttl.indexOf(">", i);
+            if (end < 0)
+                break;
+            out.push({ kind: "iri", text: ttl.slice(i + 1, end) });
+            i = end + 1;
+        }
+        else if (c === '"' || c === "'") {
+            const quote = ttl.startsWith(c.repeat(3), i) ? c.repeat(3) : c;
+            let j = i + quote.length;
+            while (j < ttl.length && !ttl.startsWith(quote, j))
+                j += ttl[j] === "\\" ? 2 : 1;
+            i = j + quote.length;
+            // a language tag or a datatype belongs to the literal
+            if (ttl[i] === "@")
+                while (i < ttl.length && /[A-Za-z0-9-@]/.test(ttl[i]))
+                    i++;
+            else if (ttl.startsWith("^^", i)) {
+                i += 2;
+                if (ttl[i] === "<")
+                    i = ttl.indexOf(">", i) + 1;
+                else
+                    while (i < ttl.length && /[^\s;,.\])]/.test(ttl[i]))
+                        i++;
+            }
+            out.push({ kind: "literal", text: "" });
+        }
+        else if (".;,[]()".includes(c)) {
+            out.push({ kind: "punct", text: c });
+            i++;
+        }
+        else {
+            let j = i;
+            while (j < ttl.length && /[^\s<>"';,\[\]()]/.test(ttl[j]) && !(ttl[j] === "." && (j + 1 >= ttl.length || /\s/.test(ttl[j + 1]))))
+                j++;
+            out.push({ kind: "name", text: ttl.slice(i, j) });
+            i = Math.max(j, i + 1);
+        }
+    }
+    return out;
+}
+/**
+ * Every plugin a bundle manifest declares and the files it names for it with `lv2:binary` or `rdfs:seeAlso`: the
+ * files plugin-hostd's pin holds besides `manifest.ttl` itself. A file named outside the bundle (an absolute IRI) is
+ * not one of them.
+ */
+export function manifestPlugins(ttl) {
+    // the three vocabularies every manifest uses, so a manifest that leaves a prefix undeclared still reads
+    const prefixes = new Map([
+        ["lv2", "http://lv2plug.in/ns/lv2core#"],
+        ["rdfs", "http://www.w3.org/2000/01/rdf-schema#"],
+        ["rdf", "http://www.w3.org/1999/02/22-rdf-syntax-ns#"],
+    ]);
+    const subjects = new Map();
+    const expand = (t) => {
+        if (t.kind === "iri")
+            return t.text;
+        if (t.kind !== "name")
+            return undefined;
+        if (t.text === "a")
+            return RDF_TYPE;
+        const colon = t.text.indexOf(":");
+        const base = colon < 0 ? undefined : prefixes.get(t.text.slice(0, colon));
+        return base === undefined ? undefined : base + t.text.slice(colon + 1);
+    };
+    const tokens = turtleTokens(ttl);
+    let state = "subject";
+    let depth = 0;
+    let subject;
+    let predicate;
+    for (let k = 0; k < tokens.length; k++) {
+        const t = tokens[k];
+        if (t.kind === "name" && /^(@prefix|PREFIX)$/i.test(t.text) && state === "subject" && depth === 0) {
+            const name = tokens[k + 1]?.text ?? "";
+            const iri = tokens[k + 2];
+            if (iri?.kind === "iri")
+                prefixes.set(name.replace(/:$/, ""), iri.text);
+            k += t.text.startsWith("@") ? 3 : 2;
+            continue;
+        }
+        if (t.kind === "name" && /^(@base|BASE)$/i.test(t.text) && state === "subject" && depth === 0) {
+            k += t.text.startsWith("@") ? 2 : 1;
+            continue;
+        }
+        if (t.kind === "punct" && (t.text === "[" || t.text === "(")) {
+            if (depth++ === 0 && state === "subject")
+                subject = undefined;
             continue;
-        if (!/(^|;)\s*a\s+lv2:Plugin\b/.test(predicates))
+        }
+        if (t.kind === "punct" && (t.text === "]" || t.text === ")")) {
+            if (depth > 0 && --depth === 0)
+                state = state === "subject" ? "predicate" : "after";
+            continue;
+        }
+        if (depth > 0)
+            continue;
+        if (t.kind === "punct") {
+            if (t.text === ".")
+                state = "subject";
+            else if (t.text === ";")
+                state = "predicate";
+            else if (t.text === ",")
+                state = "object";
             continue;
-        const bin = /lv2:binary\s+<([^>]+)>/.exec(predicates)?.[1];
-        out.push(bin === undefined ? { uri: subject } : { uri: subject, binary: basename(bin) });
+        }
+        if (state === "subject") {
+            subject = expand(t);
+            state = "predicate";
+        }
+        else if (state === "predicate") {
+            predicate = expand(t);
+            state = "object";
+        }
+        else if (state === "object") {
+            state = "after";
+            if (subject === undefined)
+                continue;
+            const entry = subjects.get(subject) ?? { typed: false, files: [] };
+            subjects.set(subject, entry);
+            const object = expand(t);
+            if (predicate === RDF_TYPE && object === LV2_PLUGIN)
+                entry.typed = true;
+            if ((predicate === LV2_BINARY || predicate === RDFS_SEE_ALSO) && t.kind === "iri" && !/^[A-Za-z][A-Za-z0-9+.-]*:/.test(t.text) && !t.text.startsWith("/")) {
+                const file = t.text.replace(/^(\.\/)+/, "");
+                if (!entry.files.includes(file))
+                    entry.files.push(file);
+                if (predicate === LV2_BINARY && entry.binary === undefined)
+                    entry.binary = basename(file);
+            }
+        }
     }
-    return out;
+    return [...subjects.entries()]
+        .filter(([, e]) => e.typed)
+        .map(([uri, e]) => ({ uri, files: e.files, ...(e.binary === undefined ? {} : { binary: e.binary }) }));
+}
+/** The plugins a bundle manifest declares, each with its `lv2:binary` basename. */
+export function pluginsInManifest(ttl) {
+    return manifestPlugins(ttl).map((p) => (p.binary === undefined ? { uri: p.uri } : { uri: p.uri, binary: p.binary }));
 }
 export const lv2Loader = {
     format: "lv2",
@@ -52,7 +191,8 @@ export const lv2Loader = {
 const LV2_DEFAULT_DIRS = [".lv2", "/usr/lib/lv2", "/usr/lib64/lv2", "/usr/local/lib/lv2", "/usr/local/lib64/lv2"];
 /**
  * Every `.lv2` bundle directly under the LV2 search path (`LV2_PATH`, else lilv's defaults). An
- * absent directory holds none; any other fs error propagates for the caller to name.
+ * absent directory holds none; any other fs error propagates for the caller to name. A bundle is
+ * a directory holding `manifest.ttl`: a dangling `.lv2` symlink or a plain `.lv2` file is not one.
  */
 export function lv2BundlesOnPath(env, home = homedir()) {
     const named = (env["LV2_PATH"] ?? "").split(":").filter((d) => d !== "");
@@ -69,9 +209,20 @@ export function lv2BundlesOnPath(env, home = homedir()) {
                 continue;
             throw e;
         }
-        for (const n of names.sort())
-            if (n.endsWith(".lv2"))
-                bundles.push(join(dir, n));
+        for (const n of names.sort()) {
+            if (!n.endsWith(".lv2"))
+                continue;
+            const path = join(dir, n);
+            let isBundle;
+            try {
+                isBundle = statSync(path).isDirectory() && existsSync(join(path, "manifest.ttl"));
+            }
+            catch {
+                isBundle = false; // a dangling symlink
+            }
+            if (isBundle)
+                bundles.push(path);
+        }
     }
     return bundles;
 }

package/dist/lv2-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"lv2-loader.js","sourceRoot":"","sources":["../src/lv2-loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lv2-loader.js","sourceRoot":"","sources":["../src/lv2-loader.ts"],"names":[],"mappings":"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"}

package/dist/measurement/cli.d.ts

@@ -135,10 +135,12 @@ export interface HostingRunResult {
     readonly stdout: string;
 }
 /**
- * One plugin's run of the native measurer as the hosting sweep's JSONL line: the LAST line of its
- * stdout that is a JSON object (a plugin may print its own banner first), with the exit status
- * beside it, a death written as 128 + its signal and a timeout as 124. A run that printed no line
- * is `crashed`, its exit kept: what that exit means is the reader's (`sweep-jsonl.ts`) to say.
+ * One plugin's run of the native measurer as the hosting sweep's JSONL line: its stdout's JSON
+ * record ({@link extractJsonRecord}, which repairs a plugin's banner printed into the middle of
+ * the line), with the exit status beside it, a death written as 128 + its signal and a timeout
+ * as 124. A run whose stdout had a `{`-leading line that never repaired is `parseError`; one
+ * with no such line at all is `crashed`. Either way the exit is kept: what it means is the
+ * reader's (`sweep-jsonl.ts`) to say.
  */
 export declare function hostingLine(uri: string, run: HostingRunResult): Record<string, unknown>;
 /** A parsed command line, or the reason it could not be parsed. */