@openmixer/plugin-qualify 0.13.0 → 0.14.1

package/README.md

@@ -193,6 +193,40 @@ names the options it ran under, `featureOptions`:
 The defaults are the measurement as it has always been, so a verdict reached under them does not
 move. `lv2_measure --help` lists the same flags.
 
+## Scanned descriptors
+
+Both scanners also write what each plugin states about itself as a scanned descriptor: one JSON file per
+plugin in omx-contract's descriptor words (identity, controls, ports, what it needs from a host, whether it
+reports latency), held to omx-contract's descriptor schema before it is written. A descriptor holds no
+measurement and no verdict; those are the qualification record's.
+
+The files go into the descriptor directory, the key `descriptor_dir`:
+
+| | where |
+| --- | --- |
+| named | `--descriptor-dir <dir>` |
+| a user (the default) | `$XDG_STATE_HOME/omx/descriptors`, else `~/.local/state/omx/descriptors` |
+| a system service | `/var/lib/omx/descriptors` (`--system`) |
+
+Each file is named `<id>@<version>-<sha256 first 12>.json`: the CLAP id or the LV2 URI, the version the
+plugin states (`unversioned` when it states none) and the SHA-256 of its binary (the `.clap`, or the LV2
+bundle's `lv2:binary`), with every character other than letters, digits, `.`, `_` and `-` written `_`. The hash
+keys which file describes which binary: a changed binary is a new file, and the old one stays as history.
+
+```
+tools/scan.py --out catalog.json                                     # LV2: the catalog, and the descriptors beside it
+tools/scan.py --descriptor-dir ./descriptors urn:my:plugin           # one plugin, into a directory of your own
+native/build/clap-qualify --json ./my-fx.clap | tools/descriptors.py clap --descriptor-dir ./descriptors
+```
+
+`scan.py --no-descriptors` writes the catalog only. A descriptor the schema refuses is not written and is
+reported as `contract.file.invalid`, omx-contract's code; a plugin whose binary cannot be read is
+`qualify.descriptor.binary-unhashed`; a directory that cannot be written is `qualify.descriptor.dir-unwritable`;
+no schema found is `qualify.descriptor.schema-missing`. Any of them makes the run exit `2`, and the other
+plugins are still written. The schema is the omx-contract package plugin-qualify depends on, else
+`/usr/share/omx-contract/omx-contract.schema.json`; `OMX_CONTRACT_SCHEMA` names another one, for a test. The
+writer needs Python's `jsonschema` (`python3-jsonschema`).
+
 ## What the verdicts mean
 
 - **suitable**: every dimension was measured and passed. Safe to run inside the engine's own

package/dist/hosting-codes.d.ts

@@ -1,91 +1,17 @@
 /**
- * Where omx-clap-core's TypeScript modules are looked for, in order: `OMX_CLAP_CORE_TSDIR` when
- * set (and only that), else `pkg-config --variable=tsdir omx-clap-core`, else the checkout
- * `native/fetch-deps.sh` stages, else the path `make install` of omx-clap-host uses by default —
- * a packaged plugin-qualify's runtime has no `pkg-config` binary to ask.
+ * The hosting verdict's message codes. Codes, never prose: the surface renders the operator's
+ * locale.
+ *
+ * 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 declare function clapCoreTsDirCandidates(env?: Readonly<Record<string, string | undefined>>): readonly string[];
-/** True for an export name that is one of omx-clap-core's hosting tables. */
-export declare function isHostingTableName(name: string): boolean;
-/**
- * omx-clap-core's hosting codes, by key, across its two TypeScript modules — hand-kept here
- * (not derived from a static import: the source is a runtime-resolved install directory, not an
- * npm dependency) and held to the real modules by
- * `src/contract-vocabulary-conformance.test.ts`, which turns red on any drift either way.
- */
-export interface HostingCodeTable {
-    readonly clapExtensionsNotCovered: "hosting.clap.extensions-not-covered";
-    readonly clapFormatNotHosted: "hosting.clap.format-not-hosted";
-    readonly clapHeadlessFailed: "hosting.clap.headless-failed";
-    readonly clapLatencyMismatch: "hosting.clap.latency-mismatch";
-    readonly clapNoteInput: "hosting.clap.note-input";
-    readonly clapProcessError: "hosting.clap.process-error";
-    readonly clapThreadViolation: "hosting.clap.thread-violation";
-    readonly clapUnqualified: "hosting.clap.unqualified";
-    readonly costAboveCeiling: "hosting.cost.above-ceiling";
-    readonly costFieldsMissing: "hosting.cost.fields-missing";
-    readonly costSpiky: "hosting.cost.spiky-tail";
-    readonly costUnmeasured: "hosting.cost.unmeasured-at-rate-and-quantum";
-    readonly costWithinCeiling: "hosting.cost.within-ceiling";
-    readonly featuresAtomInUnfed: "hosting.features.atom-in-unfed";
-    readonly featuresDisqualifying: "hosting.features.host-not-provided";
-    readonly featuresMidiIn: "hosting.features.midi-in-fed-empty";
-    readonly featuresMissing: "hosting.features.missing";
-    readonly featuresPortsUnreadable: "hosting.features.ports-unreadable";
-    readonly featuresProvided: "hosting.features.all-provided";
-    readonly featuresUnscanned: "hosting.features.scan-predates-field";
-    readonly idleHoldRefused: "hosting.idle.hold-refused";
-    readonly latencyNonconforming: "hosting.latency.nonconforming";
-    readonly latencyParameterDependent: "hosting.latency.parameter-dependent";
-    readonly latencyResolved: "hosting.latency.resolved";
-    readonly latencyUnmeasured: "hosting.latency.unmeasured";
-    readonly outputNonFinite: "hosting.output.non-finite";
-    readonly overrideIsolated: "hosting.override.curator-isolated";
-    readonly patchBusy: "hosting.patch.busy";
-    readonly patchNotWritable: "hosting.patch.not-writable";
-    readonly patchTooLarge: "hosting.patch.too-large";
-    readonly presetNotFound: "hosting.preset.not-found";
-    readonly hostProvenanceDiffers: "hosting.provenance.host-differs";
-    readonly sweepControlDidNotFire: "hosting.provenance.sweep-control-did-not-fire";
-    readonly disabled: "hosting.disabled";
-    readonly linked: "hosting.linked";
-    readonly noRealisation: "hosting.no-realisation";
-    readonly realisedInProcess: "hosting.realised.in-process";
-    readonly unjudged: "hosting.unjudged";
-    readonly rtSafetyClean: "hosting.rt-safety.clean-under-sweep";
-    readonly rtSafetyNotReproducible: "hosting.rt-safety.not-reproducible";
-    readonly rtSafetyNotesClean: "hosting.rt-safety.clean-under-notes";
-    readonly rtSafetyNotesUnmeasured: "hosting.rt-safety.notes-unmeasured";
-    readonly rtSafetyNotesViolations: "hosting.rt-safety.violations-under-notes";
-    readonly rtSafetyUnmeasured: "hosting.rt-safety.unmeasured";
-    readonly rtSafetyViolations: "hosting.rt-safety.violations-in-run";
-    readonly stabilityBelowFloor: "hosting.stability.cycles-below-floor";
-    readonly stabilityCrashUnattributed: "hosting.stability.crash-unattributed";
-    readonly stabilityCrashedAttributed: "hosting.stability.crashed-attributed-plugin";
-    readonly stabilityCrashedLive: "hosting.stability.crashed-live-on-this-rig";
-    readonly stabilityLinksGuiToolkit: "hosting.stability.links-gui-toolkit";
-    readonly stabilitySoakFailedAtRate: "hosting.stability.soak-failed-at-rate";
-    readonly stabilitySoaked: "hosting.stability.soaked";
-    readonly stabilitySpawnsThreads: "hosting.stability.spawns-threads";
-    readonly stabilityUnmeasured: "hosting.stability.unmeasured";
-    readonly stabilityUnsoaked: "hosting.stability.unsoaked";
-    readonly stateNotACopy: "hosting.state.not-a-copy";
-    readonly statePathOnAudio: "hosting.state.path-on-audio";
-    readonly statePathOutside: "hosting.state.path-outside";
-    readonly statePathSymlink: "hosting.state.path-symlink";
-    readonly statePathTooLong: "hosting.state.path-too-long";
-    readonly statePathUnmakeable: "hosting.state.path-unmakeable";
-    readonly stateUnreadable: "hosting.state.unreadable";
-    readonly topologyAmbisonicConfig: "hosting.topology.ambisonic-config";
-    readonly topologyChannelMapUnknown: "hosting.topology.channel-map-unknown";
-    readonly topologyInstrument: "hosting.topology.instrument";
-    readonly topologyMatched: "hosting.topology.matched";
-    readonly topologyNoAudioInput: "hosting.topology.no-audio-input";
-    readonly topologyNoAudioOutput: "hosting.topology.no-audio-output";
-    readonly topologyPortTooWide: "hosting.topology.port-too-wide";
-    readonly topologyPortWithoutChannels: "hosting.topology.port-without-channels";
-    readonly topologyTooManyPorts: "hosting.topology.too-many-ports";
-    readonly topologyWiderThanStrip: "hosting.topology.wider-than-strip";
-    readonly workerNonconforming: "hosting.worker.nonconforming";
-}
-export declare const HOSTING_CODE: HostingCodeTable;
+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/dist/hosting-codes.generated.d.ts

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

package/dist/hosting-codes.generated.js

@@ -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",
+});
+//# sourceMappingURL=hosting-codes.generated.js.map

