@openmixer/plugin-qualify 0.0.0-stage → 0.3.0

package/dist/measurement/plan.d.ts

@@ -0,0 +1,127 @@
+/**
+ * What a run is going to do, decided before it starts.
+ *
+ * Two questions, answered in the same breath: *"Measure at least the rates this
+ * installation can actually use … but it must not silently fall back to a rate it does not
+ * use"*, and *"show progress"* — which needs a duration, which nobody can honestly produce
+ * for a machine they have never seen.
+ *
+ * ## Rates are data, not a constant
+ *
+ * There is no default rate list in this module and there must never be one. A console that
+ * runs 48 k and 96 k does not need 192 k figures; a console whose driver only offers 44.1 k
+ * must not be handed a 48 k measurement wearing its label. The plan is derived from what the
+ * installation reports — its live rate and its device's supported list — and a request for a
+ * rate the hardware does not offer is DROPPED and reported, never honoured.
+ *
+ * A plan with no rates is a legitimate outcome: it means nobody has told us what this
+ * installation runs at, and the correct behaviour is to refuse and say so rather than pick
+ * 48 000 because it is a common number.
+ *
+ * ## Duration is an estimate or it is nothing
+ *
+ * {@link estimateRunSeconds} scales a REFERENCE run's measured wall time by the work the new
+ * plan asks for. With no reference run — or a reference that never recorded its own duration
+ * — it returns `undefined`. There is no fallback constant: "about 15 minutes" measured on a
+ * Core Ultra 9 is not an estimate for a NUC, and a wrong progress estimate is how an operator
+ * ends up cancelling a run that was nearly done.
+ */
+import { type MeasurementDimension } from "./vocabulary.js";
+import type { MeasurementDocument, MeasurementRun } from "./format.js";
+/** What the installation knows about its own clock, as far as the plan is concerned. */
+export interface InstallationRates {
+    /** The rate the graph is running at right now, when the console knows it. */
+    readonly liveRate?: number;
+    /** Rates the active device actually offers. Empty/absent = the console has not probed. */
+    readonly supportedRates?: readonly number[];
+    /** Rates the operator asked for. Absent = "whatever this installation can use". */
+    readonly requestedRates?: readonly number[];
+}
+/** The rates a run will measure at, and what was left out on the way there. */
+export interface RatePlan {
+    /** Rates to measure, ascending. Empty when nothing could be resolved. */
+    readonly rates: readonly number[];
+    /**
+     * Rates the operator asked for that the installation does not offer. Reported, not
+     * measured — a figure at a rate the rig cannot run is a figure nobody will ever use, and
+     * quietly measuring it would make the run longer for nothing.
+     */
+    readonly dropped: readonly number[];
+    /**
+     * Set when {@link rates} is empty: `no-rates-known`. The console could name neither a
+     * live rate nor a supported list, so there is nothing to measure and no safe guess.
+     */
+    readonly problem?: string;
+}
+/**
+ * Resolve the rates a local run should measure at.
+ *
+ * The live rate is always included when known — a console must have figures for the rate it
+ * is running at, whatever else the operator asked for. Beyond that: the requested rates
+ * intersected with what the device offers, or, absent a request, the whole supported list.
+ */
+export declare function ratesForInstallation(input: InstallationRates): RatePlan;
+/** A run, fully specified, before anything is probed. */
+export interface MeasurementPlan {
+    readonly rates: readonly number[];
+    readonly dimensions: readonly MeasurementDimension[];
+    /** Rates asked for and dropped as unusable here — carried through so the UI can say so. */
+    readonly droppedRates: readonly number[];
+    /** How many plugins the run will visit, when a scan has already told us. */
+    readonly pluginCount?: number;
+    /** Set when the plan cannot run: `no-rates-known` / `no-dimensions`. */
+    readonly problem?: string;
+}
+/** Build a plan from resolved rates and the dimensions the operator chose. */
+export declare function measurementPlan(ratePlan: RatePlan, dimensions: readonly MeasurementDimension[], pluginCount?: number): MeasurementPlan;
+/** True when a plan has enough to run: at least one rate and at least one dimension. */
+export declare function isRunnablePlan(plan: MeasurementPlan): boolean;
+/**
+ * The unit of work a plan represents: plugins × rates × dimensions.
+ *
+ * Crude on purpose. A convolution reverb costs more than a gain, but the prober caps each
+ * plugin's wall time, so over a whole catalogue the product is close enough to scale a
+ * measured duration by — and a more elaborate model would imply a precision the estimate
+ * does not have.
+ */
+export declare function planWorkUnits(plan: MeasurementPlan): number | undefined;
+/** A duration estimate, with the run it was extrapolated from named. */
+export interface RunEstimate {
+    readonly seconds: number;
+    /** The reference run's id, host and duration — everything needed to render "on <host>,
+     *  <n> plugins took <t>", so the operator can judge the extrapolation themselves. */
+    readonly basis: {
+        readonly runId: string;
+        readonly host: string;
+        readonly seconds: number;
+        readonly workUnits: number;
+    };
+}
+/**
+ * How long this plan is likely to take, extrapolated from a run that actually happened.
+ *
+ * `undefined` whenever it cannot be derived — no reference document, the reference never
+ * recorded `elapsedSeconds`, or the plan does not yet know its plugin count. An unknown
+ * duration is reported as unknown; there is no constant to fall back on and inventing one
+ * would be the exact dishonesty the provenance discipline exists to prevent.
+ *
+ * When the reference ran on ANOTHER machine the estimate is still only an order of
+ * magnitude — which is why {@link RunEstimate.basis} names the host rather than hiding it.
+ */
+export declare function estimateRunSeconds(plan: MeasurementPlan, reference: MeasurementDocument | undefined): RunEstimate | undefined;
+/**
+ * Rates a completed run covers that the installation no longer cares about, and rates the
+ * installation now uses that the run never covered.
+ *
+ * The second list is the rate-change case: the operator moved the rig to 96 kHz, so the
+ * figures for 96 kHz are MISSING rather than wrong, and the console should offer to measure
+ * them instead of interpolating across a boundary 19 nonconforming plugins prove cannot be
+ * interpolated across.
+ */
+export interface RateCoverage {
+    readonly covered: readonly number[];
+    readonly missing: readonly number[];
+    readonly extra: readonly number[];
+}
+/** Compare a run's rates against the rates an installation now uses. */
+export declare function rateCoverage(run: MeasurementRun | undefined, needed: readonly number[]): RateCoverage;

