@openmixer/plugin-qualify 0.12.0 → 0.13.1

package/fixtures/probe-output/success-msi.json

@@ -109,6 +109,17 @@
       "clap.params",
       "clap.state",
       "clap.thread-check",
+      "clap.note-ports",
+      "clap.note-name",
+      "clap.voice-info",
+      "clap.event-registry",
+      "clap.timer-support",
+      "clap.posix-fd-support",
+      "clap.thread-pool",
+      "clap.tail",
+      "clap.surround/4",
+      "clap.ambisonic/3",
+      "clap.audio-ports-config",
       "clap.preset-load/2",
       "clap.track-info/1",
       "clap.remote-controls/2"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmixer/plugin-qualify",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "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",
@@ -77,12 +77,12 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && tsc -p tsconfig.json",
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && node tools/gen-hosting-codes.mjs --build && tsc -p tsconfig.json",
     "prepare": "npm run build",
     "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",
+    "check:generated": "node tools/gen-python-declarations.mjs --check && node tools/gen-hosting-codes.mjs --check",
     "check:private-refs": "tools/private-refs-check.sh && tools/private-refs-check.sh --self-test"
   },
   "devDependencies": {
@@ -96,6 +96,6 @@
     "provenance": true
   },
   "dependencies": {
-    "@openmixer/omx-contract": "^2.16.0"
+    "@openmixer/omx-contract": "^3.0.0"
   }
 }

package/src/host-profiles.ts