package/dist/hosting-codes.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosting-codes.generated.js","sourceRoot":"","sources":["../src/hosting-codes.generated.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD,EAAE;AACF,mGAAmG;AACnG,EAAE;AACF,uDAAuD;AACvD,uDAAuD;AAEvD,iGAAiG;AACjG,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;IACxC,0BAA0B,EAAE,qCAAqC;IACjE,qBAAqB,EAAE,gCAAgC;IACvD,oBAAoB,EAAE,8BAA8B;IACpD,qBAAqB,EAAE,+BAA+B;IACtD,eAAe,EAAE,yBAAyB;IAC1C,kBAAkB,EAAE,4BAA4B;IAChD,qBAAqB,EAAE,+BAA+B;IACtD,iBAAiB,EAAE,0BAA0B;IAC7C,kBAAkB,EAAE,4BAA4B;IAChD,mBAAmB,EAAE,6BAA6B;IAClD,WAAW,EAAE,yBAAyB;IACtC,gBAAgB,EAAE,6CAA6C;IAC/D,mBAAmB,EAAE,6BAA6B;IAClD,qBAAqB,EAAE,gCAAgC;IACvD,uBAAuB,EAAE,oCAAoC;IAC7D,gBAAgB,EAAE,oCAAoC;IACtD,iBAAiB,EAAE,0BAA0B;IAC7C,yBAAyB,EAAE,mCAAmC;IAC9D,kBAAkB,EAAE,+BAA+B;IACnD,mBAAmB,EAAE,sCAAsC;IAC3D,sBAAsB,EAAE,+BAA+B;IACvD,2BAA2B,EAAE,qCAAqC;IAClE,iBAAiB,EAAE,0BAA0B;IAC7C,mBAAmB,EAAE,4BAA4B;IACjD,iBAAiB,EAAE,2BAA2B;IAC9C,kBAAkB,EAAE,mCAAmC;IACvD,WAAW,EAAE,oBAAoB;IACjC,kBAAkB,EAAE,4BAA4B;IAChD,eAAe,EAAE,yBAAyB;IAC1C,gBAAgB,EAAE,0BAA0B;IAC5C,uBAAuB,EAAE,iCAAiC;IAC1D,wBAAwB,EAAE,+CAA+C;IACzE,UAAU,EAAE,kBAAkB;IAC9B,QAAQ,EAAE,gBAAgB;IAC1B,eAAe,EAAE,wBAAwB;IACzC,mBAAmB,EAAE,6BAA6B;IAClD,UAAU,EAAE,kBAAkB;IAC9B,eAAe,EAAE,qCAAqC;IACtD,yBAAyB,EAAE,oCAAoC;IAC/D,oBAAoB,EAAE,qCAAqC;IAC3D,yBAAyB,EAAE,oCAAoC;IAC/D,yBAAyB,EAAE,0CAA0C;IACrE,oBAAoB,EAAE,8BAA8B;IACpD,oBAAoB,EAAE,qCAAqC;IAC3D,qBAAqB,EAAE,sCAAsC;IAC7D,4BAA4B,EAAE,sCAAsC;IACpE,4BAA4B,EAAE,6CAA6C;IAC3E,sBAAsB,EAAE,4CAA4C;IACpE,0BAA0B,EAAE,qCAAqC;IACjE,2BAA2B,EAAE,uCAAuC;IACpE,iBAAiB,EAAE,0BAA0B;IAC7C,wBAAwB,EAAE,kCAAkC;IAC5D,qBAAqB,EAAE,8BAA8B;IACrD,mBAAmB,EAAE,4BAA4B;IACjD,eAAe,EAAE,0BAA0B;IAC3C,kBAAkB,EAAE,6BAA6B;IACjD,kBAAkB,EAAE,4BAA4B;IAChD,kBAAkB,EAAE,4BAA4B;IAChD,kBAAkB,EAAE,6BAA6B;IACjD,qBAAqB,EAAE,+BAA+B;IACtD,iBAAiB,EAAE,0BAA0B;IAC7C,yBAAyB,EAAE,mCAAmC;IAC9D,2BAA2B,EAAE,sCAAsC;IACnE,oBAAoB,EAAE,6BAA6B;IACnD,iBAAiB,EAAE,0BAA0B;IAC7C,sBAAsB,EAAE,iCAAiC;IACzD,uBAAuB,EAAE,kCAAkC;IAC3D,qBAAqB,EAAE,gCAAgC;IACvD,6BAA6B,EAAE,wCAAwC;IACvE,sBAAsB,EAAE,iCAAiC;IACzD,wBAAwB,EAAE,mCAAmC;IAC7D,qBAAqB,EAAE,8BAA8B;IACrD,iBAAiB,EAAE,2BAA2B;CACtC,CAAC,CAAC"}

