@openmixer/plugin-qualify 0.4.1 → 0.5.1

package/src/measurement/sweep-jsonl.ts

@@ -29,7 +29,7 @@ import type {
   SoakReading,
   StabilityMeasurement,
 } from "./format.js";
-import { readLifecycle, readSoakAtRate, readThreads } from "./format.js";
+import { readIntegrity, readLifecycle, readSoakAtRate, readThreads } from "./format.js";
 import { booleanValue, finiteNumber, isRecord, mapArray, nonEmptyString, optional, positiveNumber } from "./guards.js";
 
 /** The sweep's three passes, each a list of parsed JSONL lines. Only `measurements` is required. */
@@ -150,6 +150,7 @@ export function measuredPluginsFromSweep(passes: SweepPasses): MeasuredPlugin[]
     if (uri === undefined || audioInputs === undefined || audioOutputs === undefined) continue;
     out.push({
       uri,
+      ...optional("version", nonEmptyString(row.version)),
       topology: {
         audioInputs,
         audioOutputs,
@@ -158,6 +159,7 @@ export function measuredPluginsFromSweep(passes: SweepPasses): MeasuredPlugin[]
       stability: stabilityOf(row, deep.get(uri), soak.get(uri)),
       rtSafety: rtSafetyOf(row),
       features: featuresOf(row),
+      ...optional("integrity", readIntegrity(row.integrity)),
     });
   }
   return out;

package/src/measurement/vocabulary.ts

@@ -77,6 +77,13 @@ export const UNMEASURED_TERMS: readonly UnmeasuredTerm[] = [
     kind: "nothing-to-measure",
     description: "A convolver requiring an IR file the prober did not load.",
   },
+  {
+    code: "unpinnable",
+    kind: "nothing-to-measure",
+    description:
+      "The files the host loads cannot be pinned (plugin-qualify spec §11.1): a path holding ',', '=' or " +
+      "whitespace, or a manifest using @base or a percent-encoded IRI. The plugin stays unpinned, never partly pinned.",
+  },
   {
     code: "refused-instantiation",
     kind: "probe-failed",

package/src/qualify-declarations.ts

@@ -53,11 +53,23 @@ export const CLAP_SCAN_TIMEOUT_S = 300;
 
 /**
  * The CLAP prober (`native/clap-qualify.c`) and the interposer it runs under (`native/rt-interpose.c`):
- * each located by one environment variable, else the package's own build in `native/build/`.
+ * each located by one environment variable, else the first of `NATIVE_TOOL_DIRS` that holds it, else
+ * the package's own build in `native/build/`.
  */
 export const CLAP_QUALIFY_TOOL_ENV = "OMX_CLAP_QUALIFY";
 export const RT_INTERPOSE_ENV = "OMX_RT_INTERPOSE";
 
+/** The file names of the prober and the interposer, in every place they are looked for. */
+export const CLAP_QUALIFY_TOOL_NAME = "clap-qualify";
+export const RT_INTERPOSE_NAME = "rt_interpose.so";
+
+/**
+ * Where the RPM and the DEB install the prober and the interposer: the libexec directory on Fedora,
+ * `/usr/lib/<package>` on Debian (policy keeps a package's private programs there). The packaging
+ * installs into exactly these; a test holds the spec and `debian/rules` to them.
+ */
+export const NATIVE_TOOL_DIRS: readonly string[] = ["/usr/libexec/plugin-qualify", "/usr/lib/plugin-qualify"];
+
 /** The CLAP sweep: blocks of `CLAP_SWEEP_FRAMES` frames per rate, every parameter moved through events. */
 export const CLAP_SWEEP_BLOCKS = 512;
 export const CLAP_SWEEP_FRAMES = 512;

package/src/tool-paths.ts

@@ -5,8 +5,11 @@
  * wherever it is installed (a checkout, an RPM's bundled node_modules, a pnpm store). The
  * tools are shipped RUNTIME artefacts, not dev scripts.
  */
+import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 
+import { CLAP_QUALIFY_TOOL_NAME, NATIVE_TOOL_DIRS, RT_INTERPOSE_NAME } from "./qualify-declarations.js";
+
 /**
  * `tools/` — `scan.py`, `benchmark.py`, `lv2-measure.mjs`, `hosting-sweep.mjs`. Resolved when a
  * console asks, never at import: a consumer that only reads this package's declarations from a
@@ -21,12 +24,22 @@ export function lv2MeasureToolPath(): string {
   return fileURLToPath(new URL("../tools/lv2-measure.mjs", import.meta.url));
 }
 
+/** The package's own build of the native tools (`make -C native`). */
+function nativeBuildDir(): string {
+  return fileURLToPath(new URL("../native/build/", import.meta.url));
+}
+
 /** The package's own build of the CLAP prober (`make -C native`). */
 export function clapQualifyToolPath(): string {
-  return fileURLToPath(new URL("../native/build/clap-qualify", import.meta.url));
+  return join(nativeBuildDir(), CLAP_QUALIFY_TOOL_NAME);
 }
 
 /** The package's own build of the interposer the CLAP prober runs under. */
 export function rtInterposePath(): string {
-  return fileURLToPath(new URL("../native/build/rt_interpose.so", import.meta.url));
+  return join(nativeBuildDir(), RT_INTERPOSE_NAME);
+}
+
+/** Where a native tool is looked for when no setting names it, in order: the installed directories, then the own build. */
+export function nativeToolCandidates(name: string): string[] {
+  return [...NATIVE_TOOL_DIRS, nativeBuildDir()].map((dir) => join(dir, name));
 }