@openmixer/plugin-qualify 0.18.0 → 0.18.2

package/dist/qualify-isolated.d.ts

@@ -0,0 +1,70 @@
+import { type JackStarter } from "./qualify-adapter-pass.js";
+import type { GridCell } from "./measurement-grid.js";
+import type { PinEntry } from "./pins-file.js";
+import type { QualificationRecord, RunStep } from "./qualification-record.js";
+/** The steps of a pass, in the order they run. */
+export declare const RUN_STEP: {
+    readonly scan: "scan";
+    readonly describe: "describe";
+    readonly probe: "probe";
+    readonly rtSafety: "rt-safety";
+    readonly isolated: "isolated";
+};
+export declare const ISOLATED_RESULT: {
+    readonly isolated: "isolated";
+    readonly refused: "refused";
+    readonly notRun: "not-run";
+};
+/** Why the step refused a plugin, or why it could not run. */
+export declare const ISOLATED_CODE: {
+    readonly crashed: "isolated.crashed";
+    readonly notAdded: "isolated.not-added";
+    readonly noWorker: "isolated.no-worker";
+    readonly notAlone: "isolated.not-alone";
+    readonly nonFinite: "isolated.non-finite-output";
+    readonly silent: "isolated.silent-output";
+    readonly noServer: "isolated.no-private-server";
+    readonly noHost: "isolated.no-host";
+};
+/** What one run of the step saw. A run that never reached the plugin says `started: false`, and `problem`. */
+export interface IsolatedRunFacts {
+    readonly started: boolean;
+    readonly problem?: string;
+    readonly added?: boolean;
+    /** How many workers `worker_list` showed, and how many instances the plugin's holds. */
+    readonly workers?: number;
+    readonly instancesInWorker?: number;
+    readonly alive?: boolean;
+    readonly latencyFrames?: number;
+    readonly cpuPercent?: number;
+    readonly xruns?: number;
+    readonly finite?: boolean;
+    readonly silent?: boolean;
+}
+export type IsolatedRunner = (uri: string, cell: GridCell, env: Readonly<Record<string, string | undefined>>) => IsolatedRunFacts;
+/** The decision table of the step, with the figures it took. Pure. */
+export declare function judgeIsolatedRun(run: IsolatedRunFacts): RunStep;
+/** Whether a record's outcome calls for the isolated step: rated `conditional` by some host, or a probe that crashed or hung. */
+export declare function owesIsolated(record: QualificationRecord): boolean;
+/** Whether the isolated step saw this plugin running alone. A record's word alone never says so. */
+export declare function provenAlone(record: QualificationRecord): boolean;
+/** The steps a record's outcome calls for. */
+export declare function stepsCalledFor(record: QualificationRecord): readonly string[];
+/** The steps a record that carries a `run` lacks, for the sync to refuse it by. A record from before the steps has none to lack. */
+export declare function missingSteps(record: QualificationRecord): readonly string[];
+/** The steps every record has by the time it is written, from what it says of them. Pure. */
+export declare function baseSteps(record: QualificationRecord, describeProblem?: string): RunStep[];
+/** The step as it runs on a device: a private server at the cell, and `tools/isolated-step.mjs` under it. */
+export declare function spawnedIsolatedRunner(jack?: JackStarter): IsolatedRunner;
+/** The cell the step runs at: the rate and quantum the host's cost was judged at, else the first cell a Pi runs. */
+export declare function isolatedCell(record: QualificationRecord, host: string): GridCell;
+/** The pin once the step has spoken: its verdict word follows the step, and a step that could not run leaves none. Pure. */
+export declare function pinAfterStep(pin: PinEntry | undefined, step: RunStep): PinEntry | undefined;
+/**
+ * The missing isolated step of a record already judged: the run keeps its id and gains the step, and nothing else is
+ * measured. `undefined` when it owes none, or has no run id to extend. Writes the record whole.
+ */
+export declare function completeIsolated(path: string, record: QualificationRecord, uri: string, cell: GridCell, runner: IsolatedRunner, env: Readonly<Record<string, string | undefined>>): {
+    readonly record: QualificationRecord;
+    readonly step: RunStep;
+} | undefined;

package/dist/qualify-isolated.js

