@openmixer/plugin-qualify 0.17.5 → 0.18.1

package/dist/qualify-adapter-pass.js

@@ -0,0 +1,255 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * `plugin-qualify-sync --adapter-only`: an LV2 plugin's verdict on omx-clap-host is decided by its run under plugin-hostd's
+ * LV2 adapter, and a record without one owes it (`qualify-rejudge.ts`). This pass makes only that run, for each plugin, at
+ * each cell a Pi runs, and puts the block in the record; every other figure stays as it was, and `--rejudge` reads it.
+ *
+ * Each cell has a private JACK server of its own (`jackd -d dummy`, the rate and quantum on its command line), so that the
+ * run can never reach the device's live server (plugin-qualify#187), and each run a fresh host, its time limited by
+ * `budget_s` a command and its address space by the limit of a direct spawn. A crash or a timeout is the plugin's recorded
+ * outcome. A pass does not start without the versions of the hosts it runs, or without a private server: nothing it could
+ * write would say what it measured. A plugin is finished when its block was taken at these host versions at every cell,
+ * so a pass cut short can be run again; a host that could not be run decides nothing, and that plugin is tried again.
+ */
+import { spawn, spawnSync } from "node:child_process";
+import { existsSync, mkdtempSync, readFileSync, readdirSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { basename, join } from "node:path";
+import { ADAPTER_HOST, SPAWNED_ADMISSIONS, admitUnderAdapter } from "./host-admission.js";
+import { HOSTD_ENV } from "./hostd-pin-files.js";
+import { cellKey } from "./measurement-grid.js";
+import { defaultAddressSpaceLimit } from "./direct-limit.js";
+import { PROBE_OK } from "./probe-output.js";
+import { QUALIFICATION_RECORD_SCHEMA } from "./qualification-record.js";
+import { ADMIT_ADDRESS_KB_ENV, ADMIT_STATE_DIR_ENV, ADMIT_STEP_MS_ENV, PI_CELLS } from "./qualify-declarations.js";
+import { digestFiles } from "./qualify-sync.js";
+import { writeFileWhole } from "./whole-file.js";
+/** The cells the pass runs at: the ones a Pi runs. */
+export const ADAPTER_PASS_CELLS = PI_CELLS;
+/** The code of a cell no private server could be had for: the run did not happen. */
+export const NO_PRIVATE_SERVER = `${ADAPTER_HOST}.no-private-server`;
+const RECORD_SUFFIX = ".qualification.json";
+const SERVER_WAIT_MS = 5000;
+const SERVER_SETTLE_MS = 300;
+const SERVER_STOP_MS = 2000;
+/** What a program answers to `--version`: its last word on the line that says `version`. */
+export function parseVersion(text) {
+    return /version:?\s+(\S+)/.exec(text)?.[1];
+}
+const spawnVersion = (tool) => {
+    const r = spawnSync(tool, ["--version"], { encoding: "utf8", timeout: 10000, killSignal: "SIGKILL" });
+    return { status: r.status, stdout: `${r.stdout ?? ""}\n${r.stderr ?? ""}` };
+};
+/** The versions of the hosts as installed now, or which of them could not say. */
+export function hostVersions(env, run = spawnVersion) {
+    const versions = {};
+    for (const [name, tool] of [[ADAPTER_HOST, ADAPTER_HOST], ["plugin-hostd", env[HOSTD_ENV] ?? "plugin-hostd"]]) {
+        const r = run(tool);
+        const version = r.status === 0 ? parseVersion(r.stdout) : undefined;
+        if (version === undefined)
+            return { ok: false, error: `${tool} --version names no version, so a run could not say which host it was under` };
+        versions[name] = version;
+    }
+    return { ok: true, versions };
+}
+const sleepSync = (ms) => {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+};
+/** `jackd` on a name of its own and the dummy driver, at the cell's rate and quantum; `undefined` when none came up. */
+export const startPrivateJack = (cell) => {
+    const name = `omx-qualify-${String(process.pid)}-${String(cell.quantum)}`;
+    let child;
+    let ended = false;
+    try {
+        child = spawn("jackd", ["-r", "-n", name, "-d", "dummy", "-r", String(cell.rate), "-p", String(cell.quantum)], { stdio: "ignore", detached: true });
+    }
+    catch {
+        return undefined;
+    }
+    child.on("error", () => (ended = true));
+    child.on("exit", () => (ended = true));
+    child.unref();
+    const running = () => {
+        if (ended || child.pid === undefined)
+            return false;
+        // the exit event needs the loop this synchronous pass holds: the process table says
+        return existsSync(`/proc/${String(child.pid)}`) && !/^\S+ \(.*\) Z/.test(readStat(child.pid));
+    };
+    // a TERM first: jackd frees the shared memory it holds under /dev/shm itself, which a KILL would leave behind for good
+    const signal = (sig) => {
+        try {
+            if (child.pid !== undefined)
+                process.kill(-child.pid, sig);
+        }
+        catch {
+            // already gone
+        }
+    };
+    const stop = () => {
+        signal("SIGTERM");
+        const until = Date.now() + SERVER_STOP_MS;
+        while (running() && Date.now() < until)
+            sleepSync(20);
+        if (running())
+            signal("SIGKILL");
+        for (const d of serverDirs(name))
+            rmSync(d, { recursive: true, force: true });
+    };
+    const until = Date.now() + SERVER_WAIT_MS;
+    while (Date.now() < until) {
+        if (child.pid === undefined || !running()) {
+            stop();
+            return undefined;
+        }
+        if (serverDirs(name).length > 0) {
+            sleepSync(SERVER_SETTLE_MS);
+            return { name, alive: running, stop };
+        }
+        sleepSync(50);
+    }
+    stop();
+    return undefined;
+};
+const readStat = (pid) => {
+    try {
+        return readFileSync(`/proc/${String(pid)}/stat`, "utf8");
+    }
+    catch {
+        return "";
+    }
+};
+/** Where jackd keeps a server's sockets, and its semaphores: the socket appears as the server opens it. */
+function serverDirs(name) {
+    try {
+        return readdirSync("/dev/shm").filter((d) => d.startsWith(`jack_${name}_`) || new RegExp(`^jack_sem\\.\\d+_${name}_`).test(d)).map((d) => join("/dev/shm", d));
+    }
+    catch {
+        return [];
+    }
+}
+/** Whether a machine can give a pass its private server at all: the program is there. */
+function jackdInstalled(env) {
+    return (env["PATH"] ?? process.env["PATH"] ?? "").split(":").some((d) => d !== "" && existsSync(join(d, "jackd")));
+}
+// --- the block --------------------------------------------------------------------------------------------------------
+/**
+ * The runs of every cell as one block. Its top is what the judge reads: a refusal or a crash at any cell decides, with the
+ * cell it happened at, whatever the others say; then a cell where the host could not be run leaves it not measured, so
+ * still owed; only every cell admitted is admitted. Pure.
+ */
+export function adapterBlockOf(runs, versions, measuredAt) {
+    const cells = runs.map(({ cell, run }) => ({ rate: cell.rate, quantum: cell.quantum, measured: run.measured, admitted: run.admitted, ...(run.code === undefined ? {} : { code: run.code }), params: run.params }));
+    const worst = cells.find((c) => c.measured && !c.admitted) ?? cells.find((c) => !c.measured);
+    const top = worst === undefined
+        ? { measured: true, admitted: true, params: {} }
+        : { measured: worst.measured, admitted: false, ...(worst.code === undefined ? {} : { code: worst.code }), params: { ...worst.params, rate: worst.rate, quantum: worst.quantum } };
+    return { host: ADAPTER_HOST, ...top, versions, measuredAt, cells };
+}
+/** The record with the block, and every other byte of it as it was. Pure. */
+export const mergeAdapterRun = (record, block) => ({ ...record, adapter: block });
+/** Whether a record's adapter run is done: at these host versions, measured, at every cell. */
+export function adapterFinished(record, versions, cells = ADAPTER_PASS_CELLS) {
+    const a = record.adapter;
+    if (a === undefined || !a.measured || a.versions === undefined || a.cells === undefined)
+        return false;
+    const same = Object.keys(versions).length === Object.keys(a.versions).length && Object.entries(versions).every(([k, v]) => a.versions[k] === v);
+    return same && cells.every((c) => a.cells.some((x) => cellKey(x) === cellKey(c)));
+}
+/** The pass could not start: nothing was run and nothing written. */
+export class AdapterPassRefused extends Error {
+}
+const readRecord = (path) => {
+    try {
+        const r = JSON.parse(readFileSync(path, "utf8"));
+        return r.schema === QUALIFICATION_RECORD_SCHEMA ? r : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * The run of each LV2 plugin of the state whose probe ended well (one that did not has no verdict a run could decide), at
+ * each cell. Each record is written whole as its plugin ends.
+ */
+export function adapterPass(ctx, state, options = {}) {
+    const read = hostVersions(ctx.env, options.versions);
+    if (!read.ok)
+        throw new AdapterPassRefused(read.error);
+    if (!(options.jackdPresent ?? jackdInstalled(ctx.env)))
+        throw new AdapterPassRefused(`no jackd on the path: ${NO_PRIVATE_SERVER}, and the device's own JACK server is never used for this`);
+    const { versions } = read;
+    const starter = options.jack ?? startPrivateJack;
+    const runs = options.runs ?? SPAWNED_ADMISSIONS;
+    const now = options.now ?? (() => new Date().toISOString());
+    const servers = new Map();
+    const serverFor = (cell) => {
+        const key = cellKey(cell);
+        const had = servers.get(key);
+        if (had?.alive() === true)
+            return had;
+        had?.stop();
+        servers.delete(key);
+        const fresh = starter(cell);
+        if (fresh !== undefined)
+            servers.set(key, fresh);
+        return fresh;
+    };
+    const count = { measured: 0, already: 0, failed: 0 };
+    const limit = { [ADMIT_STEP_MS_ENV]: String(ctx.settings.budgetS * 1000), [ADMIT_ADDRESS_KB_ENV]: String(Math.ceil(defaultAddressSpaceLimit() / 2 ** 10)) };
+    try {
+        for (const [key, entry] of Object.entries(state.entries)) {
+            if (entry.format !== "lv2")
+                continue;
+            const files = digestFiles(entry.root, entry.files.map((f) => f.path), entry.files);
+            if (files === undefined || !files.every((f) => entry.files.some((x) => x.path === f.path && x.sha256 === f.sha256))) {
+                ctx.log(`${key}: its files changed since it was measured; the sync measures it whole`);
+                continue;
+            }
+            for (const plugin of entry.plugins) {
+                if (plugin.record === undefined || !plugin.record.endsWith(RECORD_SUFFIX))
+                    continue;
+                const path = join(ctx.settings.qualificationDir, basename(plugin.record));
+                const record = readRecord(path);
+                if (record === undefined) {
+                    ctx.log(`${plugin.uri}: its record does not read; no adapter run`);
+                    count.failed++;
+                    continue;
+                }
+                if (record.probe.outcome !== PROBE_OK)
+                    continue;
+                if (options.force !== true && adapterFinished(record, versions)) {
+                    count.already++;
+                    continue;
+                }
+                const started = Date.now();
+                const done = ADAPTER_PASS_CELLS.map((cell) => {
+                    const server = serverFor(cell);
+                    if (server === undefined)
+                        return { cell, run: { host: ADAPTER_HOST, measured: false, admitted: false, code: NO_PRIVATE_SERVER, params: {} } };
+                    const stateDir = mkdtempSync(join(tmpdir(), "plugin-qualify-adapter-state-"));
+                    try {
+                        const env = { ...ctx.env, ...limit, [ADMIT_STATE_DIR_ENV]: stateDir, LV2_PATH: ctx.settings.lv2Dirs.join(":"), JACK_DEFAULT_SERVER: server.name, JACK_NO_START_SERVER: "1" };
+                        return { cell, run: admitUnderAdapter(record.plugin.id, runs, env) ?? { host: ADAPTER_HOST, measured: false, admitted: false, code: `${ADAPTER_HOST}.admission-failed`, params: {} } };
+                    }
+                    finally {
+                        rmSync(stateDir, { recursive: true, force: true });
+                    }
+                });
+                const block = adapterBlockOf(done, versions, now());
+                writeFileWhole(path, `${JSON.stringify(mergeAdapterRun(record, block), null, 2)}\n`);
+                if (block.measured)
+                    count.measured++;
+                else
+                    count.failed++;
+                ctx.log(`${plugin.uri}: adapter ${block.measured ? (block.admitted ? "admitted" : `refused (${block.code ?? ""})`) : `not run (${block.code ?? ""})`} in ${((Date.now() - started) / 1000).toFixed(1)} s`);
+            }
+        }
+    }
+    finally {
+        for (const s of servers.values())
+            s.stop();
+    }
+    return { ...count, versions };
+}
+//# sourceMappingURL=qualify-adapter-pass.js.map

package/dist/qualify-adapter-pass.js.map

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

package/dist/qualify-declarations.d.ts

@@ -118,8 +118,30 @@ export declare const GRID_CONTINUITY_QUANTUM = 512;
  * same two (src/memory-bound.test.ts holds them together).
  */
 export declare const MEMORY_LIMIT_RAM_FRACTION = 0.5;
+/**
+ * The address space (`RLIMIT_AS`) of a process plugin-qualify spawns directly, with no runner to give it a cgroup: all the
+ * machine's RAM. Address space is what a plugin reserves, not what it touches, so this is the far bound of a direct
+ * run, not its budget. Off for a sanitizer build, which reserves far more address space than it uses.
+ */
+export declare const ADDRESS_SPACE_LIMIT_RAM_FRACTION = 1;
 export declare const MEMORY_BOUND_EXIT_ENV = "OMX_RT_OOM_EXIT";
 export declare const MEMORY_BOUND_EXIT_STATUS = 121;
+/**
+ * The memory-only pass (`plugin-qualify-sync --memory-only`). With `PROBE_MEMORY_ONLY_ENV` set the probers take the
+ * footprint and nothing else; the probe runner passes its environment on, so its limits hold unchanged.
+ * `PROBE_NOTES_ENV` is the count of notes an instrument that declares no voice capacity holds, basis `probe`:
+ * `MEMORY_PASS_PROBE_NOTES` unless `memory_notes` says otherwise.
+ */
+export declare const PROBE_MEMORY_ONLY_ENV = "OMX_PROBE_MEMORY_ONLY";
+export declare const PROBE_NOTES_ENV = "OMX_PROBE_NOTES";
+export declare const MEMORY_PASS_PROBE_NOTES = 16;
+/**
+ * What `tools/mod-host-admit.mjs` is told in an adapter-only pass: how long the host has for one command, its address
+ * space (`ulimit -v`, in KB) and the directory for the state files of the plugin it loads.
+ */
+export declare const ADMIT_STEP_MS_ENV = "OMX_ADMIT_STEP_MS";
+export declare const ADMIT_ADDRESS_KB_ENV = "OMX_ADMIT_ADDRESS_KB";
+export declare const ADMIT_STATE_DIR_ENV = "OMX_ADMIT_STATE_DIR";
 /** Seconds one `.clap` may take to qualify at every rate before the prober is killed. */
 export declare const CLAP_QUALIFY_TIMEOUT_S = 120;
 /**
@@ -167,10 +189,16 @@ export declare const DESCRIPTOR_CODE_BINARY_UNHASHED = "qualify.descriptor.binar
 export declare const DESCRIPTOR_CODE_DIR_UNWRITABLE = "qualify.descriptor.dir-unwritable";
 /** Every threshold, so none is baked into the code. */
 export interface HostingPolicy {
-    /** Minimum instantiate/destroy lifecycles. The operator's §14.4 ruling: 1000. */
+    /** Minimum instantiate/destroy lifecycles. §14.4 sets it: 1000. */
     readonly cycleFloor: number;
     /** Minimum continuous soak, seconds. Default 3 h — the operator's longest show. */
     readonly soakSeconds: number;
+    /**
+     * The memory growth a soak may show past warm-up, in KB per minute of audio. 10 MB/min ships provisional and is
+     * tightened from measurements; a verdict that rests on it says so.
+     */
+    readonly memoryGrowthKbPerMinCeiling: number;
+    readonly memoryGrowthCeilingProvisional: boolean;
     /** Above this ratio a plugin is spiky: in-process a spike is the whole desk's xrun. */
     readonly costTailRatioCeiling: number;
     /** A soak rate whose settled output sits this far under the plugin's own best rate is
@@ -180,7 +208,7 @@ export interface HostingPolicy {
     readonly hostProvenance?: string;
 }
 /**
- * Defaults. The cycle floor is the operator's ruling of 2026-09-05 (§14.4, option c) and the
+ * Defaults. The cycle floor is the decision of 2026-09-05 (§14.4, option c) and the
  * soak is §3's default show length. The per-instance cost ceiling is the HOST's budget and
  * lives in {@link HOST_BUDGETS} (plugin-qualify §3a), not here.
  */
@@ -190,19 +218,23 @@ export declare const DEFAULT_HOSTING_POLICY: HostingPolicy;
 import type { HostBudget } from "./measurement/format.js";
 export type { HostBudget };
 /**
- * Each shipped host profile's budget, by profile id. `openmixer-console` is §14.2's 5 % per
- * instance at the rig's rate and buffer. `mod-host` runs a whole pedalboard on one JACK thread,
- * so it gets the same per-instance share, at 48 kHz / 128 frames. `jalv` gives each plugin its own
- * process and client, so a quarter core per instance, at 48 kHz / 256 frames. The last two are
- * declared defaults, not a measurement of anyone's board — a project brings its own profile file.
- * `omx-clap-host` runs its plugins one JACK client each, called in turn on the server's one cycle,
- * so it gets mod-host's share and pair.
+ * The cells a Raspberry Pi runs: zynthian-sys's JACK settings, 48000/128 on a Pi 5 with the V5 kit and 48000/256 on a Pi 4 and
+ * the other kits, the one a Pi 5 with no kit card also ran its stress and first boot at. The Zynthian benchmark's matrix sweeps
+ * more cells; these two are what a Pi is set to.
  */
+export declare const PI_CELLS: {
+    rate: number;
+    quantum: number;
+}[];
 export declare const HOST_BUDGETS: {
     readonly "openmixer-console": {
         readonly coreFractionCeiling: 0.05;
         readonly rate: 96000;
         readonly quantum: 1024;
+        readonly memory: {
+            perInstanceKb: number;
+            perConsoleKb: number;
+        };
     };
     readonly jalv: {
         readonly coreFractionCeiling: 0.25;
@@ -219,4 +251,16 @@ export declare const HOST_BUDGETS: {
         readonly rate: 48000;
         readonly quantum: 128;
     };
+    readonly "openmixer-pi-4gb": {
+        readonly coreFractionCeiling: 0.05;
+        readonly rate: 48000;
+        readonly quantum: 128;
+        readonly memory: import("./measurement/format.js").HostMemoryBudget;
+    };
+    readonly "openmixer-pi-8gb": {
+        readonly coreFractionCeiling: 0.05;
+        readonly rate: 48000;
+        readonly quantum: 128;
+        readonly memory: import("./measurement/format.js").HostMemoryBudget;
+    };
 };

package/dist/qualify-declarations.js

@@ -123,8 +123,30 @@ export const GRID_CONTINUITY_QUANTUM = CLAP_SWEEP_FRAMES;
  * same two (src/memory-bound.test.ts holds them together).
  */
 export const MEMORY_LIMIT_RAM_FRACTION = 0.5;
+/**
+ * The address space (`RLIMIT_AS`) of a process plugin-qualify spawns directly, with no runner to give it a cgroup: all the
+ * machine's RAM. Address space is what a plugin reserves, not what it touches, so this is the far bound of a direct
+ * run, not its budget. Off for a sanitizer build, which reserves far more address space than it uses.
+ */
+export const ADDRESS_SPACE_LIMIT_RAM_FRACTION = 1;
 export const MEMORY_BOUND_EXIT_ENV = "OMX_RT_OOM_EXIT";
 export const MEMORY_BOUND_EXIT_STATUS = 121;
+/**
+ * The memory-only pass (`plugin-qualify-sync --memory-only`). With `PROBE_MEMORY_ONLY_ENV` set the probers take the
+ * footprint and nothing else; the probe runner passes its environment on, so its limits hold unchanged.
+ * `PROBE_NOTES_ENV` is the count of notes an instrument that declares no voice capacity holds, basis `probe`:
+ * `MEMORY_PASS_PROBE_NOTES` unless `memory_notes` says otherwise.
+ */
+export const PROBE_MEMORY_ONLY_ENV = "OMX_PROBE_MEMORY_ONLY";
+export const PROBE_NOTES_ENV = "OMX_PROBE_NOTES";
+export const MEMORY_PASS_PROBE_NOTES = 16;
+/**
+ * What `tools/mod-host-admit.mjs` is told in an adapter-only pass: how long the host has for one command, its address
+ * space (`ulimit -v`, in KB) and the directory for the state files of the plugin it loads.
+ */
+export const ADMIT_STEP_MS_ENV = "OMX_ADMIT_STEP_MS";
+export const ADMIT_ADDRESS_KB_ENV = "OMX_ADMIT_ADDRESS_KB";
+export const ADMIT_STATE_DIR_ENV = "OMX_ADMIT_STATE_DIR";
 /** Seconds one `.clap` may take to qualify at every rate before the prober is killed. */
 export const CLAP_QUALIFY_TIMEOUT_S = 120;
 /**
@@ -171,7 +193,7 @@ export const DESCRIPTOR_CODE_SCHEMA_FLOOR = "qualify.descriptor.schema-floor";
 export const DESCRIPTOR_CODE_BINARY_UNHASHED = "qualify.descriptor.binary-unhashed";
 export const DESCRIPTOR_CODE_DIR_UNWRITABLE = "qualify.descriptor.dir-unwritable";
 /**
- * Defaults. The cycle floor is the operator's ruling of 2026-09-05 (§14.4, option c) and the
+ * Defaults. The cycle floor is the decision of 2026-09-05 (§14.4, option c) and the
  * soak is §3's default show length. The per-instance cost ceiling is the HOST's budget and
  * lives in {@link HOST_BUDGETS} (plugin-qualify §3a), not here.
  */
@@ -180,6 +202,8 @@ export const DEFAULT_HOSTING_POLICY = {
     soakSeconds: 3 * 60 * 60,
     costTailRatioCeiling: 4,
     soakDeadDropDb: 40,
+    memoryGrowthKbPerMinCeiling: 10240,
+    memoryGrowthCeilingProvisional: true,
 };
 /**
  * Each shipped host profile's budget, by profile id. `openmixer-console` is §14.2's 5 % per
@@ -190,10 +214,38 @@ export const DEFAULT_HOSTING_POLICY = {
  * `omx-clap-host` runs its plugins one JACK client each, called in turn on the server's one cycle,
  * so it gets mod-host's share and pair.
  */
+const GIB_KB = 1024 * 1024;
+/**
+ * The desk's memory budget: half of its 30 GiB for the plugins of a console, the rest the engine's and the system's;
+ * one instance's share is what the probe bounds a run by, 4 GiB.
+ */
+const DESK_MEMORY = { perInstanceKb: 4 * GIB_KB, perConsoleKb: 16 * GIB_KB };
+/**
+ * What a Raspberry Pi gives its plugins' memory, by the board's RAM: all but 1 GiB for the system and Zynthian's own
+ * UI, and an instance's share an eighth of that. Provisional until measured on a Pi: the stress runs show a 4 GiB Pi 5 stopping
+ * at 400 MB free, and no plugin's footprint has been read there yet.
+ */
+const piMemory = (ramGib) => ({
+    perInstanceKb: ((ramGib - 1) * GIB_KB) / 8,
+    perConsoleKb: (ramGib - 1) * GIB_KB,
+    provisional: true,
+    cells: PI_CELLS,
+});
+/**
+ * The cells a Raspberry Pi runs: zynthian-sys's JACK settings, 48000/128 on a Pi 5 with the V5 kit and 48000/256 on a Pi 4 and
+ * the other kits, the one a Pi 5 with no kit card also ran its stress and first boot at. The Zynthian benchmark's matrix sweeps
+ * more cells; these two are what a Pi is set to.
+ */
+export const PI_CELLS = [
+    { rate: MEASURE_BASE_RATE, quantum: 128 },
+    { rate: MEASURE_BASE_RATE, quantum: 256 },
+];
 export const HOST_BUDGETS = {
-    "openmixer-console": { coreFractionCeiling: 0.05, rate: COST_REFERENCE_RATE, quantum: QUANTUM_FRAMES },
+    "openmixer-console": { coreFractionCeiling: 0.05, rate: COST_REFERENCE_RATE, quantum: QUANTUM_FRAMES, memory: DESK_MEMORY },
     jalv: { coreFractionCeiling: 0.25, rate: MEASURE_BASE_RATE, quantum: 256 },
     "mod-host": { coreFractionCeiling: 0.05, rate: MEASURE_BASE_RATE, quantum: 128 },
     "omx-clap-host": { coreFractionCeiling: 0.05, rate: MEASURE_BASE_RATE, quantum: 128 },
+    "openmixer-pi-4gb": { coreFractionCeiling: 0.05, rate: MEASURE_BASE_RATE, quantum: 128, memory: piMemory(4) },
+    "openmixer-pi-8gb": { coreFractionCeiling: 0.05, rate: MEASURE_BASE_RATE, quantum: 128, memory: piMemory(8) },
 };
 //# sourceMappingURL=qualify-declarations.js.map

package/dist/qualify-declarations.js.map

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

package/dist/qualify-rejudge.d.ts

@@ -0,0 +1,81 @@
+import { type GridCell } from "./measurement-grid.js";
+import { type ProbeOutput } from "./probe-output.js";
+import { type ProbeRun } from "./probe-runner.js";
+import { type NotMeasured, type OwedMeasurement, type QualificationRecord } from "./qualification-record.js";
+import { type SyncContext, type SyncState } from "./qualify-sync.js";
+/** The codes of a measurement a record owes. */
+export declare const OWED_CODE: {
+    /** An LV2 verdict of a host that runs it through the adapter, and no measured adapter run. */
+    readonly adapterRun: "qualify.sync.adapter-run-owed";
+    /** A verdict decided by a run under its host (mod-host, jalv), and no run in the record. */
+    readonly hostRun: "qualify.sync.host-run-owed";
+    /** The plugin's files are not the bytes the record measured. */
+    readonly bytesChanged: "qualify.sync.bytes-changed";
+    /** The probe output is missing, is not the copy the record names, or does not read. */
+    readonly figuresUnreadable: "qualify.sync.figures-unreadable";
+    /** The plugin has a record that holds no figures at all. */
+    readonly noFigures: "qualify.sync.no-figures";
+};
+/** The cells the memory-only pass measures: the ones a Pi runs, 48 kHz at 128 and 256 frames. */
+export declare const MEMORY_PASS_CELLS: readonly GridCell[];
+/** What a memory-only pass cannot say, in every record it writes to: growth over time needs a soak. */
+export declare const MEMORY_PASS_NOT_MEASURED: NotMeasured;
+/** The tool as the record says it: this package's own version, read where it is installed. */
+export declare function rejudgeToolName(): string;
+/** A world holding one bundle, as plugin-hostd runs a pinned LV2 plugin, for as long as `body` runs. */
+export declare function lv2World<T>(bundle: string, body: (world: string) => T): T;
+export declare class RejudgeRefusal extends Error {
+}
+/**
+ * One record judged again from its probe output, with what it owes. The figures, who took them and when are as they were;
+ * only the verdicts, the tiers and the cost reasons beside them are new. `at` is the prior re-judge's when nothing else
+ * differs, so that a second run leaves the file alone.
+ */
+export declare function rejudgeRecord(record: QualificationRecord, probeBytes: Uint8Array, options: {
+    readonly host: string;
+    readonly by: string;
+    readonly at: string;
+}): {
+    record: QualificationRecord;
+    owes: readonly OwedMeasurement[];
+};
+/** The file that lists what a re-judge left owing, beside the state file. */
+export declare const owedFile: (stateFile: string) => string;
+export declare const OWED_SCHEMA = "plugin-qualify.owed/1";
+export interface OwingRecord {
+    readonly plugin: string;
+    /** The record's file name, when the plugin has one. */
+    readonly record?: string;
+    readonly owes: readonly OwedMeasurement[];
+}
+export interface RejudgeResult {
+    readonly state: SyncState;
+    readonly changed: number;
+    readonly unchanged: number;
+    readonly owing: readonly OwingRecord[];
+}
+/**
+ * Every record of the device's qualification directory judged again, the state's outcomes and pin words brought into line,
+ * and the list of what is owed written beside the state file. Each file is written whole, and only when it differs.
+ */
+export declare function rejudgeState(ctx: SyncContext, state: SyncState, now?: () => string): RejudgeResult;
+/**
+ * A memory-only run's footprints in a record: the `memory` of each cell and nothing else of it, a cell the record's grid
+ * does not hold joined with no other figure. A cell the run could not read says why instead of a figure, so that it is
+ * never read as fitting. Pure.
+ */
+export declare function mergeMemoryRun(record: QualificationRecord, output: ProbeOutput, cells: readonly GridCell[]): QualificationRecord;
+export interface MemoryPassResult {
+    readonly measured: number;
+    readonly already: number;
+    readonly failed: number;
+}
+/**
+ * The footprint of each plugin of the state, at `MEMORY_PASS_CELLS`, merged into the record its verdict for this run's host
+ * came from. One plugin's failure is that plugin's; each record is written whole as its plugin ends, so a pass cut short
+ * keeps what it finished, and a pass run again skips those unless `force`.
+ */
+export declare function memoryPass(ctx: SyncContext, state: SyncState, options?: {
+    readonly force?: boolean;
+    readonly run?: ProbeRun;
+}): MemoryPassResult;