@openmixer/plugin-qualify 0.0.0-stage → 0.3.0

package/dist/measurement/guards.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The only shape primitives this directory uses.
+ *
+ * `src/measurement/` is written to be lifted out as a directory copy, so it imports NOTHING from its parent package — not even the catalog's
+ * own `guards.ts`, whose header explains the same reasoning one level up. Keep it that
+ * way: any import that reaches outside this directory turns a copy into a port.
+ *
+ * Every reader here returns `undefined` for input it cannot vouch for, and every builder
+ * omits a field it has no value for. Both halves of the format's central rule: an absent
+ * field means "not determined", never "zero" and never "false".
+ */
+/** Non-null, non-array plain object — the only shape a validator may index into. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** A finite number, or `undefined` for anything else (including `NaN` and `Infinity`). */
+export declare function finiteNumber(value: unknown): number | undefined;
+/** A finite number strictly greater than zero, or `undefined`. */
+export declare function positiveNumber(value: unknown): number | undefined;
+/** A non-empty string, or `undefined`. An empty string is absence spelled differently. */
+export declare function nonEmptyString(value: unknown): string | undefined;
+/** A boolean, or `undefined` — never a coerced truthiness. */
+export declare function booleanValue(value: unknown): boolean | undefined;
+/** Every element of an array that a reader accepted, in order; `undefined` if not an array. */
+export declare function mapArray<T>(value: unknown, read: (item: unknown) => T | undefined): T[] | undefined;
+/**
+ * `{ [key]: value }` when `value` is defined, `{}` otherwise — the spread helper every
+ * builder uses for an optional field.
+ *
+ * Written as a function rather than an inline ternary at ~40 call sites so the intent
+ * (omit, do not null) is named once and cannot drift.
+ */
+export declare function optional<K extends string, V>(key: K, value: V | undefined): {
+    [P in K]?: V;
+};

package/dist/measurement/guards.js

