@openmixer/plugin-qualify 0.0.0-stage → 0.3.0

package/dist/qualify-declarations.js

@@ -0,0 +1,76 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * EVERY NUMBER plugin-qualify uses, declared once. The CLI's defaults and `--help`, the rating, and the Python tools (through the generated
+ * `tools/_declarations.py`) all READ these; a consumer holding its own copy is what the package's
+ * perturbation test catches (R-094).
+ */
+/**
+ * The reference rate cost is quoted at: the rig's rate, 96 kHz.
+ */
+export const COST_REFERENCE_RATE = 96000;
+/**
+ * The reference quantum in frames: the rig's buffer, and the block `benchmark.py` runs.
+ */
+export const QUANTUM_FRAMES = 1024;
+/** The rate the offline capture window is sized at; other rates scale from it. */
+export const MEASURE_BASE_RATE = 48000;
+/**
+ * The lowest rate the console runs a show at. A reading below it is informational for the scaling
+ * class: kept in `perRate` and served at its own rate, but never alone enough to flag a plugin
+ * `nonconforming` (`lv2-measurement-interchange.md` §1a).
+ */
+export const OPERATIONAL_RATE_FLOOR = 48000;
+/** The rates a run measures when `--rates` is not given — recorded in `run.rates`. */
+export const QUALIFY_RATES = [44100, MEASURE_BASE_RATE, COST_REFERENCE_RATE, 192000];
+/** The quanta (frames) a run rates cost at when `--quanta` is not given. */
+export const QUALIFY_QUANTA = [128, 256, 512, QUANTUM_FRAMES];
+/** Seconds one plugin's offline pass may take before its worker is killed and it reads as a timeout. */
+export const PLUGIN_TIMEOUT_S = 15;
+/** Seconds the offline worker may take to start (lilv world load on a large LV2_PATH). */
+export const BOOT_TIMEOUT_S = 120;
+/** Seconds one plugin's cost pass may take (a sustained tone runs longer than an impulse). */
+export const COST_TIMEOUT_S = 60;
+/**
+ * The ONE setting that locates the CLAP scanner (spec §7): the environment variable that names
+ * the `omx-clap-scan` binary, and what is run when it is unset (looked up on `PATH`).
+ */
+export const CLAP_SCAN_TOOL_ENV = "OMX_CLAP_SCAN";
+export const CLAP_SCAN_TOOL_DEFAULT = "omx-clap-scan";
+/** Seconds one run of the CLAP scanner may take over everything it was pointed at. */
+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/`.
+ */
+export const CLAP_QUALIFY_TOOL_ENV = "OMX_CLAP_QUALIFY";
+export const RT_INTERPOSE_ENV = "OMX_RT_INTERPOSE";
+/** 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;
+/** Seconds one `.clap` may take to qualify at every rate before the prober is killed. */
+export const CLAP_QUALIFY_TIMEOUT_S = 120;
+/**
+ * Defaults. The cycle floor is the operator's ruling 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.
+ */
+export const DEFAULT_HOSTING_POLICY = {
+    cycleFloor: 1000,
+    soakSeconds: 3 * 60 * 60,
+    costTailRatioCeiling: 4,
+    soakDeadDropDb: 40,
+};
+/**
+ * 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.
+ */
+export const HOST_BUDGETS = {
+    "openmixer-console": { coreFractionCeiling: 0.05, rate: COST_REFERENCE_RATE, quantum: QUANTUM_FRAMES },
+    jalv: { coreFractionCeiling: 0.25, rate: MEASURE_BASE_RATE, quantum: 256 },
+    "mod-host": { coreFractionCeiling: 0.05, rate: MEASURE_BASE_RATE, quantum: 128 },
+};
+//# sourceMappingURL=qualify-declarations.js.map

package/dist/qualify-declarations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualify-declarations.js","sourceRoot":"","sources":["../src/qualify-declarations.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC,kFAAkF;AAClF,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEvC;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AAE5C,sFAAsF;AACtF,MAAM,CAAC,MAAM,aAAa,GAAsB,CAAC,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,CAAC,CAAC;AAExG,4EAA4E;AAC5E,MAAM,CAAC,MAAM,cAAc,GAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;AAEjF,wGAAwG;AACxG,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAEnC,0FAA0F;AAC1F,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAElC,8FAA8F;AAC9F,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC;AAEjC;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAClD,MAAM,CAAC,MAAM,sBAAsB,GAAG,eAAe,CAAC;AAEtD,sFAAsF;AACtF,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AACxD,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAEnD,2GAA2G;AAC3G,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAErC,yFAAyF;AACzF,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAsB1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE;IACxB,oBAAoB,EAAE,CAAC;IACvB,cAAc,EAAE,EAAE;CACnB,CAAC;AAOF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,mBAAmB,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,cAAc,EAAE;IACtG,IAAI,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,GAAG,EAAE;IAC1E,UAAU,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,GAAG,EAAE;CACzB,CAAC"}

package/dist/qualify-options.d.ts

@@ -0,0 +1,22 @@
+/** How the result is printed. `text` = plugin, verdict, the reason that decided it. */
+export declare const OUTPUT_FORMATS: readonly ["json", "text"];
+export type OutputFormat = (typeof OUTPUT_FORMATS)[number];
+/** The exit codes, as the spec states them. */
+export declare const EXIT_CODE: {
+    /** Every named plugin rated `suitable`. */
+    readonly allQualified: 0;
+    /** At least one plugin measured and rated below `suitable`. */
+    readonly someNotQualified: 1;
+    /** A plugin could not be measured, or the arguments/targets could not be resolved. */
+    readonly couldNotMeasure: 2;
+};
+export interface QualifyOption {
+    /** `--rates`; a positional is not an option. */
+    readonly flag: string;
+    /** The value's name when the option takes one. */
+    readonly value?: string;
+    readonly describe: string;
+    /** The declared default, printed by `--help` — absent for a switch. */
+    readonly default?: string;
+}
+export declare const QUALIFY_OPTIONS: readonly QualifyOption[];

package/dist/qualify-options.js

@@ -0,0 +1,36 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * The `plugin-qualify` CLI's OPTIONS, declared once. The parser, `--help` and the tests all read this table; every default is a declaration
+ * from `declarations.ts`, never a literal here.
+ */
+import { QUALIFY_QUANTA, QUALIFY_RATES } from "./qualify-declarations.js";
+import { HOST_PROFILES, OPENMIXER_CONSOLE_PROFILE } from "./host-profiles.js";
+/** How the result is printed. `text` = plugin, verdict, the reason that decided it. */
+export const OUTPUT_FORMATS = ["json", "text"];
+/** The exit codes, as the spec states them. */
+export const EXIT_CODE = {
+    /** Every named plugin rated `suitable`. */
+    allQualified: 0,
+    /** At least one plugin measured and rated below `suitable`. */
+    someNotQualified: 1,
+    /** A plugin could not be measured, or the arguments/targets could not be resolved. */
+    couldNotMeasure: 2,
+};
+export const QUALIFY_OPTIONS = [
+    { flag: "--all", describe: "every plugin lilv finds (LV2_PATH honoured)" },
+    { flag: "--rates", value: "list", describe: "sample rates to measure at, comma-separated", default: QUALIFY_RATES.join(",") },
+    { flag: "--quanta", value: "list", describe: "quanta (frames) to rate cost at, comma-separated", default: QUALIFY_QUANTA.join(",") },
+    { flag: "--out", value: "dir", describe: "write one interchange JSON document per run into this directory" },
+    { flag: "--format", value: OUTPUT_FORMATS.join("|"), describe: "json = the verdicts as JSON; text = plugin, verdict, deciding reason", default: "text" },
+    { flag: "--isolate", describe: "a fresh worker per plugin, so a crash or hang takes only that plugin" },
+    { flag: "--no-host-sweep", describe: "offline lilv measurement only; no mod-host hosting sweep" },
+    {
+        flag: "--host-profile",
+        value: "file|id",
+        describe: `judge against this host (${HOST_PROFILES.map((p) => p.id).join(", ")}, or a profile JSON file); repeat or comma-separate for one verdict per profile`,
+        default: OPENMIXER_CONSOLE_PROFILE.id,
+    },
+    { flag: "--help", describe: "this text" },
+];
+//# sourceMappingURL=qualify-options.js.map

package/dist/qualify-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qualify-options.js","sourceRoot":"","sources":["../src/qualify-options.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,uFAAuF;AACvF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC;AAGxD,+CAA+C;AAC/C,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,2CAA2C;IAC3C,YAAY,EAAE,CAAC;IACf,+DAA+D;IAC/D,gBAAgB,EAAE,CAAC;IACnB,sFAAsF;IACtF,eAAe,EAAE,CAAC;CACV,CAAC;AAYX,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,6CAA6C,EAAE;IAC1E,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,6CAA6C,EAAE,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;IAC7H,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,kDAAkD,EAAE,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;IACpI,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,iEAAiE,EAAE;IAC5G,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,sEAAsE,EAAE,OAAO,EAAE,MAAM,EAAE;IACxJ,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,sEAAsE,EAAE;IACvG,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,0DAA0D,EAAE;IACjG;QACE,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,4BAA4B,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,iFAAiF;QAChK,OAAO,EAAE,yBAAyB,CAAC,EAAE;KACtC;IACD,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE;CAC1C,CAAC"}

package/dist/rating.d.ts

@@ -0,0 +1,32 @@
+import type { VerdictRating } from "./measurement/vocabulary.js";
+/**
+ * How well a plugin fits a destination role. The four words are the interchange's
+ * (`VERDICT_RATINGS`, `measurement/vocabulary.ts`), so a written verdict speaks this vocabulary.
+ *
+ * - `suitable` — every dimension resolved and inside its budget.
+ * - `conditional` — nothing objectively disqualifies it, but something needs the operator's
+ *   attention: a taste warning, a topology difference, a look-ahead control that can be
+ *   turned up past the budget, a cost that eats most of the allowance.
+ * - `unknown` — an OBJECTIVE dimension could not be decided because the measurement is
+ *   missing or does not resolve at this rate. Not a pass and not a failure: an admission.
+ * - `unsuitable` — an objective dimension failed on measured evidence.
+ */
+export type SuitabilityRating = VerdictRating;
+/**
+ * Severity order for folding several reasons into one verdict:
+ * `unsuitable` > `unknown` > `conditional` > `suitable`.
+ *
+ * `unknown` outranks `conditional` on purpose. A conditional plugin is one the console has
+ * fully measured and has an opinion about; an unknown one is a plugin the console cannot
+ * vouch for at all. Reporting "there is a caution" while an objective dimension is
+ * un-measured would present the smaller finding as the whole story.
+ */
+export declare const RATING_SEVERITY: Readonly<Record<SuitabilityRating, number>>;
+/** The worst (most severe) of some ratings; `suitable` for an empty list. */
+export declare function worstRating(ratings: readonly SuitabilityRating[]): SuitabilityRating;
+/**
+ * Physics or taste. The distinction drives what a reason is ALLOWED to do
+ * (`contributedRating` in the catalog, `contributedHostingRating` here) and, downstream, whether an operator override is a formality
+ * or a decision — conflating them is how a tool becomes either nagging or dangerous.
+ */
+export type SuitabilityKind = "objective" | "advisory";

package/dist/rating.js

@@ -0,0 +1,30 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+//
+// The rating vocabulary every verdict speaks: four ratings, their severity order, the
+// worst-wins fold, and whether a reason is physics or taste.
+/**
+ * Severity order for folding several reasons into one verdict:
+ * `unsuitable` > `unknown` > `conditional` > `suitable`.
+ *
+ * `unknown` outranks `conditional` on purpose. A conditional plugin is one the console has
+ * fully measured and has an opinion about; an unknown one is a plugin the console cannot
+ * vouch for at all. Reporting "there is a caution" while an objective dimension is
+ * un-measured would present the smaller finding as the whole story.
+ */
+export const RATING_SEVERITY = {
+    suitable: 0,
+    conditional: 1,
+    unknown: 2,
+    unsuitable: 3,
+};
+/** The worst (most severe) of some ratings; `suitable` for an empty list. */
+export function worstRating(ratings) {
+    let worst = "suitable";
+    for (const rating of ratings) {
+        if (RATING_SEVERITY[rating] > RATING_SEVERITY[worst])
+            worst = rating;
+    }
+    return worst;
+}
+//# sourceMappingURL=rating.js.map

package/dist/rating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rating.js","sourceRoot":"","sources":["../src/rating.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD,EAAE;AACF,sFAAsF;AACtF,6DAA6D;AAkB7D;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,eAAe,GAAgD;IAC1E,QAAQ,EAAE,CAAC;IACX,WAAW,EAAE,CAAC;IACd,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,CAAC;CACd,CAAC;AAEF,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CAAC,OAAqC;IAC/D,IAAI,KAAK,GAAsB,UAAU,CAAC;IAC1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,eAAe,CAAC,MAAM,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC;YAAE,KAAK,GAAG,MAAM,CAAC;IACvE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/tool-paths.d.ts

@@ -0,0 +1,12 @@
+/**
+ * `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
+ * browser-like module graph (web-ui's conformance suites, `http:` module URLs) must load it.
+ */
+export declare function toolsDir(): string;
+/** The measurement runner a console spawns for Setup > Plugin analysis. */
+export declare function lv2MeasureToolPath(): string;
+/** The package's own build of the CLAP prober (`make -C native`). */
+export declare function clapQualifyToolPath(): string;
+/** The package's own build of the interposer the CLAP prober runs under. */
+export declare function rtInterposePath(): string;

package/dist/tool-paths.js

@@ -0,0 +1,29 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * Where the package's own tools live, resolved from this module so it follows the package
+ * 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 { fileURLToPath } from "node:url";
+/**
+ * `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
+ * browser-like module graph (web-ui's conformance suites, `http:` module URLs) must load it.
+ */
+export function toolsDir() {
+    return fileURLToPath(new URL("../tools/", import.meta.url));
+}
+/** The measurement runner a console spawns for Setup > Plugin analysis. */
+export function lv2MeasureToolPath() {
+    return fileURLToPath(new URL("../tools/lv2-measure.mjs", import.meta.url));
+}
+/** The package's own build of the CLAP prober (`make -C native`). */
+export function clapQualifyToolPath() {
+    return fileURLToPath(new URL("../native/build/clap-qualify", import.meta.url));
+}
+/** The package's own build of the interposer the CLAP prober runs under. */
+export function rtInterposePath() {
+    return fileURLToPath(new URL("../native/build/rt_interpose.so", import.meta.url));
+}
+//# sourceMappingURL=tool-paths.js.map

package/dist/tool-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-paths.js","sourceRoot":"","sources":["../src/tool-paths.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;GAIG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB;IAChC,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,0BAA0B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,mBAAmB;IACjC,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,8BAA8B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe;IAC7B,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,iCAAiC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACpF,CAAC"}

package/fixtures/clap-scan/controls.json

@@ -0,0 +1,8 @@
+{"scanner":"clap-qualify","version":"1","files":[
+{"path":"controls.clap","plugins":[
+{"id":"org.freemixer.plugin-qualify.fixture.controls","name":"controls","vendor":"plugin-qualify","version":"1","description":"plugin-qualify fixture","url":"","features":["audio-effect"],"params":[
+{"id":3,"name":"shape","module":"Oscillator","min":0,"max":2,"default":0,"flags":["stepped","automatable","enum"],"labels":[{"value":0,"label":"Sine"},{"value":1,"label":"Square"},{"value":2,"label":"Saw"}]},
+{"id":5,"name":"cutoff","module":"Filter/Envelope","min":20,"max":20000,"default":1000,"flags":["automatable"]}
+],"remote_controls":[{"id":7,"section":"Main","name":"Performance","params":[5,3,null,null,null,null,null,null],"forPreset":false}],"audio_ports":{"inputs":[{"id":0,"name":"in","role":"main","channels":2}],"outputs":[{"id":0,"name":"out","role":"main","channels":2}]},"note_ports":{"inputs":0,"outputs":0}}
+]}
+]}

package/fixtures/clap-scan/fake.json

@@ -0,0 +1,16 @@
+{"scanner":"omx-clap-scan","version":"0.1.0","files":[
+{"path":"fake.clap","plugins":[
+{"id":"org.omx-clap-host.test.wide","name":"wide","vendor":"omx-clap-host","version":"0","description":"wide","url":"","features":["audio-effect"],"params":[
+{"id":0,"name":"latency","module":"","min":0,"max":4096,"default":64,"flags":["stepped"]}
+],"audio_ports":{"inputs":[{"id":0,"name":"in 0","role":"main","channels":4}],"outputs":[{"id":0,"name":"out 0","role":"main","channels":4}]},"note_ports":{"inputs":0,"outputs":0},"latency":64},
+{"id":"org.omx-clap-host.test.sidechain","name":"sidechain","vendor":"omx-clap-host","version":"0","description":"sidechain","url":"","features":["audio-effect"],"params":[
+{"id":0,"name":"latency","module":"","min":0,"max":4096,"default":64,"flags":["stepped"]}
+],"audio_ports":{"inputs":[{"id":0,"name":"in 0","role":"main","channels":2},{"id":1,"name":"in 1","role":"aux","channels":1}],"outputs":[{"id":0,"name":"out 0","role":"main","channels":2}]},"note_ports":{"inputs":0,"outputs":0},"latency":64},
+{"id":"org.omx-clap-host.test.notes","name":"notes","vendor":"omx-clap-host","version":"0","description":"notes","url":"","features":["audio-effect"],"params":[
+{"id":0,"name":"latency","module":"","min":0,"max":4096,"default":64,"flags":["stepped"]}
+],"audio_ports":{"inputs":[{"id":0,"name":"in 0","role":"main","channels":2}],"outputs":[{"id":0,"name":"out 0","role":"main","channels":2}]},"note_ports":{"inputs":1,"outputs":0},"latency":64},
+{"id":"org.omx-clap-host.test.passthrough","name":"passthrough","vendor":"omx-clap-host","version":"0","description":"passthrough","url":"","features":["audio-effect"],"params":[
+{"id":0,"name":"latency","module":"","min":0,"max":4096,"default":64,"flags":["stepped"]}
+],"audio_ports":{"inputs":[{"id":0,"name":"in 0","role":"main","channels":2}],"outputs":[{"id":0,"name":"out 0","role":"main","channels":2}]},"note_ports":{"inputs":0,"outputs":0},"latency":64}
+]}
+]}

package/fixtures/clap-scan/mixed.json

@@ -0,0 +1,18 @@
+{"scanner":"omx-clap-scan","version":"0.1.0","files":[
+{"path":"./a_crash.clap","error":"crashed with signal 6 (Aborted)"},
+{"path":"./broken.clap","error":"can't open ./broken.clap: ./broken.clap: file too short"},
+{"path":"./fake.clap","plugins":[
+{"id":"org.omx-clap-host.test.wide","name":"wide","vendor":"omx-clap-host","version":"0","description":"wide","url":"","features":["audio-effect"],"params":[
+{"id":0,"name":"latency","module":"","min":0,"max":4096,"default":64,"flags":["stepped"]}
+],"audio_ports":{"inputs":[{"id":0,"name":"in 0","role":"main","channels":4}],"outputs":[{"id":0,"name":"out 0","role":"main","channels":4}]},"note_ports":{"inputs":0,"outputs":0},"latency":64},
+{"id":"org.omx-clap-host.test.sidechain","name":"sidechain","vendor":"omx-clap-host","version":"0","description":"sidechain","url":"","features":["audio-effect"],"params":[
+{"id":0,"name":"latency","module":"","min":0,"max":4096,"default":64,"flags":["stepped"]}
+],"audio_ports":{"inputs":[{"id":0,"name":"in 0","role":"main","channels":2},{"id":1,"name":"in 1","role":"aux","channels":1}],"outputs":[{"id":0,"name":"out 0","role":"main","channels":2}]},"note_ports":{"inputs":0,"outputs":0},"latency":64},
+{"id":"org.omx-clap-host.test.notes","name":"notes","vendor":"omx-clap-host","version":"0","description":"notes","url":"","features":["audio-effect"],"params":[
+{"id":0,"name":"latency","module":"","min":0,"max":4096,"default":64,"flags":["stepped"]}
+],"audio_ports":{"inputs":[{"id":0,"name":"in 0","role":"main","channels":2}],"outputs":[{"id":0,"name":"out 0","role":"main","channels":2}]},"note_ports":{"inputs":1,"outputs":0},"latency":64},
+{"id":"org.omx-clap-host.test.passthrough","name":"passthrough","vendor":"omx-clap-host","version":"0","description":"passthrough","url":"","features":["audio-effect"],"params":[
+{"id":0,"name":"latency","module":"","min":0,"max":4096,"default":64,"flags":["stepped"]}
+],"audio_ports":{"inputs":[{"id":0,"name":"in 0","role":"main","channels":2}],"outputs":[{"id":0,"name":"out 0","role":"main","channels":2}]},"note_ports":{"inputs":0,"outputs":0},"latency":64}
+]}
+]}

package/fixtures/zero-path.lv2/manifest.ttl

@@ -0,0 +1,3 @@
+@prefix lv2: <http://lv2plug.in/ns/lv2core#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+<urn:openmixer:eval:zero-path> a lv2:Plugin ; lv2:binary <zero-path.so> ; rdfs:seeAlso <zero-path.ttl> .

package/fixtures/zero-path.lv2/zero-path.c

@@ -0,0 +1,85 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/* Evaluation fixture: an audio
+ * pass-through that emits, on its notify port, a patch:Set whose value is an atom:Path of body
+ * size ZERO — what NAM does with no model loaded (mod-host PR #98, 7e1f143). Emitted on the first
+ * cycle after activate and then every 32 cycles, so a racked instance keeps feeding mod-host's
+ * feedback relay (RunPostPonedEvents, POSTPONED_PROCESS_OUTPUT_BUFFER). */
+#include <stdlib.h>
+#include <string.h>
+#include <lv2/core/lv2.h>
+#include <lv2/atom/atom.h>
+#include <lv2/atom/forge.h>
+#include <lv2/atom/util.h>
+#include <lv2/patch/patch.h>
+#include <lv2/urid/urid.h>
+
+#define ZP_URI "urn:openmixer:eval:zero-path"
+enum { P_CONTROL = 0, P_NOTIFY = 1, P_IN = 2, P_OUT = 3 };
+
+typedef struct {
+    const LV2_Atom_Sequence *control;
+    LV2_Atom_Sequence *notify;
+    const float *in;
+    float *out;
+    LV2_Atom_Forge forge;
+    LV2_URID patch_Set, patch_property, patch_value, atom_Path, model;
+    unsigned cycle;
+} Z;
+
+static LV2_Handle instantiate(const LV2_Descriptor *d, double rate, const char *path,
+                              const LV2_Feature *const *features)
+{
+    LV2_URID_Map *map = NULL;
+    for (int i = 0; features[i]; i++)
+        if (!strcmp(features[i]->URI, LV2_URID__map)) map = features[i]->data;
+    if (!map) return NULL;
+    Z *z = calloc(1, sizeof(Z));
+    lv2_atom_forge_init(&z->forge, map);
+    z->patch_Set = map->map(map->handle, LV2_PATCH__Set);
+    z->patch_property = map->map(map->handle, LV2_PATCH__property);
+    z->patch_value = map->map(map->handle, LV2_PATCH__value);
+    z->atom_Path = map->map(map->handle, LV2_ATOM__Path);
+    z->model = map->map(map->handle, ZP_URI "#model");
+    (void)d; (void)rate; (void)path;
+    return z;
+}
+
+static void connect_port(LV2_Handle h, uint32_t port, void *data)
+{
+    Z *z = h;
+    switch (port) {
+    case P_CONTROL: z->control = data; break;
+    case P_NOTIFY: z->notify = data; break;
+    case P_IN: z->in = data; break;
+    case P_OUT: z->out = data; break;
+    }
+}
+
+static void activate(LV2_Handle h) { ((Z *)h)->cycle = 0; }
+
+static void run(LV2_Handle h, uint32_t n)
+{
+    Z *z = h;
+    if (z->in && z->out) memmove(z->out, z->in, n * sizeof(float));
+    if (!z->notify) return;
+    const uint32_t cap = z->notify->atom.size;
+    lv2_atom_forge_set_buffer(&z->forge, (uint8_t *)z->notify, cap);
+    LV2_Atom_Forge_Frame seq, obj;
+    lv2_atom_forge_sequence_head(&z->forge, &seq, 0);
+    if (z->cycle++ % 32 == 0) {
+        lv2_atom_forge_frame_time(&z->forge, 0);
+        lv2_atom_forge_object(&z->forge, &obj, 0, z->patch_Set);
+        lv2_atom_forge_key(&z->forge, z->patch_property);
+        lv2_atom_forge_urid(&z->forge, z->model);
+        lv2_atom_forge_key(&z->forge, z->patch_value);
+        lv2_atom_forge_atom(&z->forge, 0, z->atom_Path);   /* the zero-size body */
+        lv2_atom_forge_pop(&z->forge, &obj);
+    }
+    lv2_atom_forge_pop(&z->forge, &seq);
+}
+
+static void cleanup(LV2_Handle h) { free(h); }
+
+static const LV2_Descriptor desc = { ZP_URI, instantiate, connect_port, activate, run, NULL, cleanup, NULL };
+LV2_SYMBOL_EXPORT const LV2_Descriptor *lv2_descriptor(uint32_t i) { return i == 0 ? &desc : NULL; }

package/fixtures/zero-path.lv2/zero-path.ttl

@@ -0,0 +1,21 @@
+@prefix atom: <http://lv2plug.in/ns/ext/atom#> .
+@prefix doap: <http://usefulinc.com/ns/doap#> .
+@prefix lv2:  <http://lv2plug.in/ns/lv2core#> .
+@prefix patch: <http://lv2plug.in/ns/ext/patch#> .
+@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+@prefix urid: <http://lv2plug.in/ns/ext/urid#> .
+
+<urn:openmixer:eval:zero-path#model> a lv2:Parameter ; rdfs:label "model" ; rdfs:range atom:Path .
+
+<urn:openmixer:eval:zero-path> a lv2:Plugin , lv2:UtilityPlugin ;
+  doap:name "omx eval zero-size Path" ; lv2:requiredFeature urid:map ;
+  patch:writable <urn:openmixer:eval:zero-path#model> ;
+  patch:readable <urn:openmixer:eval:zero-path#model> ;
+  lv2:port [ a lv2:InputPort , atom:AtomPort ; atom:bufferType atom:Sequence ;
+             atom:supports patch:Message ; lv2:designation lv2:control ;
+             lv2:index 0 ; lv2:symbol "control" ; lv2:name "Control" ] ,
+           [ a lv2:OutputPort , atom:AtomPort ; atom:bufferType atom:Sequence ;
+             atom:supports patch:Message ; lv2:designation lv2:control ;
+             lv2:index 1 ; lv2:symbol "notify" ; lv2:name "Notify" ] ,
+           [ a lv2:AudioPort , lv2:InputPort ; lv2:index 2 ; lv2:symbol "in" ; lv2:name "In" ] ,
+           [ a lv2:AudioPort , lv2:OutputPort ; lv2:index 3 ; lv2:symbol "out" ; lv2:name "Out" ] .

package/package.json

@@ -1,6 +1,94 @@
 {
   "name": "@openmixer/plugin-qualify",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.3.0",
+  "description": "Qualify audio plugins for real-time hosting: scan, offline latency and cost measurement, a mod-host hosting sweep, and a fail-closed rating.",
+  "type": "module",
+  "license": "GPL-3.0-or-later",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FreeMixer/plugin-qualify.git"
+  },
+  "author": "Pau Aliagas <linuxnow@gmail.com>",
+  "homepage": "https://github.com/FreeMixer/plugin-qualify#readme",
+  "bugs": {
+    "url": "https://github.com/FreeMixer/plugin-qualify/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "plugin-qualify": "./bin/plugin-qualify.mjs"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./src/index.ts"
+    },
+    "./declarations": {
+      "types": "./dist/qualify-declarations.d.ts",
+      "import": "./dist/qualify-declarations.js",
+      "default": "./src/qualify-declarations.ts"
+    },
+    "./measurement": {
+      "types": "./dist/measurement/index.d.ts",
+      "import": "./dist/measurement/index.js",
+      "default": "./src/measurement/index.ts"
+    },
+    "./measurement/fixtures": {
+      "types": "./dist/measurement/fixtures.d.ts",
+      "import": "./dist/measurement/fixtures.js",
+      "default": "./src/measurement/fixtures.ts"
+    },
+    "./tools/hosting-sweep.mjs": "./tools/hosting-sweep.mjs",
+    "./tools/lv2-measure.mjs": "./tools/lv2-measure.mjs",
+    "./rating": {
+      "types": "./dist/rating.d.ts",
+      "import": "./dist/rating.js",
+      "default": "./src/rating.ts"
+    },
+    "./host-profiles": {
+      "types": "./dist/host-profiles.d.ts",
+      "import": "./dist/host-profiles.js",
+      "default": "./src/host-profiles.ts"
+    },
+    "./hosting-suitability": {
+      "types": "./dist/hosting-suitability.d.ts",
+      "import": "./dist/hosting-suitability.js",
+      "default": "./src/hosting-suitability.ts"
+    },
+    "./package.json": "./package.json",
+    "./fixtures/*": "./fixtures/*"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "tools",
+    "!tools/test_*.py",
+    "!**/__pycache__",
+    "!**/*.pyc",
+    "fixtures",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.9.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json",
+    "test": "vitest run src",
+    "lint": "tsc -p tsconfig.lint.json",
+    "test:py": "python3 -m pytest tools -q",
+    "check:generated": "node tools/gen-python-declarations.mjs --check"
+  }
 }