@@ -42,8 +42,7 @@ export const OMX_INPROCESS_FEATURES: readonly string[] = [
  * than on the desk. The list's home is the CLAP library — libomx-clap-core's own
  * `clap_host_extensions.h`, what its host object offers — and this is its mirror, held equal to the
  * header at the pinned omx-clap-host (by the console's conformance test), so the verdict never
- * promises more or less than the host provides. Nothing else: no `gui`, no `timer-support`, no
- * `posix-fd-support`, no `thread-pool`.
+ * promises more or less than the host provides. Nothing else: no `gui`.
  */
 export const OMX_CLAP_HOST_EXTENSIONS: readonly string[] = [
   "clap.log",
@@ -52,6 +51,17 @@ export const OMX_CLAP_HOST_EXTENSIONS: readonly string[] = [
   "clap.params",
   "clap.audio-ports",
   "clap.state",
+  "clap.note-ports",
+  "clap.note-name",
+  "clap.voice-info",
+  "clap.event-registry",
+  "clap.timer-support",
+  "clap.posix-fd-support",
+  "clap.thread-pool",
+  "clap.tail",
+  "clap.surround/4",
+  "clap.ambisonic/3",
+  "clap.audio-ports-config",
 ];
 
 /**

package/src/hosting-codes.generated.ts

@@ -0,0 +1,84 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+//
+// GENERATED by tools/gen-hosting-codes.mjs from omx-clap-core's hosting tables — do not hand-edit.
+//
+// Regenerate: node tools/gen-hosting-codes.mjs --write
+// Verify:     node tools/gen-hosting-codes.mjs --check
+
+/** omx-clap-core's hosting codes, by key: every `HOSTING_<DIMENSION>_CODES` table, flattened. */
+export const HOSTING_CODE = Object.freeze({
+  "clapExtensionsNotCovered": "hosting.clap.extensions-not-covered",
+  "clapFormatNotHosted": "hosting.clap.format-not-hosted",
+  "clapHeadlessFailed": "hosting.clap.headless-failed",
+  "clapLatencyMismatch": "hosting.clap.latency-mismatch",
+  "clapNoteInput": "hosting.clap.note-input",
+  "clapProcessError": "hosting.clap.process-error",
+  "clapThreadViolation": "hosting.clap.thread-violation",
+  "clapUnqualified": "hosting.clap.unqualified",
+  "costAboveCeiling": "hosting.cost.above-ceiling",
+  "costFieldsMissing": "hosting.cost.fields-missing",
+  "costSpiky": "hosting.cost.spiky-tail",
+  "costUnmeasured": "hosting.cost.unmeasured-at-rate-and-quantum",
+  "costWithinCeiling": "hosting.cost.within-ceiling",
+  "featuresAtomInUnfed": "hosting.features.atom-in-unfed",
+  "featuresDisqualifying": "hosting.features.host-not-provided",
+  "featuresMidiIn": "hosting.features.midi-in-fed-empty",
+  "featuresMissing": "hosting.features.missing",
+  "featuresPortsUnreadable": "hosting.features.ports-unreadable",
+  "featuresProvided": "hosting.features.all-provided",
+  "featuresUnscanned": "hosting.features.scan-predates-field",
+  "latencyNonconforming": "hosting.latency.nonconforming",
+  "latencyParameterDependent": "hosting.latency.parameter-dependent",
+  "latencyResolved": "hosting.latency.resolved",
+  "latencyUnmeasured": "hosting.latency.unmeasured",
+  "outputNonFinite": "hosting.output.non-finite",
+  "overrideIsolated": "hosting.override.curator-isolated",
+  "patchBusy": "hosting.patch.busy",
+  "patchNotWritable": "hosting.patch.not-writable",
+  "patchTooLarge": "hosting.patch.too-large",
+  "presetNotFound": "hosting.preset.not-found",
+  "hostProvenanceDiffers": "hosting.provenance.host-differs",
+  "sweepControlDidNotFire": "hosting.provenance.sweep-control-did-not-fire",
+  "disabled": "hosting.disabled",
+  "linked": "hosting.linked",
+  "noRealisation": "hosting.no-realisation",
+  "realisedInProcess": "hosting.realised.in-process",
+  "unjudged": "hosting.unjudged",
+  "rtSafetyClean": "hosting.rt-safety.clean-under-sweep",
+  "rtSafetyNotReproducible": "hosting.rt-safety.not-reproducible",
+  "rtSafetyNotesClean": "hosting.rt-safety.clean-under-notes",
+  "rtSafetyNotesUnmeasured": "hosting.rt-safety.notes-unmeasured",
+  "rtSafetyNotesViolations": "hosting.rt-safety.violations-under-notes",
+  "rtSafetyUnmeasured": "hosting.rt-safety.unmeasured",
+  "rtSafetyViolations": "hosting.rt-safety.violations-in-run",
+  "stabilityBelowFloor": "hosting.stability.cycles-below-floor",
+  "stabilityCrashUnattributed": "hosting.stability.crash-unattributed",
+  "stabilityCrashedAttributed": "hosting.stability.crashed-attributed-plugin",
+  "stabilityCrashedLive": "hosting.stability.crashed-live-on-this-rig",
+  "stabilityLinksGuiToolkit": "hosting.stability.links-gui-toolkit",
+  "stabilitySoakFailedAtRate": "hosting.stability.soak-failed-at-rate",
+  "stabilitySoaked": "hosting.stability.soaked",
+  "stabilitySpawnsThreads": "hosting.stability.spawns-threads",
+  "stabilityUnmeasured": "hosting.stability.unmeasured",
+  "stabilityUnsoaked": "hosting.stability.unsoaked",
+  "stateNotACopy": "hosting.state.not-a-copy",
+  "statePathOnAudio": "hosting.state.path-on-audio",
+  "statePathOutside": "hosting.state.path-outside",
+  "statePathSymlink": "hosting.state.path-symlink",
+  "statePathTooLong": "hosting.state.path-too-long",
+  "statePathUnmakeable": "hosting.state.path-unmakeable",
+  "stateUnreadable": "hosting.state.unreadable",
+  "topologyAmbisonicConfig": "hosting.topology.ambisonic-config",
+  "topologyChannelMapUnknown": "hosting.topology.channel-map-unknown",
+  "topologyInstrument": "hosting.topology.instrument",
+  "topologyMatched": "hosting.topology.matched",
+  "topologyNoAudioInput": "hosting.topology.no-audio-input",
+  "topologyNoAudioOutput": "hosting.topology.no-audio-output",
+  "topologyPortTooWide": "hosting.topology.port-too-wide",
+  "topologyPortWithoutChannels": "hosting.topology.port-without-channels",
+  "topologyTooManyPorts": "hosting.topology.too-many-ports",
+  "topologyWiderThanStrip": "hosting.topology.wider-than-strip",
+  "workerNonconforming": "hosting.worker.nonconforming",
+  "idleHoldRefused": "hosting.idle.hold-refused",
+} as const);

package/src/hosting-codes.ts

@@ -1,82 +1,21 @@
 // SPDX-License-Identifier: GPL-3.0-or-later
 // Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
 /**
- * The hosting verdict's message codes. Codes, never prose: the
- * surface renders the operator's locale.
+ * The hosting verdict's message codes. Codes, never prose: the surface renders the operator's
+ * locale.
  *
- * A UNION list file: `.gitattributes` marks it
- * `merge=union`, so two lanes that each add a code merge with both kept. Only the table lives
- * here, one `key: 'code',` per line, with keys and codes unique; the registry-hotspots gate
- * refuses anything else.
+ * omx-clap-core declares every hosting code: one `HOSTING_<DIMENSION>_CODES` table per dimension,
+ * in the TypeScript modules its package installs under `pkg-config --variable=tsdir omx-clap-core`
+ * (BUILDING.md). {@link HOSTING_CODE} is those tables flattened into one `key: code` map, written
+ * as plain data into `hosting-codes.generated.ts` by `tools/gen-hosting-codes.mjs` at build time:
+ * a code omx-clap-core does not declare cannot be named here, and this module reads no file and
+ * imports no `node:` module, so every public subpath that reaches it bundles for a browser.
+ * `src/contract-vocabulary-conformance.test.ts` holds the generated map to omx-clap-core's real
+ * modules, either way.
  */
-export const HOSTING_CODE = {
-  stabilitySoaked: 'hosting.stability.soaked',
-  stabilityCrashedAttributed: 'hosting.stability.crashed-attributed-plugin',
-  stabilityCrashedLive: 'hosting.stability.crashed-live-on-this-rig',
-  stabilityBelowFloor: 'hosting.stability.cycles-below-floor',
-  stabilityUnsoaked: 'hosting.stability.unsoaked',
-  stabilitySoakFailedAtRate: 'hosting.stability.soak-failed-at-rate',
-  stabilityUnmeasured: 'hosting.stability.unmeasured',
-  stabilityCrashUnattributed: 'hosting.stability.crash-unattributed',
-  stabilitySpawnsThreads: 'hosting.stability.spawns-threads',
-  stabilityLinksGuiToolkit: 'hosting.stability.links-gui-toolkit',
-  rtSafetyClean: 'hosting.rt-safety.clean-under-sweep',
-  rtSafetyViolations: 'hosting.rt-safety.violations-in-run',
-  rtSafetyUnmeasured: 'hosting.rt-safety.unmeasured',
-  rtSafetyNotReproducible: 'hosting.rt-safety.not-reproducible',
-  // The note sweep: an instrument played under the interposer, a count of its own.
-  rtSafetyNotesClean: 'hosting.rt-safety.clean-under-notes',
-  rtSafetyNotesViolations: 'hosting.rt-safety.violations-under-notes',
-  rtSafetyNotesUnmeasured: 'hosting.rt-safety.notes-unmeasured',
-  featuresProvided: 'hosting.features.all-provided',
-  featuresMissing: 'hosting.features.required-not-provided',
-  featuresDisqualifying: 'hosting.features.host-not-provided',
-  featuresCv: 'hosting.features.cv-ports',
-  featuresMidiIn: 'hosting.features.midi-in-fed-empty',
-  featuresUnscanned: 'hosting.features.scan-predates-field',
-  costWithinCeiling: 'hosting.cost.within-ceiling',
-  costAboveCeiling: 'hosting.cost.above-ceiling',
-  costSpiky: 'hosting.cost.spiky-tail',
-  costUnmeasured: 'hosting.cost.unmeasured-at-rate-and-quantum',
-  costFieldsMissing: 'hosting.cost.fields-missing',
-  latencyResolved: 'hosting.latency.resolved',
-  latencyUnmeasured: 'hosting.latency.unmeasured',
-  latencyNonconforming: 'hosting.latency.nonconforming',
-  latencyParameterDependent: 'hosting.latency.parameter-dependent',
-  topologyMatched: 'hosting.topology.matched',
-  topologyNoAudioInput: 'hosting.topology.no-audio-input',
-  topologyNoAudioOutput: 'hosting.topology.no-audio-output',
-  topologyExtraInputs: 'hosting.topology.extra-inputs-fed-silence',
-  topologyInstrument: 'hosting.topology.instrument',
-  // The CLAP arm: the SAME dimensions fed from CLAP facts,
-  // minted here where the LV2 table has no code for the fact.
-  topologyWiderThanStrip: 'hosting.topology.wider-than-strip',
-  clapLatencyMismatch: 'hosting.clap.latency-mismatch',
-  clapNotAudioEffect: 'hosting.clap.not-audio-effect',
-  clapHeadlessFailed: 'hosting.clap.headless-failed',
-  clapNoteInput: 'hosting.clap.note-input',
-  clapThreadViolation: 'hosting.clap.thread-violation',
-  clapProcessError: 'hosting.clap.process-error',
-  clapUnqualified: 'hosting.clap.unqualified',
-  clapFormatNotHosted: 'hosting.clap.format-not-hosted',
-  clapExtensionsNotCovered: 'hosting.clap.extensions-not-covered',
-  outputNonFinite: 'hosting.output.non-finite',
-  workerNonconforming: 'hosting.worker.nonconforming',
-  // The pin (spec §11; one-contract §10.3): a host's refusal at add, by the daemon's code.
-  integrityUnpinned: 'hosting.integrity.unpinned',
-  integrityBinaryMismatch: 'hosting.integrity.binary-mismatch',
-  integrityLayoutMismatch: 'hosting.integrity.layout-mismatch',
-  overrideIsolated: 'hosting.override.curator-isolated',
-  hostProvenanceDiffers: 'hosting.provenance.host-differs',
-  sweepControlDidNotFire: 'hosting.provenance.sweep-control-did-not-fire',
-  // The five REALISED reasons. Everything above answers what a plugin EARNED; these answer
-  // what the console DID with that, and the difference between the two is the operator's
-  // whole question when a slot is not on the fast path.
-  disabled: 'hosting.disabled',
-  unjudged: 'hosting.unjudged',
-  noRealisation: 'hosting.no-realisation',
-  realisedInProcess: 'hosting.realised.in-process',
-  // A plugin LINKED into the engine (the static-link registry) runs in-process without a
-  // verdict: the library's oracles are its proof.
-  linked: 'hosting.linked',
-} as const;
+import { HOSTING_CODE } from "./hosting-codes.generated.js";
+
+export { HOSTING_CODE };
+
+/** {@link HOSTING_CODE}'s type: each key's literal code. */
+export type HostingCodeTable = typeof HOSTING_CODE;

package/src/hosting-suitability.ts

@@ -148,12 +148,11 @@ export type HostingCode = (typeof HOSTING_CODE)[keyof typeof HOSTING_CODE];
  */
 export const CLAP_CORE_REFUSALS = {
   headlessFailed: "clapHeadlessFailed",
-  notAudioEffect: "clapNotAudioEffect",
   noteInput: "clapNoteInput",
   noAudioInput: "topologyNoAudioInput",
   noAudioOutput: "topologyNoAudioOutput",
   widerThanStrip: "topologyWiderThanStrip",
-  extraInputs: "topologyExtraInputs",
+  tooManyPorts: "topologyTooManyPorts",
   crashedLive: "stabilityCrashedLive",
   outputNonFinite: "outputNonFinite",
 } as const satisfies Record<string, keyof typeof HOSTING_CODE>;
@@ -164,12 +163,11 @@ export const CLAP_CORE_REFUSALS = {
  * refusal so the renderer holds no prose. A refusal without a line renders bare.
  */
 export const CLAP_CORE_REFUSAL_DESCRIPTIONS: { readonly [K in keyof typeof CLAP_CORE_REFUSALS]?: string } = {
-  notAudioEffect: "the plugin is not an audio effect",
   noteInput: "the plugin declares a note input the configuration refuses",
   noAudioInput: "the plugin has no audio input",
   noAudioOutput: "the plugin has no audio output",
   widerThanStrip: "the plugin is wider than the strip",
-  extraInputs: "the plugin has extra inputs, fed silence",
+  tooManyPorts: "the plugin has more ports than the auxiliary limit allows",
   crashedLive: "the plugin crashed live on this rig",
   outputNonFinite: "the plugin produced non-finite output",
 };
@@ -696,9 +694,6 @@ export function featureReasons(
         }),
       );
     }
-    if ((features.cvPorts ?? 0) > 0) {
-      out.push(reason("features", "objective", "unsuitable", HOSTING_CODE.featuresCv));
-    }
   }
   if (descriptor.hasMidiIn && !instruments) {
     out.push(reason("features", "objective", "conditional", HOSTING_CODE.featuresMidiIn));
@@ -821,7 +816,7 @@ export function hostingTopologyReasons(
     ];
   }
   return [
-    reason("topology", "objective", "conditional", HOSTING_CODE.topologyExtraInputs, { ins, outs }),
+    reason("topology", "objective", "conditional", HOSTING_CODE.topologyTooManyPorts, { ins, outs }),
   ];
 }
 