package/dist/hosting-codes.js

@@ -4,92 +4,15 @@
  * The hosting verdict's message codes. Codes, never prose: the surface renders the operator's
  * locale.
  *
- * omx-clap-core declares every hosting code now (the contract split moved `data/hosting/*.json`
- * there, byte for byte): one `HOSTING_<DIMENSION>_CODES` table per dimension, rendered into the
- * TypeScript modules its package installs under `pkg-config --variable=tsdir omx-clap-core`
- * (BUILDING.md) — `omx-clap-core-vocabulary.js` for the dimensions carried from omx-contract,
- * `omx-clap-core-hosting.js` for `hosting.idle.*`, its own (both with a `.d.ts`). {@link
- * HOSTING_CODE} is those tables flattened into one `key: code` map, loaded at import: a code
- * neither module declares cannot be named here, and a dimension either adds arrives without an
- * edit.
+ * 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.
  */
-import { execFileSync } from "node:child_process";
-import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
-import { fileURLToPath } from "node:url";
-/** The two TypeScript modules omx-clap-core's `tsdir` carries, each a `HOSTING_<DIMENSION>_CODES` source. */
-const CLAP_CORE_TS_MODULES = ["omx-clap-core-vocabulary.js", "omx-clap-core-hosting.js"];
-/** This package's own root, resolved from this module so it follows wherever it is installed. */
-const PACKAGE_ROOT = fileURLToPath(new URL("..", import.meta.url));
-/** `native/fetch-deps.sh`'s own checkout of omx-clap-core, for a build with no omx-clap-core-devel installed. */
-const DEPS_TS_DIR = join(PACKAGE_ROOT, "native/deps/omx-clap-core/ts");
-/** Where `make install` of omx-clap-host puts them (BUILDING.md), for a run with no `pkg-config` binary at all. */
-const DEFAULT_SYSTEM_TS_DIR = "/usr/share/omx-clap-core/ts";
-/** `pkg-config --variable=tsdir omx-clap-core`, or `undefined` where pkg-config or the package is absent. */
-function pkgConfigTsDir(env) {
-    try {
-        const out = execFileSync(env.PKG_CONFIG ?? "pkg-config", ["--variable=tsdir", "omx-clap-core"], {
-            encoding: "utf8",
-            stdio: ["ignore", "pipe", "ignore"],
-        }).trim();
-        return out === "" ? undefined : out;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Where omx-clap-core's TypeScript modules are looked for, in order: `OMX_CLAP_CORE_TSDIR` when
- * set (and only that), else `pkg-config --variable=tsdir omx-clap-core`, else the checkout
- * `native/fetch-deps.sh` stages, else the path `make install` of omx-clap-host uses by default —
- * a packaged plugin-qualify's runtime has no `pkg-config` binary to ask.
- */
-export function clapCoreTsDirCandidates(env = process.env) {
-    const set = env.OMX_CLAP_CORE_TSDIR;
-    if (set !== undefined && set !== "")
-        return [set];
-    const fromPkgConfig = pkgConfigTsDir(env);
-    return [...(fromPkgConfig === undefined ? [] : [fromPkgConfig]), DEPS_TS_DIR, DEFAULT_SYSTEM_TS_DIR];
-}
-function locateClapCoreTsDir() {
-    const candidates = clapCoreTsDirCandidates();
-    const dir = candidates.find((d) => CLAP_CORE_TS_MODULES.every((m) => existsSync(join(d, m))));
-    if (dir === undefined) {
-        throw new Error(`omx-clap-core's TypeScript modules (${CLAP_CORE_TS_MODULES.join(", ")}) were not found in any of: ` +
-            `${candidates.join(", ")}. Install omx-clap-core-devel (pkg-config omx-clap-core), set ` +
-            "OMX_CLAP_CORE_TSDIR to its tsdir, or run native/fetch-deps.sh.");
-    }
-    return dir;
-}
-/** True for an export name that is one of omx-clap-core's hosting tables. */
-export function isHostingTableName(name) {
-    return /^HOSTING_[A-Z0-9_]+_CODES$/.test(name);
-}
-async function loadHostingTables() {
-    const dir = locateClapCoreTsDir();
-    const tables = {};
-    for (const name of CLAP_CORE_TS_MODULES) {
-        // The modules are self-contained ES modules in a directory with no package.json: Node 18 reads such a .js as
-        // CommonJS and refuses `export`, so the source is imported as a data: module, which is a module on every Node.
-        const source = readFileSync(join(dir, name), "utf8");
-        const mod = await import(`data:text/javascript;base64,${Buffer.from(source).toString("base64")}`);
-        for (const [exportName, table] of Object.entries(mod)) {
-            if (isHostingTableName(exportName))
-                tables[exportName] = table;
-        }
-    }
-    return tables;
-}
-function flatten(tables) {
-    const table = {};
-    for (const [name, entries] of Object.entries(tables)) {
-        for (const [key, entry] of Object.entries(entries)) {
-            if (key in table)
-                throw new Error(`omx-clap-core declares the hosting key ${key} twice (${name})`);
-            table[key] = entry.code;
-        }
-    }
-    return Object.freeze(table);
-}
-export const HOSTING_CODE = flatten(await loadHostingTables());
+import { HOSTING_CODE } from "./hosting-codes.generated.js";
+export { HOSTING_CODE };
 //# sourceMappingURL=hosting-codes.js.map

package/dist/hosting-codes.js.map

@@ -1 +1 @@
-{"version":3,"file":"hosting-codes.js","sourceRoot":"","sources":["../src/hosting-codes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hosting-codes.js","sourceRoot":"","sources":["../src/hosting-codes.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/qualify-declarations.d.ts

@@ -117,6 +117,32 @@ export declare const LV2_HOSTING_BLOCK_FRAMES = 512;
 export declare const LV2_HOSTING_LIFECYCLES = 30;
 export declare const LV2_HOSTING_REPEATS = 3;
 export declare const LV2_HOSTING_TIMEOUT_S = 240;
+/**
+ * The scanned descriptors (owner spec 6.6 and 6.9): both scanners write one file per plugin into the
+ * directory the key `descriptor_dir` names, `<id>@<version>-<binary sha256 first DESCRIPTOR_HASH_PREFIX>.json`.
+ * With no directory named it is `$XDG_STATE_HOME/<DESCRIPTOR_DIR_STATE_SUBDIR>`, else
+ * `~/.local/state/<DESCRIPTOR_DIR_STATE_SUBDIR>`; a system service's is `DESCRIPTOR_DIR_SYSTEM`.
+ */
+export declare const DESCRIPTOR_DIR_KEY = "descriptor_dir";
+export declare const DESCRIPTOR_DIR_STATE_SUBDIR = "omx/descriptors";
+export declare const DESCRIPTOR_DIR_SYSTEM = "/var/lib/omx/descriptors";
+export declare const DESCRIPTOR_HASH_PREFIX = 12;
+/**
+ * The one descriptor schema both scanners hold a file to: omx-contract's, named by `DESCRIPTOR_SCHEMA_ENV`
+ * when set (a test, or a checkout pointing at another contract), else the omx-contract package this one
+ * depends on, else `DESCRIPTOR_SCHEMA_INSTALLED`. A written descriptor requires `DESCRIPTOR_SCHEMA_FLOOR`.
+ */
+export declare const DESCRIPTOR_SCHEMA_ENV = "OMX_CONTRACT_SCHEMA";
+export declare const DESCRIPTOR_SCHEMA_INSTALLED = "/usr/share/omx-contract/omx-contract.schema.json";
+export declare const DESCRIPTOR_SCHEMA_FLOOR = ">= 3.0.0";
+/**
+ * Why a scanned descriptor is not written. A file the schema refuses is omx-contract's own
+ * `contract.file.invalid`; the others are the scanners' own.
+ */
+export declare const DESCRIPTOR_CODE_SCHEMA = "contract.file.invalid";
+export declare const DESCRIPTOR_CODE_SCHEMA_MISSING = "qualify.descriptor.schema-missing";
+export declare const DESCRIPTOR_CODE_BINARY_UNHASHED = "qualify.descriptor.binary-unhashed";
+export declare const DESCRIPTOR_CODE_DIR_UNWRITABLE = "qualify.descriptor.dir-unwritable";
 /** Every threshold, so none is baked into the code. */
 export interface HostingPolicy {
     /** Minimum instantiate/destroy lifecycles. The operator's §14.4 ruling: 1000. */

package/dist/qualify-declarations.js

@@ -122,6 +122,32 @@ export const LV2_HOSTING_BLOCK_FRAMES = 512;
 export const LV2_HOSTING_LIFECYCLES = 30;
 export const LV2_HOSTING_REPEATS = 3;
 export const LV2_HOSTING_TIMEOUT_S = 240;
+/**
+ * The scanned descriptors (owner spec 6.6 and 6.9): both scanners write one file per plugin into the
+ * directory the key `descriptor_dir` names, `<id>@<version>-<binary sha256 first DESCRIPTOR_HASH_PREFIX>.json`.
+ * With no directory named it is `$XDG_STATE_HOME/<DESCRIPTOR_DIR_STATE_SUBDIR>`, else
+ * `~/.local/state/<DESCRIPTOR_DIR_STATE_SUBDIR>`; a system service's is `DESCRIPTOR_DIR_SYSTEM`.
+ */
+export const DESCRIPTOR_DIR_KEY = "descriptor_dir";
+export const DESCRIPTOR_DIR_STATE_SUBDIR = "omx/descriptors";
+export const DESCRIPTOR_DIR_SYSTEM = "/var/lib/omx/descriptors";
+export const DESCRIPTOR_HASH_PREFIX = 12;
+/**
+ * The one descriptor schema both scanners hold a file to: omx-contract's, named by `DESCRIPTOR_SCHEMA_ENV`
+ * when set (a test, or a checkout pointing at another contract), else the omx-contract package this one
+ * depends on, else `DESCRIPTOR_SCHEMA_INSTALLED`. A written descriptor requires `DESCRIPTOR_SCHEMA_FLOOR`.
+ */
+export const DESCRIPTOR_SCHEMA_ENV = "OMX_CONTRACT_SCHEMA";
+export const DESCRIPTOR_SCHEMA_INSTALLED = "/usr/share/omx-contract/omx-contract.schema.json";
+export const DESCRIPTOR_SCHEMA_FLOOR = ">= 3.0.0";
+/**
+ * Why a scanned descriptor is not written. A file the schema refuses is omx-contract's own
+ * `contract.file.invalid`; the others are the scanners' own.
+ */
+export const DESCRIPTOR_CODE_SCHEMA = "contract.file.invalid";
+export const DESCRIPTOR_CODE_SCHEMA_MISSING = "qualify.descriptor.schema-missing";
+export const DESCRIPTOR_CODE_BINARY_UNHASHED = "qualify.descriptor.binary-unhashed";
+export const DESCRIPTOR_CODE_DIR_UNWRITABLE = "qualify.descriptor.dir-unwritable";
 /**
  * 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

package/dist/qualify-declarations.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmixer/plugin-qualify",
-  "version": "0.13.0",
+  "version": "0.14.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": {

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);