package/dist/measurement/plan.js

@@ -0,0 +1,141 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * What a run is going to do, decided before it starts.
+ *
+ * Two questions, answered in the same breath: *"Measure at least the rates this
+ * installation can actually use … but it must not silently fall back to a rate it does not
+ * use"*, and *"show progress"* — which needs a duration, which nobody can honestly produce
+ * for a machine they have never seen.
+ *
+ * ## Rates are data, not a constant
+ *
+ * There is no default rate list in this module and there must never be one. A console that
+ * runs 48 k and 96 k does not need 192 k figures; a console whose driver only offers 44.1 k
+ * must not be handed a 48 k measurement wearing its label. The plan is derived from what the
+ * installation reports — its live rate and its device's supported list — and a request for a
+ * rate the hardware does not offer is DROPPED and reported, never honoured.
+ *
+ * A plan with no rates is a legitimate outcome: it means nobody has told us what this
+ * installation runs at, and the correct behaviour is to refuse and say so rather than pick
+ * 48 000 because it is a common number.
+ *
+ * ## Duration is an estimate or it is nothing
+ *
+ * {@link estimateRunSeconds} scales a REFERENCE run's measured wall time by the work the new
+ * plan asks for. With no reference run — or a reference that never recorded its own duration
+ * — it returns `undefined`. There is no fallback constant: "about 15 minutes" measured on a
+ * Core Ultra 9 is not an estimate for a NUC, and a wrong progress estimate is how an operator
+ * ends up cancelling a run that was nearly done.
+ */
+import { MEASUREMENT_DIMENSIONS } from "./vocabulary.js";
+/**
+ * Resolve the rates a local run should measure at.
+ *
+ * The live rate is always included when known — a console must have figures for the rate it
+ * is running at, whatever else the operator asked for. Beyond that: the requested rates
+ * intersected with what the device offers, or, absent a request, the whole supported list.
+ */
+export function ratesForInstallation(input) {
+    const supported = [...new Set((input.supportedRates ?? []).filter((r) => Number.isFinite(r) && r > 0))];
+    const live = input.liveRate !== undefined && Number.isFinite(input.liveRate) && input.liveRate > 0
+        ? input.liveRate
+        : undefined;
+    // What this installation can actually use: the device list, plus the rate it is demonstrably
+    // running at (a live rate absent from the probed list is the device telling us the list is
+    // incomplete, not the other way round).
+    const usable = new Set(supported);
+    if (live !== undefined)
+        usable.add(live);
+    const requested = input.requestedRates?.filter((r) => Number.isFinite(r) && r > 0);
+    if (requested === undefined || requested.length === 0) {
+        const rates = [...usable].sort((a, b) => a - b);
+        return rates.length > 0
+            ? { rates, dropped: [] }
+            : { rates: [], dropped: [], problem: "no-rates-known" };
+    }
+    const wanted = new Set(requested);
+    if (live !== undefined)
+        wanted.add(live);
+    const rates = [...wanted].filter((r) => usable.has(r)).sort((a, b) => a - b);
+    const dropped = [...wanted].filter((r) => !usable.has(r)).sort((a, b) => a - b);
+    return rates.length > 0
+        ? { rates, dropped }
+        : { rates: [], dropped, problem: "no-rates-known" };
+}
+/** Build a plan from resolved rates and the dimensions the operator chose. */
+export function measurementPlan(ratePlan, dimensions, pluginCount) {
+    const wanted = MEASUREMENT_DIMENSIONS.filter((d) => dimensions.includes(d));
+    const problem = ratePlan.problem ?? (wanted.length === 0 ? "no-dimensions" : undefined);
+    return {
+        rates: ratePlan.rates,
+        dimensions: wanted,
+        droppedRates: ratePlan.dropped,
+        ...(pluginCount === undefined ? {} : { pluginCount }),
+        ...(problem === undefined ? {} : { problem }),
+    };
+}
+/** True when a plan has enough to run: at least one rate and at least one dimension. */
+export function isRunnablePlan(plan) {
+    return plan.problem === undefined && plan.rates.length > 0 && plan.dimensions.length > 0;
+}
+/**
+ * The unit of work a plan represents: plugins × rates × dimensions.
+ *
+ * Crude on purpose. A convolution reverb costs more than a gain, but the prober caps each
+ * plugin's wall time, so over a whole catalogue the product is close enough to scale a
+ * measured duration by — and a more elaborate model would imply a precision the estimate
+ * does not have.
+ */
+export function planWorkUnits(plan) {
+    if (plan.pluginCount === undefined)
+        return undefined;
+    return plan.pluginCount * plan.rates.length * plan.dimensions.length;
+}
+/** The work a completed run represents, from its own document. */
+function runWorkUnits(document) {
+    const units = document.plugins.length * document.run.rates.length * document.run.dimensions.length;
+    return units > 0 ? units : undefined;
+}
+/**
+ * How long this plan is likely to take, extrapolated from a run that actually happened.
+ *
+ * `undefined` whenever it cannot be derived — no reference document, the reference never
+ * recorded `elapsedSeconds`, or the plan does not yet know its plugin count. An unknown
+ * duration is reported as unknown; there is no constant to fall back on and inventing one
+ * would be the exact dishonesty the provenance discipline exists to prevent.
+ *
+ * When the reference ran on ANOTHER machine the estimate is still only an order of
+ * magnitude — which is why {@link RunEstimate.basis} names the host rather than hiding it.
+ */
+export function estimateRunSeconds(plan, reference) {
+    if (reference === undefined)
+        return undefined;
+    const elapsed = reference.run.elapsedSeconds;
+    if (elapsed === undefined || !(elapsed > 0))
+        return undefined;
+    const referenceUnits = runWorkUnits(reference);
+    const planUnits = planWorkUnits(plan);
+    if (referenceUnits === undefined || planUnits === undefined || planUnits === 0)
+        return undefined;
+    return {
+        seconds: (elapsed * planUnits) / referenceUnits,
+        basis: {
+            runId: reference.run.id,
+            host: reference.run.host.hostname,
+            seconds: elapsed,
+            workUnits: referenceUnits,
+        },
+    };
+}
+/** Compare a run's rates against the rates an installation now uses. */
+export function rateCoverage(run, needed) {
+    const have = new Set(run?.rates ?? []);
+    const want = [...new Set(needed)].sort((a, b) => a - b);
+    return {
+        covered: want.filter((rate) => have.has(rate)),
+        missing: want.filter((rate) => !have.has(rate)),
+        extra: [...have].filter((rate) => !want.includes(rate)).sort((a, b) => a - b),
+    };
+}
+//# sourceMappingURL=plan.js.map