@@ -0,0 +1,184 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * The steps of one plugin's pass, and the last of them: `verdict=isolated` means the plugin was seen running alone in a
+ * worker of its own (plugin-qualify#249). A plugin the RT-safety step finds unsafe takes the isolated step in the same
+ * pass, and so does one that crashed or hung in the probe. The step runs on a private JACK server at the host's rate and
+ * quantum, under a plugin-hostd of its own: the plugin is added alone, `worker_list` must show it alone, and a sine plays
+ * through it for a window. Only a plugin that was added, stayed alive and gave finite, non-silent output is isolated. A
+ * machine that could not run the step decides nothing about the plugin: no verdict word, and the sync tries it again.
+ *
+ * Every record says which steps judged it. {@link missingSteps} is what the sync refuses a record by; a record from before
+ * the steps has no `run` at all, owes the isolated step if its outcome calls for one, and a completion adds it
+ * ({@link completeIsolated}), measuring nothing else.
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { basename, join } from "node:path";
+import { ADAPTER_PASS_CELLS, startPrivateJack } from "./qualify-adapter-pass.js";
+import { PROBE_OK, readProbeOutput } from "./probe-output.js";
+import { ISOLATED_SIGNAL_TOOL_ENV, ISOLATED_SIGNAL_TOOL_NAME } from "./qualify-declarations.js";
+import { locateNativeTool, toolsDir } from "./tool-paths.js";
+import { writeFileWhole } from "./whole-file.js";
+/** The steps of a pass, in the order they run. */
+export const RUN_STEP = { scan: "scan", describe: "describe", probe: "probe", rtSafety: "rt-safety", isolated: "isolated" };
+export const ISOLATED_RESULT = { isolated: "isolated", refused: "refused", notRun: "not-run" };
+/** Why the step refused a plugin, or why it could not run. */
+export const ISOLATED_CODE = {
+    crashed: "isolated.crashed",
+    notAdded: "isolated.not-added",
+    noWorker: "isolated.no-worker",
+    notAlone: "isolated.not-alone",
+    nonFinite: "isolated.non-finite-output",
+    silent: "isolated.silent-output",
+    noServer: "isolated.no-private-server",
+    noHost: "isolated.no-host",
+};
+/** The outcomes of a probe that take the isolated step as well: the plugin never reached a verdict in-process. */
+const PROBE_FAILED_HARD = new Set(["probe.crashed", "probe.timeout"]);
+/** The decision table of the step, with the figures it took. Pure. */
+export function judgeIsolatedRun(run) {
+    const step = (result, code, detail) => ({
+        step: RUN_STEP.isolated,
+        result,
+        ...(code === undefined ? {} : { code }),
+        ...(detail === undefined ? {} : { detail }),
+        ...(figuresOf(run) === undefined ? {} : { figures: figuresOf(run) }),
+    });
+    if (!run.started)
+        return step(ISOLATED_RESULT.notRun, ISOLATED_CODE.noHost, run.problem);
+    if (run.added !== true)
+        return step(ISOLATED_RESULT.refused, ISOLATED_CODE.notAdded, run.problem);
+    if (run.alive !== true)
+        return step(ISOLATED_RESULT.refused, ISOLATED_CODE.crashed, run.problem);
+    if ((run.workers ?? 0) < 1)
+        return step(ISOLATED_RESULT.refused, ISOLATED_CODE.noWorker);
+    if (run.workers !== 1 || run.instancesInWorker !== 1)
+        return step(ISOLATED_RESULT.refused, ISOLATED_CODE.notAlone);
+    if (run.finite !== true)
+        return step(ISOLATED_RESULT.refused, ISOLATED_CODE.nonFinite);
+    if (run.silent !== false)
+        return step(ISOLATED_RESULT.refused, ISOLATED_CODE.silent);
+    return step(ISOLATED_RESULT.isolated);
+}
+function figuresOf(run) {
+    if (run.latencyFrames === undefined && run.cpuPercent === undefined && run.xruns === undefined)
+        return undefined;
+    return {
+        ...(run.latencyFrames === undefined ? {} : { latencyFrames: run.latencyFrames }),
+        ...(run.cpuPercent === undefined ? {} : { cpuPercent: run.cpuPercent }),
+        ...(run.xruns === undefined ? {} : { xruns: run.xruns }),
+    };
+}
+/** Whether a record's outcome calls for the isolated step: rated `conditional` by some host, or a probe that crashed or hung. */
+export function owesIsolated(record) {
+    return PROBE_FAILED_HARD.has(record.probe.outcome) || record.verdicts.some((v) => v.measured && v.rating === "conditional");
+}
+/** Whether the isolated step saw this plugin running alone. A record's word alone never says so. */
+export function provenAlone(record) {
+    return record.run?.steps.some((s) => s.step === RUN_STEP.isolated && s.result === ISOLATED_RESULT.isolated) === true;
+}
+/** The steps a record's outcome calls for. */
+export function stepsCalledFor(record) {
+    return [
+        RUN_STEP.scan,
+        RUN_STEP.describe,
+        RUN_STEP.probe,
+        ...(record.probe.outcome === PROBE_OK ? [RUN_STEP.rtSafety] : []),
+        ...(owesIsolated(record) ? [RUN_STEP.isolated] : []),
+    ];
+}
+/** The steps a record that carries a `run` lacks, for the sync to refuse it by. A record from before the steps has none to lack. */
+export function missingSteps(record) {
+    if (record.run === undefined)
+        return [];
+    const had = new Set(record.run.steps.map((s) => s.step));
+    return stepsCalledFor(record).filter((s) => !had.has(s));
+}
+/** The steps every record has by the time it is written, from what it says of them. Pure. */
+export function baseSteps(record, describeProblem) {
+    const measured = record.measurements.grid.some((p) => p.rtSafety !== undefined);
+    return [
+        { step: RUN_STEP.scan, result: "ok" },
+        describeProblem === undefined ? { step: RUN_STEP.describe, result: "ok" } : { step: RUN_STEP.describe, result: "failed", detail: describeProblem },
+        { step: RUN_STEP.probe, result: record.probe.outcome },
+        ...(record.probe.outcome === PROBE_OK
+            ? [{ step: RUN_STEP.rtSafety, result: !measured ? "not-measured" : record.verdicts.some((v) => v.rating === "conditional") ? "unsafe" : "safe" }]
+            : []),
+    ];
+}
+/** How long the sine plays, and what a step may take beyond it: the host's start and its answers. */
+const ISOLATED_WINDOW_MS = 3000;
+const ISOLATED_STEP_SLACK_MS = 90000;
+/** The step as it runs on a device: a private server at the cell, and `tools/isolated-step.mjs` under it. */
+export function spawnedIsolatedRunner(jack = startPrivateJack) {
+    return (uri, cell, env) => {
+        const signal = locateNativeTool(ISOLATED_SIGNAL_TOOL_NAME, env, existsSync).path;
+        if (signal === undefined)
+            return { started: false, problem: `no ${ISOLATED_SIGNAL_TOOL_NAME}` };
+        const server = jack(cell);
+        if (server === undefined)
+            return { started: false, problem: `${ISOLATED_CODE.noServer} at ${String(cell.rate)}/${String(cell.quantum)}` };
+        try {
+            const r = spawnSync(process.execPath, [join(toolsDir(), "isolated-step.mjs"), uri, String(ISOLATED_WINDOW_MS)], {
+                encoding: "utf8",
+                timeout: ISOLATED_WINDOW_MS + ISOLATED_STEP_SLACK_MS,
+                killSignal: "SIGKILL",
+                env: { ...env, JACK_DEFAULT_SERVER: server.name, [ISOLATED_SIGNAL_TOOL_ENV]: signal },
+            });
+            if (r.error !== undefined || r.status !== 0)
+                return { started: false, problem: `isolated-step: ${r.error?.message ?? `exit ${String(r.status)}`}: ${(r.stderr ?? "").trim()}` };
+            return JSON.parse(r.stdout);
+        }
+        finally {
+            server.stop();
+        }
+    };
+}
+/** The cell the step runs at: the rate and quantum the host's cost was judged at, else the first cell a Pi runs. */
+export function isolatedCell(record, host) {
+    const at = record.cost.find((c) => c.host === host) ?? record.cost[0];
+    return at === undefined ? ADAPTER_PASS_CELLS[0] : { rate: at.rate, quantum: at.quantum };
+}
+/** The pin once the step has spoken: its verdict word follows the step, and a step that could not run leaves none. Pure. */
+export function pinAfterStep(pin, step) {
+    if (pin === undefined)
+        return undefined;
+    const { verdict: _had, ...rest } = pin;
+    if (step.result === ISOLATED_RESULT.isolated)
+        return { ...rest, verdict: "isolated" };
+    if (step.result === ISOLATED_RESULT.refused)
+        return { ...rest, verdict: "refused" };
+    return rest;
+}
+/** The run id of a record from before the steps: its probe output's, read from the copy beside it. */
+function runIdOf(record, dir) {
+    if (record.run !== undefined)
+        return record.run.id;
+    if (record.rejudged !== undefined)
+        return record.rejudged.figures.runId;
+    try {
+        const read = readProbeOutput(readFileSync(join(dir, basename(record.probe.file)), "utf8"));
+        return read.ok ? read.output.run.id : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The missing isolated step of a record already judged: the run keeps its id and gains the step, and nothing else is
+ * measured. `undefined` when it owes none, or has no run id to extend. Writes the record whole.
+ */
+export function completeIsolated(path, record, uri, cell, runner, env) {
+    if (!owesIsolated(record) || record.run?.steps.some((s) => s.step === RUN_STEP.isolated) === true)
+        return undefined;
+    const id = runIdOf(record, join(path, ".."));
+    if (id === undefined)
+        return undefined;
+    const step = judgeIsolatedRun(runner(uri, cell, env));
+    const run = { id, steps: [...(record.run?.steps ?? baseSteps(record)), step] };
+    const next = { ...record, run };
+    writeFileWhole(path, `${JSON.stringify(next, null, 2)}\n`);
+    return { record: next, step };
+}
+//# sourceMappingURL=qualify-isolated.js.map

package/dist/qualify-isolated.js.map

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

package/dist/qualify-rejudge.d.ts

@@ -0,0 +1,82 @@
+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: {
+    readonly isolatedStep: "qualify.sync.isolated-step-owed";
+    /** 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;