@@ -845,7 +840,7 @@ export function clapTopologyReasons(clap: PluginClapMeasurement | undefined, ins
     return [reason("topology", "objective", "unsuitable", HOSTING_CODE.topologyWiderThanStrip, { ins, outs })];
   }
   if (clap.sidechainInputs > 0) {
-    return [reason("topology", "objective", "unsuitable", HOSTING_CODE.topologyExtraInputs, { ins, outs, sidechains: clap.sidechainInputs })];
+    return [reason("topology", "objective", "unsuitable", HOSTING_CODE.topologyTooManyPorts, { ins, outs, sidechains: clap.sidechainInputs })];
   }
   return [reason("topology", "objective", "suitable", HOSTING_CODE.topologyMatched, { ins, outs })];
 }
@@ -899,11 +894,6 @@ export function clapFeatureReasons(
   }
   const out: HostingReason[] = [];
   const offered = profile.clapExtensions;
-  const kindHosted =
-    clap.features.includes(CLAP_FEATURE_AUDIO_EFFECT) || (profile.instruments && clap.features.includes(CLAP_FEATURE_INSTRUMENT));
-  if (!kindHosted) {
-    out.push(reason("features", "objective", "unsuitable", HOSTING_CODE.clapNotAudioEffect, { features: clap.features.join(" ") }));
-  }
   if (!clap.headlessOk) {
     out.push(reason("features", "objective", "unsuitable", HOSTING_CODE.clapHeadlessFailed));
   } else {

package/src/measurement/cli.ts

@@ -99,7 +99,7 @@ export interface MeasureOptions {
  * them: the provider's kinds (`--features`), its buf-size declarations (`--block-declares`) and its log
  * modes (`--log`). A conformance test reads both.
  */
-export const LV2_FEATURE_KINDS = ["map", "unmap", "options", "bounded", "worker", "default-state", "log"] as const;
+export const LV2_FEATURE_KINDS = ["map", "unmap", "options", "bounded", "worker", "default-state", "log", "rtmempool"] as const;
 export const LV2_BLOCK_DECLARATIONS = ["bounded", "fixed", "pow2"] as const;
 export const LV2_LOG_MODES = ["silent", "route", "capture"] as const;
 

package/src/measurement/format.ts

@@ -147,7 +147,7 @@ export interface MeasurementHost {
 
 /** How the latency figures in this document were taken. */
 export interface LatencyMethod {
-  /** A {@link ../vocabulary.METHOD_TERMS} code — `impulse-onset` or `declared-port`. */
+  /** A {@link ../vocabulary.METHOD_TERMS} code — `impulse-onset`, `declared-port` or `note-onset`. */
   readonly method: string;
   readonly blockFrames: number;
   /** What was fed in, in words. An onset measured through an opened gate is not the same