package/dist/measurement/plan.js.map

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

package/dist/measurement/probe-json.d.ts

@@ -0,0 +1,61 @@
+/**
+ * The prober's JSON → the interchange format.
+ *
+ * `tools/scan.py` and `tools/benchmark.py` write a flat array of annotated descriptors —
+ * their own working shape, which predates this format and carries fields (curation tiers,
+ * parameter lists, RPM ownership) that have nothing to do with a measurement. This module
+ * is the one place that knows both shapes, and it is where three deliberate conversions
+ * happen:
+ *
+ * 1. **Free text becomes vocabulary.** The prober says `"worker crashed (…)"`,
+ *    `"probe timed out"`, `"non-finite output"` — useful to a human, unmergeable between
+ *    projects. Each is mapped to a term from {@link ./vocabulary.ts}, and the prober's own
+ *    sentence is preserved verbatim next to it so the coarser code never destroys the
+ *    detail.
+ * 2. **Derived figures are dropped.** `coreFractionP95` and `instancesPerCoreP95` are
+ *    `nsPerSample × rate` and its reciprocal. Storing them invites the two to disagree
+ *    after an edit; the format keeps the measured primitive and lets consumers derive.
+ * 3. **`nsPerSampleP95` becomes `nsPerSamplePercentile`.** The percentile is a property of
+ *    the RUN, declared once in {@link ../format.CostMethod}. Baking `95` into every field
+ *    name would make a p99 run unrepresentable.
+ *
+ * The reader is structural: it validates the fields it needs and ignores everything else,
+ * so it survives the prober growing new ones.
+ */
+import type { MeasuredPlugin } from "./format.js";
+import type { MeasurementDimension } from "./vocabulary.js";
+/** One free-text prober failure, and the vocabulary term it means. */
+interface ReasonRule {
+    /** Matched against the prober's lowercased text. */
+    readonly match: RegExp;
+    readonly code: string;
+}
+/**
+ * The prober's words → the controlled vocabulary. Ordered: the first match wins, so the
+ * specific patterns come before the general ones.
+ *
+ * A table rather than a switch precisely so the next prober — someone else's — can be
+ * supported by adding rows, which is the whole ambition of publishing a format.
+ */
+export declare const PROBE_REASON_RULES: readonly ReasonRule[];
+/**
+ * The vocabulary code for a prober reason.
+ *
+ * Anything unmatched becomes `probe-error` — never a guessed structural reason. A reason we
+ * cannot classify must not be allowed to claim the plugin has nothing to measure, because
+ * that claim would override a good figure from another machine ({@link ./merge.ts}).
+ */
+export declare function probeReasonCode(text: string): string;
+/**
+ * One prober descriptor as a {@link MeasuredPlugin}, or `undefined` when it is not one.
+ *
+ * `dimensions` says which dimensions the run covered: a dimension NOT covered yields no
+ * block at all (the run never asked), while a covered dimension always yields one, carrying
+ * either readings or a reason. That distinction is what makes a partial run readable. The
+ * prober's JSON carries only `latency` and `cost`; a hosting dimension listed here yields no
+ * block, because this reader has nothing to read it from (`sweep-jsonl.ts` does).
+ */
+export declare function measuredPluginFromProbeEntry(value: unknown, dimensions: readonly MeasurementDimension[]): MeasuredPlugin | undefined;
+/** Every readable descriptor in a prober output array, as measured plugins. */
+export declare function measuredPluginsFromProbeOutput(value: unknown, dimensions: readonly MeasurementDimension[]): MeasuredPlugin[];
+export {};