@@ -0,0 +1,61 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * The only shape primitives this directory uses.
+ *
+ * `src/measurement/` is written to be lifted out as a directory copy, so it imports NOTHING from its parent package — not even the catalog's
+ * own `guards.ts`, whose header explains the same reasoning one level up. Keep it that
+ * way: any import that reaches outside this directory turns a copy into a port.
+ *
+ * Every reader here returns `undefined` for input it cannot vouch for, and every builder
+ * omits a field it has no value for. Both halves of the format's central rule: an absent
+ * field means "not determined", never "zero" and never "false".
+ */
+/** Non-null, non-array plain object — the only shape a validator may index into. */
+export function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** A finite number, or `undefined` for anything else (including `NaN` and `Infinity`). */
+export function finiteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+/** A finite number strictly greater than zero, or `undefined`. */
+export function positiveNumber(value) {
+    const n = finiteNumber(value);
+    return n !== undefined && n > 0 ? n : undefined;
+}
+/** A non-empty string, or `undefined`. An empty string is absence spelled differently. */
+export function nonEmptyString(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+/** A boolean, or `undefined` — never a coerced truthiness. */
+export function booleanValue(value) {
+    return typeof value === "boolean" ? value : undefined;
+}
+/** Every element of an array that a reader accepted, in order; `undefined` if not an array. */
+export function mapArray(value, read) {
+    if (!Array.isArray(value))
+        return undefined;
+    const out = [];
+    for (const item of value) {
+        const parsed = read(item);
+        if (parsed !== undefined)
+            out.push(parsed);
+    }
+    return out;
+}
+/**
+ * `{ [key]: value }` when `value` is defined, `{}` otherwise — the spread helper every
+ * builder uses for an optional field.
+ *
+ * Written as a function rather than an inline ternary at ~40 call sites so the intent
+ * (omit, do not null) is named once and cannot drift.
+ */
+export function optional(key, value) {
+    if (value === undefined)
+        return {};
+    const out = {};
+    out[key] = value;
+    return out;
+}
+//# sourceMappingURL=guards.js.map

package/dist/measurement/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../src/measurement/guards.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD;;;;;;;;;;GAUG;AAEH,oFAAoF;AACpF,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,QAAQ,CAAI,KAAc,EAAE,IAAsC;IAChF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,GAAG,GAAQ,EAAE,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,MAAM,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAsB,GAAM,EAAE,KAAoB;IACxE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACjB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/measurement/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * **The LV2 plugin measurement interchange format, and the tool that produces it.**
+ *
+ * This directory is written to stand alone. The idea is that measured LV2 plugin
+ * characteristics — per-rate latency with its scaling law, per-rate CPU cost, topology, and
+ * above all the PROVENANCE without which none of it is comparable — should be publishable
+ * in a shape any LV2 host can read, rather than re-derived by each project from a prober it
+ * wrote itself. The OpenMixer console is the format's first consumer, which is what keeps it
+ * honest; it is not meant to be the only one.
+ *
+ * ## What is in here, and what is deliberately not
+ *
+ * | module | role |
+ * |---|---|
+ * | `format.ts` | the schema: types, version strategy, cast-free readers, builders |
+ * | `vocabulary.ts` | the controlled vocabularies — why a figure is absent, how latency scales |
+ * | `provenance.ts` | the run record: machine facts read rather than assumed |
+ * | `probe-json.ts` | `benchmark.py`'s working JSON → the format |
+ * | `sweep-jsonl.ts` | the hosting sweep's JSONL (`lv2-measure.c`) → the three hosting dimensions |
+ * | `merge.ts` | shipped defaults with local measurements over them, each figure knowing its source |
+ * | `plan.ts` | which rates to measure, and how long it might take |
+ * | `cli.ts` | `lv2-measure`'s decisions, with the subprocess spawning left to `tools/lv2-measure.mjs` |
+ *
+ * Nothing in this directory imports anything outside it — not a catalog's descriptor
+ * types, not suitability rules, not a console's core library. Extraction is a directory copy
+ * plus `tools/{scan,benchmark}.py` and `tools/lv2-measure.mjs`. Adapters that turn a merged
+ * view into a host's own descriptors belong in that host, on purpose.
+ */
+export * from "./format.js";
+export * from "./vocabulary.js";
+export * from "./provenance.js";
+export * from "./probe-json.js";
+export * from "./merge.js";
+export * from "./plan.js";
+export * from "./cli.js";
+export * from "./sweep-jsonl.js";

package/dist/measurement/index.js

@@ -0,0 +1,39 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * **The LV2 plugin measurement interchange format, and the tool that produces it.**
+ *
+ * This directory is written to stand alone. The idea is that measured LV2 plugin
+ * characteristics — per-rate latency with its scaling law, per-rate CPU cost, topology, and
+ * above all the PROVENANCE without which none of it is comparable — should be publishable
+ * in a shape any LV2 host can read, rather than re-derived by each project from a prober it
+ * wrote itself. The OpenMixer console is the format's first consumer, which is what keeps it
+ * honest; it is not meant to be the only one.
+ *
+ * ## What is in here, and what is deliberately not
+ *
+ * | module | role |
+ * |---|---|
+ * | `format.ts` | the schema: types, version strategy, cast-free readers, builders |
+ * | `vocabulary.ts` | the controlled vocabularies — why a figure is absent, how latency scales |
+ * | `provenance.ts` | the run record: machine facts read rather than assumed |
+ * | `probe-json.ts` | `benchmark.py`'s working JSON → the format |
+ * | `sweep-jsonl.ts` | the hosting sweep's JSONL (`lv2-measure.c`) → the three hosting dimensions |
+ * | `merge.ts` | shipped defaults with local measurements over them, each figure knowing its source |
+ * | `plan.ts` | which rates to measure, and how long it might take |
+ * | `cli.ts` | `lv2-measure`'s decisions, with the subprocess spawning left to `tools/lv2-measure.mjs` |
+ *
+ * Nothing in this directory imports anything outside it — not a catalog's descriptor
+ * types, not suitability rules, not a console's core library. Extraction is a directory copy
+ * plus `tools/{scan,benchmark}.py` and `tools/lv2-measure.mjs`. Adapters that turn a merged
+ * view into a host's own descriptors belong in that host, on purpose.
+ */
+export * from "./format.js";
+export * from "./vocabulary.js";
+export * from "./provenance.js";
+export * from "./probe-json.js";
+export * from "./merge.js";
+export * from "./plan.js";
+export * from "./cli.js";
+export * from "./sweep-jsonl.js";
+//# sourceMappingURL=index.js.map

package/dist/measurement/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/measurement/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC"}

package/dist/measurement/merge.d.ts

@@ -0,0 +1,143 @@
+/**
+ * **Shipped defaults, overridden by local measurement** — and the operator can
+ * always see which is which.
+ *
+ * The rule is one sentence: *what we ship is a sensible default; a local run overrides it.*
+ * Everything below is what that sentence costs once you refuse to lie about the result.
+ *
+ * ## Why the merge is per plugin per DIMENSION, and not per rate
+ *
+ * The tempting rule — "take the local figure wherever there is one, rate by rate" — would
+ * produce a plugin whose 48 kHz cost came from the customer's NUC and whose 96 kHz cost came
+ * from our reference laptop. The scaling class then gets fitted across two machines, and the
+ * ratio between the two rates, the one thing per-rate data exists to express, becomes an
+ * artefact of the hardware difference. It would look like data and behave like noise.
+ *
+ * So a local run REPLACES a plugin's whole dimension or none of it. A rate the local run did
+ * not cover comes back as MISSING, not as the shipped number wearing a local label
+ * ({@link MergedMeasurements.missingRates}) — which is what a reader wants when the
+ * operator later adds a rate: *"the affected figures are missing rather than wrong — surface
+ * that, and offer to measure the new rate rather than quietly interpolating."*
+ *
+ * ## Why a failed local probe does NOT override
+ *
+ * A local run that crashed on a plugin has learned nothing about that plugin's latency. If
+ * the failure overrode, one segfault would delete a good shipped figure and the operator's
+ * catalogue would get worse the more they measured. So the vocabulary's `kind` decides
+ * ({@link ../vocabulary.unmeasuredKind}):
+ *
+ * - `nothing-to-measure` (no audio in, no audio out, silent) — a property of the PLUGIN, as
+ *   portable as a measurement. It overrides.
+ * - `probe-failed` (crashed, timed out, refused, non-finite) — a property of THIS RUN. The
+ *   shipped figure stands, and the local failure is still reported
+ *   ({@link MergedPluginMeasurement.localProbeFailed}) so the operator sees that their
+ *   machine could not reproduce it.
+ * - `not-attempted` — a partial run. Not a finding at all.
+ *
+ * An UNKNOWN reason code from a third-party document resolves to `probe-failed`: a word we
+ * cannot interpret must never be allowed to delete a real measurement.
+ */
+import type { CostMeasurement, FeaturesMeasurement, LatencyMeasurement, MeasurementDocument, MeasuredPlugin, MeasurementRun, RtSafetyMeasurement, StabilityMeasurement } from "./format.js";
+import { type MeasurementDimension } from "./vocabulary.js";
+/** Where a figure came from. Two words, because the operator only ever has two questions. */
+export type FigureSource = "local" | "shipped";
+/** Every source, in the order precedence resolves them (highest first). */
+export declare const FIGURE_SOURCES: readonly FigureSource[];
+/** One dimension's resolved figure, with the run that produced it named. */
+export interface ResolvedFigure<T> {
+    readonly source: FigureSource;
+    /** {@link MeasurementRun.id} of the run this came from. */
+    readonly runId: string;
+    /** The run's host, denormalised so a surface can label a figure without a second lookup. */
+    readonly host: string;
+    readonly measuredAt: string;
+    readonly value: T;
+    /** Rates this figure actually covers, ascending. */
+    readonly rates: readonly number[];
+}
+/** One plugin as the merged view sees it. */
+export interface MergedPluginMeasurement {
+    readonly uri: string;
+    /** Best available identity — the local run's, falling back to the shipped one's. */
+    readonly plugin: MeasuredPlugin;
+    readonly latency?: ResolvedFigure<LatencyMeasurement>;
+    readonly cost?: ResolvedFigure<CostMeasurement>;
+    readonly stability?: ResolvedFigure<StabilityMeasurement>;
+    readonly rtSafety?: ResolvedFigure<RtSafetyMeasurement>;
+    readonly features?: ResolvedFigure<FeaturesMeasurement>;
+    /**
+     * Dimensions where the LOCAL run tried and failed (crashed, timed out, refused), keyed
+     * by dimension with the reason code. The shipped figure is still in use for these —
+     * that is the point — but the operator is told their machine could not reproduce it.
+     */
+    readonly localProbeFailed?: Readonly<Partial<Record<MeasurementDimension, string>>>;
+    /** Present only on a plugin installed here that the shipped catalogue never saw. */
+    readonly localOnly?: true;
+}
+/** Counts a Setup screen can render without walking the catalogue itself. */
+export interface MergeSummary {
+    readonly plugins: number;
+    /** Plugins whose figure for this dimension came from each source. */
+    readonly bySource: Readonly<Record<MeasurementDimension, Readonly<Record<FigureSource, number>>>>;
+    /** Plugins with no figure at all for this dimension, from either source. */
+    readonly unresolved: Readonly<Record<MeasurementDimension, number>>;
+    /** Plugins present locally and absent from the shipped catalogue. */
+    readonly localOnly: number;
+    /** Plugins the local run tried and failed on, per dimension. */
+    readonly localProbeFailures: Readonly<Record<MeasurementDimension, number>>;
+}
+/** Each dimension's block type, so a resolved figure keeps the type of the block it holds. */
+interface MeasurementOf {
+    readonly latency: LatencyMeasurement;
+    readonly cost: CostMeasurement;
+    readonly stability: StabilityMeasurement;
+    readonly rtSafety: RtSafetyMeasurement;
+    readonly features: FeaturesMeasurement;
+}
+declare function dimensionOf<D extends MeasurementDimension>(plugin: MeasuredPlugin, dimension: D): MeasurementOf[D] | undefined;
+/**
+ * The merged view an installation reads: shipped defaults with local measurements laid over
+ * them, every figure still knowing where it came from.
+ *
+ * Built once from two documents and then queried — the precedence rule runs at construction,
+ * so no consumer can accidentally re-implement half of it. A missing local document is the
+ * normal state (nobody has measured yet) and yields a view that is entirely `shipped`.
+ */
+export declare class MergedMeasurements {
+    private readonly shipped;
+    private readonly local;
+    private readonly merged;
+    constructor(shipped: MeasurementDocument | undefined, local: MeasurementDocument | undefined);
+    /** The run behind each source, when that source has a document. */
+    runFor(source: FigureSource): MeasurementRun | undefined;
+    /** Every merged plugin, URI-ascending. */
+    all(): MergedPluginMeasurement[];
+    get(uri: string): MergedPluginMeasurement | undefined;
+    get size(): number;
+    /**
+     * Where this plugin's figure for `dimension` came from, or `undefined` when there is no
+     * figure at all. THE question a UI asks per row, so it is one call and not a walk.
+     */
+    sourceOf(uri: string, dimension: MeasurementDimension): FigureSource | undefined;
+    /** Every URI whose `dimension` figure came from `source`, URI-ascending. */
+    urisFrom(source: FigureSource, dimension: MeasurementDimension): string[];
+    /**
+     * Rates in `wanted` this plugin has NO figure for, on the dimension asked about.
+     *
+     * The honest answer to "the rig now runs at 96 kHz too": the rates the resolved figure
+     * does not cover are missing, and a surface should offer to measure them rather than
+     * project across a boundary the data says cannot be projected across.
+     */
+    missingRates(uri: string, dimension: MeasurementDimension, wanted: readonly number[]): number[];
+    /**
+     * Plugins whose resolved figure does not cover every rate in `wanted`, per dimension.
+     * What a "your local run does not cover 96 kHz" banner counts.
+     */
+    pluginsMissingRates(dimension: MeasurementDimension, wanted: readonly number[]): string[];
+    /** The counts a Setup screen renders. */
+    summary(): MergeSummary;
+}
+/** Convenience over the constructor, for call sites that read better as a function. */
+export declare function mergeMeasurements(shipped: MeasurementDocument | undefined, local: MeasurementDocument | undefined): MergedMeasurements;
+/** Re-exported so a consumer of the merge does not also have to import the format. */
+export { dimensionOf as measurementForDimension };

package/dist/measurement/merge.js

@@ -0,0 +1,315 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * **Shipped defaults, overridden by local measurement** — and the operator can
+ * always see which is which.
+ *
+ * The rule is one sentence: *what we ship is a sensible default; a local run overrides it.*
+ * Everything below is what that sentence costs once you refuse to lie about the result.
+ *
+ * ## Why the merge is per plugin per DIMENSION, and not per rate
+ *
+ * The tempting rule — "take the local figure wherever there is one, rate by rate" — would
+ * produce a plugin whose 48 kHz cost came from the customer's NUC and whose 96 kHz cost came
+ * from our reference laptop. The scaling class then gets fitted across two machines, and the
+ * ratio between the two rates, the one thing per-rate data exists to express, becomes an
+ * artefact of the hardware difference. It would look like data and behave like noise.
+ *
+ * So a local run REPLACES a plugin's whole dimension or none of it. A rate the local run did
+ * not cover comes back as MISSING, not as the shipped number wearing a local label
+ * ({@link MergedMeasurements.missingRates}) — which is what a reader wants when the
+ * operator later adds a rate: *"the affected figures are missing rather than wrong — surface
+ * that, and offer to measure the new rate rather than quietly interpolating."*
+ *
+ * ## Why a failed local probe does NOT override
+ *
+ * A local run that crashed on a plugin has learned nothing about that plugin's latency. If
+ * the failure overrode, one segfault would delete a good shipped figure and the operator's
+ * catalogue would get worse the more they measured. So the vocabulary's `kind` decides
+ * ({@link ../vocabulary.unmeasuredKind}):
+ *
+ * - `nothing-to-measure` (no audio in, no audio out, silent) — a property of the PLUGIN, as
+ *   portable as a measurement. It overrides.
+ * - `probe-failed` (crashed, timed out, refused, non-finite) — a property of THIS RUN. The
+ *   shipped figure stands, and the local failure is still reported
+ *   ({@link MergedPluginMeasurement.localProbeFailed}) so the operator sees that their
+ *   machine could not reproduce it.
+ * - `not-attempted` — a partial run. Not a finding at all.
+ *
+ * An UNKNOWN reason code from a third-party document resolves to `probe-failed`: a word we
+ * cannot interpret must never be allowed to delete a real measurement.
+ */
+import { MEASUREMENT_DIMENSIONS, unmeasuredKind } from "./vocabulary.js";
+/** Every source, in the order precedence resolves them (highest first). */
+export const FIGURE_SOURCES = ["local", "shipped"];
+function dimensionOf(plugin, dimension) {
+    const blocks = {
+        latency: plugin.latency,
+        cost: plugin.cost,
+        stability: plugin.stability,
+        rtSafety: plugin.rtSafety,
+        features: plugin.features,
+    };
+    return blocks[dimension];
+}
+/** A merged entry's resolved figure for one dimension. */
+function resolvedOf(entry, dimension) {
+    if (entry === undefined)
+        return undefined;
+    const figures = {
+        latency: entry.latency,
+        cost: entry.cost,
+        stability: entry.stability,
+        rtSafety: entry.rtSafety,
+        features: entry.features,
+    };
+    return figures[dimension];
+}
+/** Rates a measurement actually carries, ascending. Excluded readings still count as
+ *  covered: the rate WAS measured, and the exclusion is the finding. A soak covers the rates
+ *  it rendered, an interposer count the one rate it ran at, and a feature list no rate at all. */
+function ratesOf(measurement) {
+    const keys = "perRate" in measurement
+        ? Object.keys(measurement.perRate)
+        : "soak" in measurement && measurement.soak !== undefined
+            ? Object.keys(measurement.soak.perRate)
+            : "rate" in measurement && measurement.rate !== undefined
+                ? [String(measurement.rate)]
+                : [];
+    return keys
+        .map(Number)
+        .filter((rate) => Number.isFinite(rate))
+        .sort((a, b) => a - b);
+}
+/**
+ * True when a measurement carries a READING rather than only a reason. Per dimension, because
+ * what a reading is differs: latency and cost need a rate; a stability block needs its
+ * lifecycle, an rt-safety block all three counts, a features block its required list.
+ */
+function hasReadings(dimension, measurement) {
+    if (measurement === undefined)
+        return false;
+    switch (dimension) {
+        case "latency":
+        case "cost":
+            return "perRate" in measurement && Object.keys(measurement.perRate).length > 0;
+        case "stability":
+            return "lifecycle" in measurement && measurement.lifecycle !== undefined;
+        case "rtSafety":
+            return ("allocationsInRun" in measurement &&
+                measurement.allocationsInRun !== undefined &&
+                "locksInRun" in measurement &&
+                measurement.locksInRun !== undefined &&
+                "syscallsInRun" in measurement &&
+                measurement.syscallsInRun !== undefined);
+        case "features":
+            return "required" in measurement && measurement.required !== undefined;
+    }
+}
+function figure(source, run, value) {
+    return {
+        source,
+        runId: run.id,
+        host: run.host.hostname,
+        measuredAt: run.measuredAt,
+        value,
+        rates: ratesOf(value),
+    };
+}
+/** `{ [dimension]: figure }` when there is one, `{}` otherwise. */
+function optionalFigure(dimension, value) {
+    if (value === undefined)
+        return {};
+    const out = {};
+    out[dimension] = value;
+    return out;
+}
+/**
+ * The precedence decision for ONE plugin and ONE dimension, expressed once.
+ *
+ * Returns the winning figure, plus the local failure reason when the local run tried and
+ * could not — the two outputs are independent, because "the shipped figure won" and "your
+ * machine crashed on it" are both true at the same time and the operator needs both.
+ */
+function resolveDimension(dimension, local, shipped) {
+    const shippedFigure = shipped?.measurement !== undefined && hasReadings(dimension, shipped.measurement)
+        ? figure("shipped", shipped.run, shipped.measurement)
+        : undefined;
+    if (local === undefined || local.measurement === undefined) {
+        return shippedFigure === undefined ? {} : { resolved: shippedFigure };
+    }
+    // The local run covered this dimension and measured this plugin: it wins outright.
+    if (hasReadings(dimension, local.measurement)) {
+        return { resolved: figure("local", local.run, local.measurement) };
+    }
+    // No readings locally. What the local run learned depends entirely on WHY.
+    const kind = unmeasuredKind(local.measurement.unmeasuredReason);
+    if (kind === "nothing-to-measure") {
+        // A plugin property, as portable as a measurement — it overrides, with no number.
+        return { resolved: figure("local", local.run, local.measurement) };
+    }
+    if (kind === "probe-failed") {
+        return {
+            ...(shippedFigure === undefined ? {} : { resolved: shippedFigure }),
+            ...(local.measurement.unmeasuredReason === undefined
+                ? {}
+                : { localFailure: local.measurement.unmeasuredReason }),
+        };
+    }
+    // not-attempted: the local run has no opinion here.
+    return shippedFigure === undefined ? {} : { resolved: shippedFigure };
+}
+/**
+ * The merged view an installation reads: shipped defaults with local measurements laid over
+ * them, every figure still knowing where it came from.
+ *
+ * Built once from two documents and then queried — the precedence rule runs at construction,
+ * so no consumer can accidentally re-implement half of it. A missing local document is the
+ * normal state (nobody has measured yet) and yields a view that is entirely `shipped`.
+ */
+export class MergedMeasurements {
+    shipped;
+    local;
+    merged;
+    constructor(shipped, local) {
+        this.shipped = shipped;
+        this.local = local;
+        const shippedByUri = new Map((shipped?.plugins ?? []).map((p) => [p.uri, p]));
+        const localByUri = new Map((local?.plugins ?? []).map((p) => [p.uri, p]));
+        const uris = [...new Set([...shippedByUri.keys(), ...localByUri.keys()])].sort();
+        const merged = new Map();
+        for (const uri of uris) {
+            const shippedPlugin = shippedByUri.get(uri);
+            const localPlugin = localByUri.get(uri);
+            const identity = localPlugin ?? shippedPlugin;
+            if (identity === undefined)
+                continue;
+            const resolve = (dimension) => resolveDimension(dimension, local !== undefined && localPlugin !== undefined
+                ? { run: local.run, measurement: dimensionOf(localPlugin, dimension) }
+                : undefined, shipped !== undefined && shippedPlugin !== undefined
+                ? { run: shipped.run, measurement: dimensionOf(shippedPlugin, dimension) }
+                : undefined);
+            const latency = resolve("latency");
+            const cost = resolve("cost");
+            const stability = resolve("stability");
+            const rtSafety = resolve("rtSafety");
+            const features = resolve("features");
+            const failures = {};
+            const outcomes = { latency, cost, stability, rtSafety, features };
+            for (const dimension of MEASUREMENT_DIMENSIONS) {
+                const failure = outcomes[dimension].localFailure;
+                if (failure !== undefined)
+                    failures[dimension] = failure;
+            }
+            merged.set(uri, {
+                uri,
+                plugin: identity,
+                ...optionalFigure("latency", latency.resolved),
+                ...optionalFigure("cost", cost.resolved),
+                ...optionalFigure("stability", stability.resolved),
+                ...optionalFigure("rtSafety", rtSafety.resolved),
+                ...optionalFigure("features", features.resolved),
+                ...(Object.keys(failures).length > 0 ? { localProbeFailed: failures } : {}),
+                ...(shippedPlugin === undefined ? { localOnly: true } : {}),
+            });
+        }
+        this.merged = merged;
+    }
+    /** The run behind each source, when that source has a document. */
+    runFor(source) {
+        return source === "local" ? this.local?.run : this.shipped?.run;
+    }
+    /** Every merged plugin, URI-ascending. */
+    all() {
+        return [...this.merged.values()];
+    }
+    get(uri) {
+        return this.merged.get(uri);
+    }
+    get size() {
+        return this.merged.size;
+    }
+    /**
+     * Where this plugin's figure for `dimension` came from, or `undefined` when there is no
+     * figure at all. THE question a UI asks per row, so it is one call and not a walk.
+     */
+    sourceOf(uri, dimension) {
+        return resolvedOf(this.merged.get(uri), dimension)?.source;
+    }
+    /** Every URI whose `dimension` figure came from `source`, URI-ascending. */
+    urisFrom(source, dimension) {
+        return this.all()
+            .filter((entry) => resolvedOf(entry, dimension)?.source === source)
+            .map((entry) => entry.uri);
+    }
+    /**
+     * Rates in `wanted` this plugin has NO figure for, on the dimension asked about.
+     *
+     * The honest answer to "the rig now runs at 96 kHz too": the rates the resolved figure
+     * does not cover are missing, and a surface should offer to measure them rather than
+     * project across a boundary the data says cannot be projected across.
+     */
+    missingRates(uri, dimension, wanted) {
+        const resolved = resolvedOf(this.merged.get(uri), dimension);
+        if (resolved === undefined)
+            return [...wanted].sort((a, b) => a - b);
+        const covered = new Set(resolved.rates);
+        return wanted.filter((rate) => !covered.has(rate)).sort((a, b) => a - b);
+    }
+    /**
+     * Plugins whose resolved figure does not cover every rate in `wanted`, per dimension.
+     * What a "your local run does not cover 96 kHz" banner counts.
+     */
+    pluginsMissingRates(dimension, wanted) {
+        return this.all()
+            .filter((entry) => {
+            const resolved = resolvedOf(entry, dimension);
+            // A plugin with nothing to measure is not missing a rate; it has a reason.
+            if (resolved !== undefined && resolved.value.unmeasuredReason !== undefined)
+                return false;
+            return this.missingRates(entry.uri, dimension, wanted).length > 0;
+        })
+            .map((entry) => entry.uri);
+    }
+    /** The counts a Setup screen renders. */
+    summary() {
+        const zeroes = () => ({
+            latency: 0,
+            cost: 0,
+            stability: 0,
+            rtSafety: 0,
+            features: 0,
+        });
+        const bySource = {
+            latency: { local: 0, shipped: 0 },
+            cost: { local: 0, shipped: 0 },
+            stability: { local: 0, shipped: 0 },
+            rtSafety: { local: 0, shipped: 0 },
+            features: { local: 0, shipped: 0 },
+        };
+        const unresolved = zeroes();
+        const localProbeFailures = zeroes();
+        let localOnly = 0;
+        for (const entry of this.merged.values()) {
+            if (entry.localOnly === true)
+                localOnly += 1;
+            for (const dimension of MEASUREMENT_DIMENSIONS) {
+                const resolved = resolvedOf(entry, dimension);
+                if (resolved === undefined)
+                    unresolved[dimension] += 1;
+                else
+                    bySource[dimension][resolved.source] += 1;
+                if (entry.localProbeFailed?.[dimension] !== undefined)
+                    localProbeFailures[dimension] += 1;
+            }
+        }
+        return { plugins: this.merged.size, bySource, unresolved, localOnly, localProbeFailures };
+    }
+}
+/** Convenience over the constructor, for call sites that read better as a function. */
+export function mergeMeasurements(shipped, local) {
+    return new MergedMeasurements(shipped, local);
+}
+/** Re-exported so a consumer of the merge does not also have to import the format. */
+export { dimensionOf as measurementForDimension };
+//# sourceMappingURL=merge.js.map

package/dist/measurement/merge.js.map

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