@openmixer/plugin-qualify 0.20.1 → 0.20.4

package/dist/run-home.js

@@ -0,0 +1,26 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * The HOME every process that loads a plugin starts with: a scratch directory of this plugin-qualify run, never the
+ * caller's real home. A plugin that reads its user data from HOME (Surge XT) segfaults or stays silent without one,
+ * and a probe must not write into a user's home. Created on first use, removed when the process exits.
+ */
+import { mkdirSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+let home;
+/** The run's scratch HOME, made on first use. */
+export function runHome() {
+    if (home === undefined) {
+        const dir = mkdtempSync(join(tmpdir(), "plugin-qualify-home-"));
+        process.on("exit", () => rmSync(dir, { recursive: true, force: true }));
+        home = join(dir, "home");
+        mkdirSync(home);
+    }
+    return home;
+}
+/** `env` with HOME set to the run's scratch HOME. */
+export function withRunHome(env) {
+    return { ...env, HOME: runHome() };
+}
+//# sourceMappingURL=run-home.js.map

package/dist/run-home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-home.js","sourceRoot":"","sources":["../src/run-home.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,IAAI,IAAwB,CAAC;AAE7B,iDAAiD;AACjD,MAAM,UAAU,OAAO;IACrB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,sBAAsB,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACxE,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzB,SAAS,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,WAAW,CAAC,GAAiD;IAC3E,OAAO,EAAE,GAAG,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;AACrC,CAAC"}

package/dist/text-catalog.d.ts

@@ -0,0 +1,41 @@
+import type { ReasonText, TextRef } from "./text-codes.js";
+export declare const OWNER = "plugin-qualify";
+export declare const CATALOGS_DIR_ENV = "PLUGIN_QUALIFY_CATALOGS_DIR";
+/** Where this package's own `catalogs/<lang>.json` live: `PLUGIN_QUALIFY_CATALOGS_DIR`, else beside this module's package. */
+export declare function catalogsDir(env?: Readonly<Record<string, string | undefined>>): string;
+/** One code of `schema/codes.json`: the code, the args its sentence names and the sentence. */
+export interface DeclaredCode {
+    readonly code: string;
+    readonly doc?: string;
+    readonly text: {
+        readonly en: string;
+    };
+    readonly args: readonly string[];
+}
+/** One catalog entry: the sentence, or the sentence with how it was made (omx-contract's `catalogEntry`). */
+export type CatalogEntry = string | {
+    readonly text: string;
+    readonly by: "human" | "machine";
+    readonly model?: string;
+    readonly source?: string;
+};
+/** Where the codes are declared: `schema/codes.json` of this package. */
+export declare const CODES_FILE: string;
+/** Every code `schema/codes.json` declares, by its code; none where the file does not read. */
+export declare function declaredCodes(): ReadonlyMap<string, DeclaredCode>;
+/** `catalogs/<lang>.json`'s `messages`, or `undefined` where the file is absent or does not read as one. */
+export declare function loadMessages(lang: string, dir?: string): Record<string, CatalogEntry> | undefined;
+/** `sentence` with each `{name}` replaced by `args[name]`; a placeholder with no value is left as written. */
+export declare function fill(sentence: string, args?: Readonly<Record<string, string | number>>): string;
+/** The sha256 of a source sentence, lowercase hex of its UTF-8 bytes: what a model's entry records as `source`. */
+export declare const sourceHash: (sentence: string) => string;
+/** The sentence of `entry`; `undefined` for no entry, or a model's entry made from another sentence than `source`. */
+export declare function entrySentence(entry: CatalogEntry | undefined, source: string): string | undefined;
+/** The source sentence `code` was declared with (`schema/codes.json`); throws on a code this package never declared. */
+export declare function sourceOf(code: string): string;
+/** `ref` rendered for `lang`: the catalog's sentence, else the source, its `{placeholder}`s filled. `lang` undefined or "en" skips the catalog. */
+export declare function textOf(ref: TextRef, lang?: string): string;
+/** A {@link ReasonText} rendered for `lang`: another tool's own words pass straight through; plugin-qualify's own go through {@link textOf}. */
+export declare function reasonText(reason: ReasonText, lang?: string): string;
+/** The language of `LC_ALL`, else `LANG` (the POSIX precedence), as the two letters before `_` or `.`; `undefined` unset, unparsed, or `C`/`POSIX` (textOf's own fallback to the source sentence is the same as leaving this undefined). */
+export declare function localeOf(env?: Readonly<Record<string, string | undefined>>): string | undefined;

package/dist/text-catalog.js

@@ -0,0 +1,97 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * The sentence a surface shows for one of plugin-qualify's own {@link TextRef}s: the catalog's, for the given
+ * language, else the source sentence `schema/codes.json` declares; its `{placeholder}`s filled from `args`
+ * An entry is the sentence, or the sentence with how it was made (omx-contract 3.16.0's `catalogEntry`); a model's
+ * entry made from another source sentence is stale and skipped. This is the lookup of
+ * `@openmixer/omx-contract/catalog` (`sentenceOf`, `fill`), made here: that module reads its schema through ajv, which
+ * this package does not depend on, and the npm floor is below the release that knows an entry's provenance.
+ *
+ * `schema/codes.json` and `catalogs/<lang>.json` ship inside this package (`package.json`'s `files`), read relative
+ * to this module so it works from `src/` under vitest and from `dist/` once built alike. `PLUGIN_QUALIFY_CATALOGS_DIR`
+ * names another catalogs directory instead, for a test that wants its own fixture catalogs.
+ */
+import { createHash } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export const OWNER = "plugin-qualify";
+export const CATALOGS_DIR_ENV = "PLUGIN_QUALIFY_CATALOGS_DIR";
+const PKG = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+/** Where this package's own `catalogs/<lang>.json` live: `PLUGIN_QUALIFY_CATALOGS_DIR`, else beside this module's package. */
+export function catalogsDir(env = process.env) {
+    return env[CATALOGS_DIR_ENV] ?? join(PKG, "catalogs");
+}
+/** Where the codes are declared: `schema/codes.json` of this package. */
+export const CODES_FILE = join(PKG, "schema", "codes.json");
+let declared;
+/** Every code `schema/codes.json` declares, by its code; none where the file does not read. */
+export function declaredCodes() {
+    if (declared !== undefined)
+        return declared;
+    let codes = {};
+    try {
+        codes = JSON.parse(readFileSync(CODES_FILE, "utf8")).codes ?? {};
+    }
+    catch {
+        codes = {};
+    }
+    declared = new Map(Object.values(codes).map((c) => [c.code, c]));
+    return declared;
+}
+const messagesCache = new Map();
+/** `catalogs/<lang>.json`'s `messages`, or `undefined` where the file is absent or does not read as one. */
+export function loadMessages(lang, dir = catalogsDir()) {
+    const cacheKey = `${dir}\0${lang}`;
+    if (messagesCache.has(cacheKey))
+        return messagesCache.get(cacheKey);
+    let messages;
+    try {
+        const catalog = JSON.parse(readFileSync(join(dir, `${lang}.json`), "utf8"));
+        messages = catalog.messages;
+    }
+    catch {
+        messages = undefined;
+    }
+    messagesCache.set(cacheKey, messages);
+    return messages;
+}
+/** `sentence` with each `{name}` replaced by `args[name]`; a placeholder with no value is left as written. */
+export function fill(sentence, args = {}) {
+    return sentence.replace(/\{([^{}]*)\}/g, (m, n) => (Object.hasOwn(args, n) ? String(args[n]) : m));
+}
+/** The sha256 of a source sentence, lowercase hex of its UTF-8 bytes: what a model's entry records as `source`. */
+export const sourceHash = (sentence) => createHash("sha256").update(sentence, "utf8").digest("hex");
+/** The sentence of `entry`; `undefined` for no entry, or a model's entry made from another sentence than `source`. */
+export function entrySentence(entry, source) {
+    if (entry === undefined || typeof entry === "string")
+        return entry;
+    return entry.source !== undefined && entry.source !== sourceHash(source) ? undefined : entry.text;
+}
+/** The source sentence `code` was declared with (`schema/codes.json`); throws on a code this package never declared. */
+export function sourceOf(code) {
+    const source = declaredCodes().get(code)?.text.en;
+    if (source === undefined)
+        throw new Error(`plugin-qualify declares no source sentence for ${code}`);
+    return source;
+}
+/** `ref` rendered for `lang`: the catalog's sentence, else the source, its `{placeholder}`s filled. `lang` undefined or "en" skips the catalog. */
+export function textOf(ref, lang) {
+    const source = sourceOf(ref.code);
+    const sentence = lang === undefined || lang === "en" ? source : (entrySentence(loadMessages(lang)?.[ref.code], source) ?? source);
+    return fill(sentence, ref.args ?? {});
+}
+/** A {@link ReasonText} rendered for `lang`: another tool's own words pass straight through; plugin-qualify's own go through {@link textOf}. */
+export function reasonText(reason, lang) {
+    return typeof reason === "string" ? reason : textOf(reason, lang);
+}
+/** The language of `LC_ALL`, else `LANG` (the POSIX precedence), as the two letters before `_` or `.`; `undefined` unset, unparsed, or `C`/`POSIX` (textOf's own fallback to the source sentence is the same as leaving this undefined). */
+export function localeOf(env = process.env) {
+    const raw = env["LC_ALL"] || env["LANG"];
+    if (raw === undefined || raw === "")
+        return undefined;
+    const m = /^([a-z]{2})(?:[_.].*)?$/.exec(raw);
+    return m?.[1];
+}
+//# sourceMappingURL=text-catalog.js.map

package/dist/text-catalog.js.map

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

package/dist/text-codes.d.ts

@@ -0,0 +1,29 @@
+/**
+ * plugin-qualify's own verdict and reason sentences, as codes (omx-contract#2, "codes then catalogs", owner
+ * ruling 2026-11-09: a code carries its identifier, its arguments and one source sentence in English with named
+ * placeholders; translations live in catalogs the owner ships, keyed by code, checked for placeholders against the
+ * code's `args`; a surface looks up the sentence for the user's locale and falls back to this source sentence).
+ *
+ * plugin-qualify is the owner of these codes (the hosting.* codes of {@link ../hosting-codes.js} are omx-clap-core's
+ * instead, and that package owns their catalogs). A code, its args and its source sentence are written once, in
+ * `schema/codes.json`; {@link TEXT_CODE} is that file's `key: code` map, generated (`tools/gen-text-codes.mjs`), so a
+ * call site names a code by its key and no sentence is written in a module. `catalogs/<lang>.json`, read by
+ * {@link ../text-catalog.js}, hold each listed language's sentences; `src/text-catalog-conformance.test.ts` turns red
+ * on a code without its source sentence or without an entry in a language, and on a sentence whose placeholders are
+ * not its code's `args`.
+ */
+import { TEXT_CODE, TEXT_CODE_ARGS } from "./text-codes.generated.js";
+export { TEXT_CODE, TEXT_CODE_ARGS };
+/** A key of {@link TEXT_CODE}. */
+export type TextCodeKey = keyof typeof TEXT_CODE;
+/** A code of {@link TEXT_CODE} with the arguments its source sentence names. A reader renders it; it is never prose itself. */
+export interface TextRef {
+    readonly code: string;
+    readonly args?: Readonly<Record<string, string | number>>;
+}
+/**
+ * A reason as plugin-qualify writes it: its own sentence as a {@link TextRef}, or another tool's own words passed
+ * through unclassified (the shape `UnmeasuredFigure.detail` already uses elsewhere: a prober's raw text is never
+ * coded, since nothing here can translate words it did not write).
+ */
+export type ReasonText = TextRef | string;

package/dist/text-codes.generated.d.ts

@@ -0,0 +1,88 @@
+/** plugin-qualify's own codes, by key (schema/codes.json). */
+export declare const TEXT_CODE: Readonly<{
+    readonly descriptorDuplicateSymbol: "qualify.descriptor.duplicate-symbol";
+    readonly compareHostNotInstalled: "qualify.compare.host-not-installed";
+    readonly compareHostDidNotStart: "qualify.compare.host-did-not-start";
+    readonly compareHostNotAsked: "qualify.compare.host-not-asked";
+    readonly compareHostDidNotRun: "qualify.compare.host-did-not-run";
+    readonly compareFormatNotTaken: "qualify.compare.format-not-taken";
+    readonly compareRtNotReported: "qualify.compare.rt-not-reported";
+    readonly compareRtNoCallback: "qualify.compare.rt-no-callback";
+    readonly compareRtNoWarmUp: "qualify.compare.rt-no-warm-up";
+    readonly compareRtTrylocksOnly: "qualify.compare.rt-trylocks-only";
+    readonly compareRtUnsafe: "qualify.compare.rt-unsafe";
+    readonly compareLoadHostEnded: "qualify.compare.load-host-ended";
+    readonly compareLoadResp: "qualify.compare.load-resp";
+    readonly compareLoadTimeout: "qualify.compare.load-timeout";
+    readonly compareNotLoaded: "qualify.compare.not-loaded";
+    readonly compareNoPort: "qualify.compare.no-port";
+    readonly compareNotRunning: "qualify.compare.not-running";
+    readonly compareNoAudioOutput: "qualify.compare.no-audio-output";
+    readonly compareOutputNotFinite: "qualify.compare.output-not-finite";
+    readonly compareNoStimulusSilent: "qualify.compare.no-stimulus-silent";
+    readonly compareSilentUnderStimulus: "qualify.compare.silent-under-stimulus";
+    readonly compareCyclesNotRun: "qualify.compare.cycles-not-run";
+    readonly compareCycleHostEnded: "qualify.compare.cycle-host-ended";
+    readonly compareCycleFailed: "qualify.compare.cycle-failed";
+    readonly compareCycleFailedAt: "qualify.compare.cycle-failed-at";
+    readonly compareSoakHostEnded: "qualify.compare.soak-host-ended";
+    readonly compareSoakEnded: "qualify.compare.soak-ended";
+    readonly compareLatencyPortObservable: "qualify.compare.latency-port-observable";
+    readonly compareLatencyHostdPortObservable: "qualify.compare.latency-hostd-port-observable";
+    readonly compareLatencyNotObservableModHost: "qualify.compare.latency-not-observable-mod-host";
+    readonly compareLatencyUnreadable: "qualify.compare.latency-unreadable";
+    readonly compareSkippedReason: "qualify.compare.skipped-reason";
+    readonly compareDoesBetterOn: "qualify.compare.does-better-on";
+    readonly compareBeatDescription: "qualify.compare.beat-description";
+    readonly compareNotPublishableWithMissing: "qualify.compare.not-publishable-with-missing";
+    readonly compareNotPublishableNoFlag: "qualify.compare.not-publishable-no-flag";
+    readonly pinHostdNotInstalled: "qualify.pin.hostd-not-installed";
+    readonly pinHostdNoPinFiles: "qualify.pin.hostd-no-pin-files";
+    readonly pinHostdExited: "qualify.pin.hostd-exited";
+    readonly pinHostdNoRootOrFile: "qualify.pin.hostd-no-root-or-file";
+    readonly pinFileUnreadable: "qualify.pin.file-unreadable";
+}>;
+/** The args each code's source sentence names, by the same key. */
+export declare const TEXT_CODE_ARGS: Readonly<{
+    readonly descriptorDuplicateSymbol: readonly ["symbol"];
+    readonly compareHostNotInstalled: readonly ["program"];
+    readonly compareHostDidNotStart: readonly ["program"];
+    readonly compareHostNotAsked: readonly [];
+    readonly compareHostDidNotRun: readonly ["program"];
+    readonly compareFormatNotTaken: readonly ["program", "format"];
+    readonly compareRtNotReported: readonly [];
+    readonly compareRtNoCallback: readonly [];
+    readonly compareRtNoWarmUp: readonly [];
+    readonly compareRtTrylocksOnly: readonly ["trylocks", "cycles"];
+    readonly compareRtUnsafe: readonly ["cycles", "allocations", "locks", "syscalls"];
+    readonly compareLoadHostEnded: readonly ["died"];
+    readonly compareLoadResp: readonly ["resp"];
+    readonly compareLoadTimeout: readonly [];
+    readonly compareNotLoaded: readonly [];
+    readonly compareNoPort: readonly [];
+    readonly compareNotRunning: readonly [];
+    readonly compareNoAudioOutput: readonly [];
+    readonly compareOutputNotFinite: readonly ["count"];
+    readonly compareNoStimulusSilent: readonly [];
+    readonly compareSilentUnderStimulus: readonly ["stimulus"];
+    readonly compareCyclesNotRun: readonly [];
+    readonly compareCycleHostEnded: readonly ["cycle", "died"];
+    readonly compareCycleFailed: readonly ["cycle"];
+    readonly compareCycleFailedAt: readonly ["cycle", "step"];
+    readonly compareSoakHostEnded: readonly ["died"];
+    readonly compareSoakEnded: readonly [];
+    readonly compareLatencyPortObservable: readonly [];
+    readonly compareLatencyHostdPortObservable: readonly [];
+    readonly compareLatencyNotObservableModHost: readonly [];
+    readonly compareLatencyUnreadable: readonly [];
+    readonly compareSkippedReason: readonly ["reason"];
+    readonly compareDoesBetterOn: readonly ["host", "count", "detail"];
+    readonly compareBeatDescription: readonly ["id", "on", "over"];
+    readonly compareNotPublishableWithMissing: readonly ["missing"];
+    readonly compareNotPublishableNoFlag: readonly [];
+    readonly pinHostdNotInstalled: readonly [];
+    readonly pinHostdNoPinFiles: readonly [];
+    readonly pinHostdExited: readonly ["status"];
+    readonly pinHostdNoRootOrFile: readonly [];
+    readonly pinFileUnreadable: readonly ["error"];
+}>;

package/dist/text-codes.generated.js

@@ -0,0 +1,96 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+//
+// GENERATED by tools/gen-text-codes.mjs from schema/codes.json — do not hand-edit.
+//
+// Regenerate: node tools/gen-text-codes.mjs --write
+// Verify:     node tools/gen-text-codes.mjs --check
+/** plugin-qualify's own codes, by key (schema/codes.json). */
+export const TEXT_CODE = Object.freeze({
+    descriptorDuplicateSymbol: "qualify.descriptor.duplicate-symbol",
+    compareHostNotInstalled: "qualify.compare.host-not-installed",
+    compareHostDidNotStart: "qualify.compare.host-did-not-start",
+    compareHostNotAsked: "qualify.compare.host-not-asked",
+    compareHostDidNotRun: "qualify.compare.host-did-not-run",
+    compareFormatNotTaken: "qualify.compare.format-not-taken",
+    compareRtNotReported: "qualify.compare.rt-not-reported",
+    compareRtNoCallback: "qualify.compare.rt-no-callback",
+    compareRtNoWarmUp: "qualify.compare.rt-no-warm-up",
+    compareRtTrylocksOnly: "qualify.compare.rt-trylocks-only",
+    compareRtUnsafe: "qualify.compare.rt-unsafe",
+    compareLoadHostEnded: "qualify.compare.load-host-ended",
+    compareLoadResp: "qualify.compare.load-resp",
+    compareLoadTimeout: "qualify.compare.load-timeout",
+    compareNotLoaded: "qualify.compare.not-loaded",
+    compareNoPort: "qualify.compare.no-port",
+    compareNotRunning: "qualify.compare.not-running",
+    compareNoAudioOutput: "qualify.compare.no-audio-output",
+    compareOutputNotFinite: "qualify.compare.output-not-finite",
+    compareNoStimulusSilent: "qualify.compare.no-stimulus-silent",
+    compareSilentUnderStimulus: "qualify.compare.silent-under-stimulus",
+    compareCyclesNotRun: "qualify.compare.cycles-not-run",
+    compareCycleHostEnded: "qualify.compare.cycle-host-ended",
+    compareCycleFailed: "qualify.compare.cycle-failed",
+    compareCycleFailedAt: "qualify.compare.cycle-failed-at",
+    compareSoakHostEnded: "qualify.compare.soak-host-ended",
+    compareSoakEnded: "qualify.compare.soak-ended",
+    compareLatencyPortObservable: "qualify.compare.latency-port-observable",
+    compareLatencyHostdPortObservable: "qualify.compare.latency-hostd-port-observable",
+    compareLatencyNotObservableModHost: "qualify.compare.latency-not-observable-mod-host",
+    compareLatencyUnreadable: "qualify.compare.latency-unreadable",
+    compareSkippedReason: "qualify.compare.skipped-reason",
+    compareDoesBetterOn: "qualify.compare.does-better-on",
+    compareBeatDescription: "qualify.compare.beat-description",
+    compareNotPublishableWithMissing: "qualify.compare.not-publishable-with-missing",
+    compareNotPublishableNoFlag: "qualify.compare.not-publishable-no-flag",
+    pinHostdNotInstalled: "qualify.pin.hostd-not-installed",
+    pinHostdNoPinFiles: "qualify.pin.hostd-no-pin-files",
+    pinHostdExited: "qualify.pin.hostd-exited",
+    pinHostdNoRootOrFile: "qualify.pin.hostd-no-root-or-file",
+    pinFileUnreadable: "qualify.pin.file-unreadable",
+});
+/** The args each code's source sentence names, by the same key. */
+export const TEXT_CODE_ARGS = Object.freeze({
+    descriptorDuplicateSymbol: ["symbol"],
+    compareHostNotInstalled: ["program"],
+    compareHostDidNotStart: ["program"],
+    compareHostNotAsked: [],
+    compareHostDidNotRun: ["program"],
+    compareFormatNotTaken: ["program", "format"],
+    compareRtNotReported: [],
+    compareRtNoCallback: [],
+    compareRtNoWarmUp: [],
+    compareRtTrylocksOnly: ["trylocks", "cycles"],
+    compareRtUnsafe: ["cycles", "allocations", "locks", "syscalls"],
+    compareLoadHostEnded: ["died"],
+    compareLoadResp: ["resp"],
+    compareLoadTimeout: [],
+    compareNotLoaded: [],
+    compareNoPort: [],
+    compareNotRunning: [],
+    compareNoAudioOutput: [],
+    compareOutputNotFinite: ["count"],
+    compareNoStimulusSilent: [],
+    compareSilentUnderStimulus: ["stimulus"],
+    compareCyclesNotRun: [],
+    compareCycleHostEnded: ["cycle", "died"],
+    compareCycleFailed: ["cycle"],
+    compareCycleFailedAt: ["cycle", "step"],
+    compareSoakHostEnded: ["died"],
+    compareSoakEnded: [],
+    compareLatencyPortObservable: [],
+    compareLatencyHostdPortObservable: [],
+    compareLatencyNotObservableModHost: [],
+    compareLatencyUnreadable: [],
+    compareSkippedReason: ["reason"],
+    compareDoesBetterOn: ["host", "count", "detail"],
+    compareBeatDescription: ["id", "on", "over"],
+    compareNotPublishableWithMissing: ["missing"],
+    compareNotPublishableNoFlag: [],
+    pinHostdNotInstalled: [],
+    pinHostdNoPinFiles: [],
+    pinHostdExited: ["status"],
+    pinHostdNoRootOrFile: [],
+    pinFileUnreadable: ["error"],
+});
+//# sourceMappingURL=text-codes.generated.js.map

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

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

package/dist/text-codes.js

@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+// Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
+/**
+ * plugin-qualify's own verdict and reason sentences, as codes (omx-contract#2, "codes then catalogs", owner
+ * ruling 2026-11-09: a code carries its identifier, its arguments and one source sentence in English with named
+ * placeholders; translations live in catalogs the owner ships, keyed by code, checked for placeholders against the
+ * code's `args`; a surface looks up the sentence for the user's locale and falls back to this source sentence).
+ *
+ * plugin-qualify is the owner of these codes (the hosting.* codes of {@link ../hosting-codes.js} are omx-clap-core's
+ * instead, and that package owns their catalogs). A code, its args and its source sentence are written once, in
+ * `schema/codes.json`; {@link TEXT_CODE} is that file's `key: code` map, generated (`tools/gen-text-codes.mjs`), so a
+ * call site names a code by its key and no sentence is written in a module. `catalogs/<lang>.json`, read by
+ * {@link ../text-catalog.js}, hold each listed language's sentences; `src/text-catalog-conformance.test.ts` turns red
+ * on a code without its source sentence or without an entry in a language, and on a sentence whose placeholders are
+ * not its code's `args`.
+ */
+import { TEXT_CODE, TEXT_CODE_ARGS } from "./text-codes.generated.js";
+export { TEXT_CODE, TEXT_CODE_ARGS };
+//# sourceMappingURL=text-codes.js.map

package/dist/text-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-codes.js","sourceRoot":"","sources":["../src/text-codes.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,sDAAsD;AACtD;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC"}

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@openmixer/plugin-qualify",
-  "version": "0.20.1",
+  "version": "0.20.4",
   "description": "Qualify audio plugins for real-time hosting: scan, offline latency and cost measurement, 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"
+    "url": "git+https://github.com/Open-Mixer/plugin-qualify.git"
   },
   "author": "Pau Aliagas <linuxnow@gmail.com>",
-  "homepage": "https://github.com/FreeMixer/plugin-qualify#readme",
+  "homepage": "https://github.com/Open-Mixer/plugin-qualify#readme",
   "bugs": {
-    "url": "https://github.com/FreeMixer/plugin-qualify/issues"
+    "url": "https://github.com/Open-Mixer/plugin-qualify/issues"
   },
   "engines": {
     "node": ">=18"
@@ -75,16 +75,18 @@
     "!**/__pycache__",
     "!**/*.pyc",
     "fixtures",
+    "schema/codes.json",
+    "catalogs",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
-    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && node tools/gen-hosting-codes.mjs --build && tsc -p tsconfig.json",
+    "build": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\" && node tools/gen-hosting-codes.mjs --build && node tools/gen-text-codes.mjs --write && 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 && node tools/gen-hosting-codes.mjs --check",
+    "check:generated": "node tools/gen-python-declarations.mjs --check && node tools/gen-hosting-codes.mjs --check && node tools/gen-text-codes.mjs --check",
     "check:private-refs": "${FREEMIXER_DOTGITHUB:-../freemixer-dotgithub}/.github/actions/private-refs-check/check.sh ."
   },
   "devDependencies": {