package/dist/measurement/probe-json.js

@@ -0,0 +1,253 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * The prober's JSON → the interchange format.
+ *
+ * `tools/scan.py` and `tools/benchmark.py` write a flat array of annotated descriptors —
+ * their own working shape, which predates this format and carries fields (curation tiers,
+ * parameter lists, RPM ownership) that have nothing to do with a measurement. This module
+ * is the one place that knows both shapes, and it is where three deliberate conversions
+ * happen:
+ *
+ * 1. **Free text becomes vocabulary.** The prober says `"worker crashed (…)"`,
+ *    `"probe timed out"`, `"non-finite output"` — useful to a human, unmergeable between
+ *    projects. Each is mapped to a term from {@link ./vocabulary.ts}, and the prober's own
+ *    sentence is preserved verbatim next to it so the coarser code never destroys the
+ *    detail.
+ * 2. **Derived figures are dropped.** `coreFractionP95` and `instancesPerCoreP95` are
+ *    `nsPerSample × rate` and its reciprocal. Storing them invites the two to disagree
+ *    after an edit; the format keeps the measured primitive and lets consumers derive.
+ * 3. **`nsPerSampleP95` becomes `nsPerSamplePercentile`.** The percentile is a property of
+ *    the RUN, declared once in {@link ../format.CostMethod}. Baking `95` into every field
+ *    name would make a p99 run unrepresentable.
+ *
+ * The reader is structural: it validates the fields it needs and ignores everything else,
+ * so it survives the prober growing new ones.
+ */
+import { booleanValue, finiteNumber, isRecord, nonEmptyString, optional, positiveNumber } from "./guards.js";
+/**
+ * The prober's words → the controlled vocabulary. Ordered: the first match wins, so the
+ * specific patterns come before the general ones.
+ *
+ * A table rather than a switch precisely so the next prober — someone else's — can be
+ * supported by adding rows, which is the whole ambition of publishing a format.
+ */
+export const PROBE_REASON_RULES = [
+    { match: /^no-audio-in$/, code: "no-audio-in" },
+    { match: /^no-audio-out$/, code: "no-audio-out" },
+    { match: /^silent-output$/, code: "silent-output" },
+    { match: /worker crashed|worker desync|worker unavailable/, code: "probe-crashed" },
+    { match: /timed out|timeout/, code: "probe-timeout" },
+    { match: /non-finite/, code: "non-finite-output" },
+    { match: /not installed/, code: "not-installed" },
+    { match: /refus|instantiat/, code: "refused-instantiation" },
+];
+/**
+ * The vocabulary code for a prober reason.
+ *
+ * Anything unmatched becomes `probe-error` — never a guessed structural reason. A reason we
+ * cannot classify must not be allowed to claim the plugin has nothing to measure, because
+ * that claim would override a good figure from another machine ({@link ./merge.ts}).
+ */
+export function probeReasonCode(text) {
+    const lower = text.toLowerCase();
+    return PROBE_REASON_RULES.find((rule) => rule.match.test(lower))?.code ?? "probe-error";
+}
+function reasonFields(text) {
+    if (text === undefined)
+        return {};
+    const code = probeReasonCode(text);
+    return {
+        unmeasuredReason: code,
+        // Keep the prober's sentence only when it says more than the code already does.
+        ...(text === code ? {} : { unmeasuredDetail: text }),
+    };
+}
+function readTopology(entry) {
+    const audioInputs = finiteNumber(entry.audioInputs);
+    const audioOutputs = finiteNumber(entry.audioOutputs);
+    if (audioInputs === undefined || audioOutputs === undefined)
+        return undefined;
+    const midiInputs = entry.hasMidiIn === true ? 1 : entry.hasMidiIn === false ? 0 : undefined;
+    const controlInputs = Array.isArray(entry.params)
+        ? entry.params.filter((p) => isRecord(p) && p.kind === "control").length
+        : undefined;
+    return {
+        audioInputs,
+        audioOutputs,
+        ...optional("midiInputs", midiInputs),
+        ...optional("controlInputs", controlInputs),
+    };
+}
+function readSweep(value) {
+    if (!isRecord(value))
+        return undefined;
+    const rate = positiveNumber(value.rate);
+    const defaultFrames = finiteNumber(value.defaultFrames);
+    const minFrames = finiteNumber(value.minFrames);
+    const maxFrames = finiteNumber(value.maxFrames);
+    if (rate === undefined || defaultFrames === undefined || minFrames === undefined || maxFrames === undefined) {
+        return undefined;
+    }
+    const controls = {};
+    if (isRecord(value.controls)) {
+        for (const [symbol, span] of Object.entries(value.controls)) {
+            if (!isRecord(span))
+                continue;
+            const lo = finiteNumber(span.minFrames);
+            const hi = finiteNumber(span.maxFrames);
+            if (lo === undefined || hi === undefined)
+                continue;
+            controls[symbol] = { minFrames: lo, maxFrames: hi };
+        }
+    }
+    return { rate, defaultFrames, minFrames, maxFrames, controls };
+}
+/**
+ * Rates the prober condemned, as `rate → reason`. In the catalog shape these live in a
+ * parallel `unreliableRates` array; the format puts the exclusion ON the reading it
+ * disqualifies, where a consumer cannot fail to notice it.
+ */
+function excludedRates(value) {
+    const out = new Map();
+    if (!Array.isArray(value))
+        return out;
+    for (const item of value) {
+        if (!isRecord(item))
+            continue;
+        const rate = positiveNumber(item.rate);
+        const reason = nonEmptyString(item.reason);
+        if (rate === undefined || reason === undefined)
+            continue;
+        out.set(String(rate), reason);
+    }
+    return out;
+}
+function readLatency(value) {
+    if (!isRecord(value))
+        return undefined;
+    const excluded = excludedRates(value.unreliableRates);
+    const perRate = {};
+    if (isRecord(value.perRate)) {
+        for (const [key, reading] of Object.entries(value.perRate)) {
+            const rate = positiveNumber(Number(key));
+            if (rate === undefined || !isRecord(reading))
+                continue;
+            const frames = finiteNumber(reading.frames);
+            const ms = finiteNumber(reading.ms);
+            if (frames === undefined || ms === undefined)
+                continue;
+            perRate[String(rate)] = {
+                frames,
+                ms,
+                ...optional("stimulus", nonEmptyString(value.stimulus)),
+                ...optional("excludedReason", excluded.get(String(rate))),
+            };
+        }
+    }
+    const unmeasurable = nonEmptyString(value.unmeasurable);
+    const measurement = {
+        perRate,
+        ...optional("scalingClass", nonEmptyString(value.scalingClass)),
+        ...optional("scalingNote", nonEmptyString(value.scalingNote)),
+        ...optional("declaredPortSymbol", nonEmptyString(value.portSymbol)),
+        ...optional("declaredFrames", finiteNumber(value.reportedFrames)),
+        ...optional("declaredMismatch", booleanValue(value.declaredMismatch)),
+        ...optional("paramSweep", readSweep(value.paramSweep)),
+        // A reason only when there is no reading: a figure and a reason are mutually exclusive.
+        ...(Object.keys(perRate).length === 0 ? reasonFields(unmeasurable) : {}),
+    };
+    return measurement;
+}
+function readCost(value) {
+    if (!isRecord(value))
+        return undefined;
+    const perRate = {};
+    if (isRecord(value.perRate)) {
+        for (const [key, reading] of Object.entries(value.perRate)) {
+            const rate = positiveNumber(Number(key));
+            if (rate === undefined || !isRecord(reading))
+                continue;
+            const median = finiteNumber(reading.nsPerSampleMedian);
+            const high = finiteNumber(reading.nsPerSampleP95);
+            const blocks = finiteNumber(reading.blocks);
+            const blockFrames = positiveNumber(reading.blockFrames);
+            if (median === undefined || high === undefined || blocks === undefined || blockFrames === undefined) {
+                continue;
+            }
+            perRate[String(rate)] = {
+                nsPerSampleMedian: median,
+                nsPerSamplePercentile: high,
+                blocks,
+                blockFrames,
+                ...optional("nsPerSampleMin", finiteNumber(reading.nsPerSampleMin)),
+                ...optional("nsPerSampleMax", finiteNumber(reading.nsPerSampleMax)),
+                ...optional("warmupNsPerSampleMedian", finiteNumber(reading.warmupNsPerSampleMedian)),
+                ...optional("silentOutput", booleanValue(reading.silentOutput)),
+            };
+        }
+    }
+    const reason = nonEmptyString(value.unmeasurable) ?? nonEmptyString(value.failed);
+    return {
+        perRate,
+        ...(Object.keys(perRate).length === 0 ? reasonFields(reason) : {}),
+    };
+}
+/**
+ * The plugin's own version, `"<minor>.<micro>"`, when the scan recorded one.
+ *
+ * Absent rather than `"0.0"` when it did not: a version of zero is a real LV2 answer
+ * (unstable/development), so it must not double as "we do not know".
+ */
+function readVersion(entry) {
+    const minor = finiteNumber(entry.minorVersion);
+    const micro = finiteNumber(entry.microVersion);
+    if (minor === undefined || micro === undefined)
+        return nonEmptyString(entry.version);
+    return `${minor}.${micro}`;
+}
+/**
+ * One prober descriptor as a {@link MeasuredPlugin}, or `undefined` when it is not one.
+ *
+ * `dimensions` says which dimensions the run covered: a dimension NOT covered yields no
+ * block at all (the run never asked), while a covered dimension always yields one, carrying
+ * either readings or a reason. That distinction is what makes a partial run readable. The
+ * prober's JSON carries only `latency` and `cost`; a hosting dimension listed here yields no
+ * block, because this reader has nothing to read it from (`sweep-jsonl.ts` does).
+ */
+export function measuredPluginFromProbeEntry(value, dimensions) {
+    if (!isRecord(value))
+        return undefined;
+    const uri = nonEmptyString(value.uri);
+    if (uri === undefined)
+        return undefined;
+    const topology = readTopology(value);
+    if (topology === undefined)
+        return undefined;
+    const latency = dimensions.includes("latency")
+        ? readLatency(value.latency) ?? { perRate: {}, unmeasuredReason: "not-attempted" }
+        : undefined;
+    const cost = dimensions.includes("cost")
+        ? readCost(value.cpuCost) ?? { perRate: {}, unmeasuredReason: "not-attempted" }
+        : undefined;
+    return {
+        uri,
+        topology,
+        ...optional("name", nonEmptyString(value.name)),
+        ...optional("version", readVersion(value)),
+        ...optional("bundle", nonEmptyString(value.bundlePath)),
+        ...optional("lv2Class", nonEmptyString(value.lv2Class)),
+        ...optional("latency", latency),
+        ...optional("cost", cost),
+    };
+}
+/** Every readable descriptor in a prober output array, as measured plugins. */
+export function measuredPluginsFromProbeOutput(value, dimensions) {
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap((entry) => {
+        const plugin = measuredPluginFromProbeEntry(entry, dimensions);
+        return plugin === undefined ? [] : [plugin];
+    });
+}
+//# sourceMappingURL=probe-json.js.map

package/dist/measurement/probe-json.js.map

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