@openmixer/plugin-qualify 0.18.5 → 0.20.0

package/tools/scan.py

@@ -62,23 +62,17 @@ REPORTS_LATENCY = LV2 + "reportsLatency"
 MINOR_VERSION = LV2 + "minorVersion"
 MICRO_VERSION = LV2 + "microVersion"
 
-# Common LV2 unit URIs -> display symbol. Plugins may also carry an explicit
-# units:symbol (handled below); this is the fallback for the standard units.
-KNOWN_UNITS = {
-    UNITS + "db": "dB", UNITS + "hz": "Hz", UNITS + "khz": "kHz",
-    UNITS + "s": "s", UNITS + "ms": "ms", UNITS + "pc": "%",
-    UNITS + "semitone12TET": "semi", UNITS + "cent": "ct",
-    UNITS + "degree": "deg", UNITS + "coef": "x", UNITS + "oct": "oct",
-    UNITS + "bpm": "BPM", UNITS + "midiNote": "note", UNITS + "frame": "fr",
-}
+# A port's unit is spelled as omx-contract's units sheet spells it (desc.unit_words), in the catalog and in the
+# descriptor alike; a unit the sheet has no word for falls to the plugin's own units:symbol in the catalog, and
+# is `unknown` in the descriptor.
+_UNIT_WORDS = None
 
-# LV2 unit URI -> the descriptor's unit word; any other unit, or none, is `unknown`
-DESCRIPTOR_UNITS = {
-    UNITS + "db": "dB", UNITS + "hz": "Hz", UNITS + "s": "s", UNITS + "ms": "ms",
-    UNITS + "min": "min", UNITS + "pc": "%", UNITS + "semitone12TET": "st", UNITS + "cent": "cents",
-    UNITS + "degree": "deg", UNITS + "coef": "x", UNITS + "oct": "oct", UNITS + "bpm": "bpm",
-    UNITS + "midiNote": "midiNote", UNITS + "frame": "frames",
-}
+
+def unit_words():
+    global _UNIT_WORDS
+    if _UNIT_WORDS is None:
+        _UNIT_WORDS = desc.unit_words()
+    return _UNIT_WORDS
 
 # lv2:designation -> the descriptor's meaning, where the meaning carries the LV2 term's name
 DESIGNATED_MEANINGS = {
@@ -178,7 +172,9 @@ class Scanner:
     def __init__(self):
         # lilv is imported here, not at module load: the owner mapping and the pure helpers
         # (test_scan.py) run on a host without the bindings, the way benchmark.py's worker does.
-        import lilv
+        from lilv_load import load_lilv
+
+        lilv = load_lilv()
 
         self.w = lilv.World()
         self.w.load_all()
@@ -206,8 +202,8 @@ class Scanner:
         if un is None:
             return None
         uri = str(un)
-        if uri in KNOWN_UNITS:
-            return KNOWN_UNITS[uri]
+        if uri in unit_words():
+            return unit_words()[uri]
         sym = first(self.w.find_nodes(un, self.u[UNITS + "symbol"], None))
         return str(sym) if sym is not None else None
 
@@ -377,7 +373,7 @@ class Scanner:
 
     def descriptor_unit(self, port):
         un = first(port.get_value(self.u[UNITS + "unit"]))
-        return DESCRIPTOR_UNITS.get(str(un), "unknown") if un is not None else "unknown"
+        return unit_words().get(str(un), "unknown") if un is not None else "unknown"
 
     def descriptor_control(self, port, link, readonly=False):
         """An input (or, readonly, an output) control port as a descriptor control."""

package/tools/audit-overlap.sh

@@ -1,250 +0,0 @@
-#!/usr/bin/env bash
-# SPDX-License-Identifier: GPL-3.0-or-later
-# Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
-#
-# audit-overlap.sh — every number in docs/audit-qualify-vs-compat.md, from source, by one command each.
-#
-#   tools/audit-overlap.sh <omx-clap-core dir> <plugin-hostd dir>
-#   tools/audit-overlap.sh --self-test
-#
-# It prints one line per unit (a function, or a set of functions, in one repository):
-#   unit <id> <repo> <file>:<first>-<last> lines=<n>
-# one line per pair that does the same job in two places:
-#   pair <a> <b> shared=<s> a=<na> b=<nb> overlap=<s/min(na,nb) %> diff=<changed lines or "-"> strings=<both/a/b>
-# and one line per counted marker:
-#   count <id> <repo> <n>
-# A unit is found by its name (a C or TypeScript function runs to the first column-0 `}`, a Python def or class
-# to the next column-0 statement), never by a line number, so the numbers follow the code. The audited commits are
-# printed first (`tree <repo> <commit>`); the document states which ones it quotes.
-#
-# Similarity: both bodies are normalised (comments, blank lines and lone braces dropped, whitespace squeezed), then
-# `shared` is the number of normalised lines the two have in common (comm -12 over the sorted lines, duplicates
-# kept) and `diff` the number of lines `diff` adds or removes between them. Code in two languages shares no line;
-# for it the pair prints overlap=0 and diff=-. `strings` is shared/a/b of the distinct string literals (three or
-# more characters) each body spells: messages, field names and codes, which survive a change of brace style or of
-# language, so a port of the same code shows there when its lines do not.
-set -euo pipefail
-export LC_ALL=C
-Q="$(cd "$(dirname "$0")/.." && pwd)"
-
-die() { echo "audit-overlap: $*" >&2; exit 2; }
-
-# span <lang> <file> <name> — print "<first> <last>" of the named unit, nothing when there is none
-span() { # <lang> <file> <name>
-  awk -v lang="$1" -v name="$3" '
-    function starts(l) {
-      if (lang == "py") return l ~ ("^(def|class) " name "[(:]")
-      if (lang == "ts") return l ~ ("^(export )?(async )?function " name "[(<]")
-      return l ~ ("^[A-Za-z].*[ *]" name "\\(") && l !~ /;[ \t]*$/
-    }
-    !on && starts($0) { on = 1; first = NR; last = NR; next }
-    on && lang != "py" && /^}/ { last = NR; print first, last; exit }
-    on && lang == "py" && /^[^ \t#\n]/ { print first, last; exit }
-    on && lang == "py" && /[^ \t]/ { last = NR }
-    END { if (on && lang == "py") print first, last }
-  ' "$2"
-}
-
-WORK="$(mktemp -d)"; trap 'rm -rf "$WORK"' EXIT
-declare -A ROOT LANG_OF
-
-# unit <id> <repo> <lang> <file> <name>... — one unit, the names' bodies concatenated
-unit() {
-  local id="$1" repo="$2" lang="$3" file="$4"; shift 4
-  local root="${ROOT[$repo]}" n total=0 where="" s
-  : > "$WORK/$id"
-  for n in "$@"; do
-    s="$(span "$lang" "$root/$file" "$n")"
-    [ -n "$s" ] || die "$repo $file: no $lang unit named $n"
-    local a b; read -r a b <<<"$s"
-    sed -n "${a},${b}p" "$root/$file" >> "$WORK/$id"
-    total=$((total + b - a + 1)); where="${where:+$where,}$a-$b"
-  done
-  LANG_OF[$id]="$lang"
-  echo "unit $id $repo $file:$where lines=$total"
-}
-
-# whole <id> <repo> <lang> <file> — a whole file as one unit
-whole() {
-  local id="$1" repo="$2" lang="$3" file="$4" n
-  cp "${ROOT[$repo]}/$file" "$WORK/$id"; n=$(wc -l < "$WORK/$id")
-  LANG_OF[$id]="$lang"
-  echo "unit $id $repo $file:1-$n lines=$n"
-}
-
-norm() { # <lang> < body
-  case "$1" in
-    py) sed -E 's/#.*$//' ;;
-    *)  sed -E 's#//.*$##; s#/\*.*\*/##g; /^[[:space:]]*\*( |\/|$)/d; /^[[:space:]]*\/\*/d' ;;
-  esac | sed -E 's/[[:space:]]+/ /g; s/^ //; s/ $//' | grep -vE '^[{}();, ]*$' || true
-}
-
-lits() { grep -oE "\"[^\"\\\\]{3,}\"|'[^'\\\\]{3,}'" | sed -E "s/^.(.*).$/\\1/"; } # quotes dropped: '' and "" alike
-
-pair() { # <a> <b>
-  local a="$1" b="$2" na nb s d m l
-  norm "${LANG_OF[$a]}" < "$WORK/$a" | sort > "$WORK/$a.n"
-  norm "${LANG_OF[$b]}" < "$WORK/$b" | sort > "$WORK/$b.n"
-  na=$(wc -l < "$WORK/$a.n"); nb=$(wc -l < "$WORK/$b.n")
-  s=$(comm -12 "$WORK/$a.n" "$WORK/$b.n" | wc -l)
-  m=$(( na < nb ? na : nb ))
-  if [ "${LANG_OF[$a]}" = "${LANG_OF[$b]}" ]; then
-    norm "${LANG_OF[$a]}" < "$WORK/$a" > "$WORK/$a.o"; norm "${LANG_OF[$b]}" < "$WORK/$b" > "$WORK/$b.o"
-    d=$(diff "$WORK/$a.o" "$WORK/$b.o" | grep -c '^[<>]' || true)
-  else d="-"; fi
-  # the string literals (messages, field names, codes) both spell: what survives a change of style or language
-  norm "${LANG_OF[$a]}" < "$WORK/$a" | lits | sort -u > "$WORK/$a.l" || true
-  norm "${LANG_OF[$b]}" < "$WORK/$b" | lits | sort -u > "$WORK/$b.l" || true
-  l="$(comm -12 "$WORK/$a.l" "$WORK/$b.l" | wc -l)/$(wc -l < "$WORK/$a.l")/$(wc -l < "$WORK/$b.l")"
-  echo "pair $a $b shared=$s a=$na b=$nb overlap=$(( m ? 100 * s / m : 0 ))% diff=$d strings=$l"
-}
-
-count() { # <id> <repo> <git grep args> -- <pathspec>...   (this audit's own two files are never counted)
-  local id="$1" repo="$2"; shift 2
-  local self=(":(exclude)tools/audit-overlap.sh" ":(exclude)docs/audit-qualify-vs-compat.md")
-  echo "count $id $repo $(git -C "${ROOT[$repo]}" grep -IE "$@" "${self[@]}" | wc -l)"
-}
-
-audit() {
-  local r
-  for r in qualify clap-core hostd; do echo "tree $r $(git -C "${ROOT[$r]}" rev-parse --short HEAD)"; done
-
-  # 1. plugin enumeration
-  unit q.clap-walk     qualify   c  native/clap-qualify.c is_clap walk scan
-  unit c.clap-walk     clap-core c  src/scan.c has_suffix walk main
-  unit q.clap-fork     qualify   c  native/clap-qualify.c scan_file
-  unit c.clap-fork     clap-core c  src/scan.c scan_file
-  unit q.clap-describe qualify   c  native/clap-qualify.c scan_file_entry scan_plugin scan_params scan_audio_ports
-  unit c.clap-describe clap-core c  src/scan.c put_file put_plugin put_descriptor put_params put_audio_ports
-  unit q.clap-path     qualify   ts src/clap-loader.ts clapSearchPath
-  unit c.clap-path     clap-core c  src/scan.c default_paths
-  unit q.lv2-manifest  qualify   ts src/lv2-loader.ts pluginsInManifest lv2BundlesOnPath
-  unit c.lv2-manifest  clap-core c  src/lv2_locate.c lv2_locate_manifest_names walk_dir lv2_locate
-  unit q.lv2-lilv      qualify   py tools/scan.py Scanner
-  unit c.lv2-lilv      clap-core py tests/lv2_parity.py lilv_facts
-  pair q.clap-walk c.clap-walk
-  pair q.clap-fork c.clap-fork
-  pair q.clap-describe c.clap-describe
-  pair q.clap-path c.clap-path
-  pair q.lv2-manifest c.lv2-manifest
-  pair q.lv2-lilv c.lv2-lilv
-  count q.calls-omx-clap-scan qualify -e 'omx-clap-scan' -- src
-  # clap-qualify's whole scan mode (--json), which writes the document omx-clap-scan writes, plus labels and pages
-  unit q.scan-mode     qualify   c  native/clap-qualify.c put_labels scan_params scan_remote_controls scan_audio_ports \
-                                    scan_plugin put_file_error scan_file_entry scan_file list_add is_clap walk scan
-  count c.scan-labels-pages clap-core -i -e 'remote_controls|enum_labels|"labels"' -- src/scan.c
-
-  # 2. deterministic input
-  count q.lcg-nr      qualify   -e '1664525u' -- native
-  count q.lcg-glibc   qualify   -e '1103515245u' -- native
-  count c.lcg-nr      clap-core -e '1664525u' -- tests src
-  unit q.noise-lv2    qualify   c  native/lv2-measure.c fill_input
-  unit c.signal       clap-core c  tests/jack_parity.c noise signal_at
-  pair q.noise-lv2 c.signal
-  unit q.notes        qualify   c  native/clap-qualify.c note_event note_midi note_key note_block note_dialect
-  unit q.notes-py     qualify   py tools/benchmark.py held_keys midi_sequence
-  unit c.notes        clap-core c  tests/jack_parity.c midi_events
-  pair q.notes c.notes
-  pair q.notes-py q.notes
-
-  # 3. isolated PipeWire, the feeder
-  count q.pipewire    qualify   -i -e 'pipewire|unshare' -- src native tools bin
-  count c.unshare     clap-core -e 'unshare' -- tests
-  unit c.pw-parity    clap-core py tests/lv2_parity.py start_pipewire
-  unit c.pw-coverage  clap-core py tests/clap_coverage.py start_pipewire
-  unit c.ns-parity    clap-core py tests/lv2_parity.py inside_run cmd_run
-  unit c.ns-coverage  clap-core py tests/clap_coverage.py inside_host cmd_host
-  unit c.clock        clap-core c  tests/jack_parity.c clock_process clock_state clock_wait clock_start clock_cycle clock_run
-  pair c.pw-parity c.pw-coverage
-  pair c.ns-parity c.ns-coverage
-
-  # 4. host launch, teardown, crash and hang
-  unit q.probe-runner qualify   ts src/probe-runner.ts runOne probeTarget
-  unit h.run-child    hostd     c  src/probe.c apply_limits kill_tree run_child child_end
-  unit q.bench-worker qualify   py tools/benchmark.py WorkerQueue _Worker
-  unit c.host-parity  clap-core py tests/lv2_parity.py Host run_plugin
-  unit c.host-coverage clap-core py tests/clap_coverage.py Host
-  pair c.host-parity c.host-coverage
-  pair q.bench-worker c.host-parity
-  count h.runs-clap-qualify hostd -e 'clap-qualify|clap_qualify' -- src
-  count h.runs-lv2-measure  hostd -e 'lv2_measure|lv2-measure' -- src
-
-  # 5. records, classification, vocabulary, reports
-  unit q.records      qualify   ts src/measurement/sweep-jsonl.ts measuredPluginsFromSweep parseJsonl
-  unit c.tsv-parity   clap-core py tests/lv2_parity.py read_tsv write_tsv
-  unit c.tsv-coverage clap-core py tests/clap_coverage.py read_tsv write_tsv append_tsv
-  pair c.tsv-parity c.tsv-coverage
-  unit q.classify     qualify   ts src/hosting-suitability.ts classifyPluginHosting
-  unit c.classify     clap-core py tests/lv2_parity.py _classify
-  pair q.classify c.classify
-  unit c.report       clap-core py tests/lv2_parity.py report_text
-  count q.contract-imports qualify -e "from \"@openmixer/omx-contract" -- src
-  count c.contract-macros  clap-core -e 'OMX_HOSTING_[A-Z_]+' -- src lv2
-  count q.handtyped-hosting qualify -e '"hosting\.[a-z-]+\.[a-z-]+"' -- 'src/*.ts' ':!src/*.test.ts'
-
-  # 6. cost and latency
-  unit q.pct-c        qualify   c  native/clap-qualify.c percentile_sorted
-  unit q.pct-py       qualify   py tools/benchmark.py percentile
-  unit q.cost-c       qualify   c  native/clap-qualify.c cost_rate
-  unit c.stage-bench  clap-core c  tests/stage_bench.c main
-  pair q.pct-c q.pct-py
-  pair q.cost-c c.stage-bench
-
-  # the probing programs plugin-hostd's probe runs as its children today, and what the move into its child deletes
-  whole q.prober-clap qualify c  native/clap-qualify.c
-  whole q.prober-lv2  qualify c  native/lv2-measure.c
-  whole q.benchmark   qualify py tools/benchmark.py
-
-  # 7. mod-host in plugin-qualify: code that runs it, and words that name it
-  count q.modhost-spawn qualify -e "spawn[A-Za-z]*\\(['\"]mod-host|execvp?\\(\"mod-host" -- src native tools bin
-  count q.modhost-words qualify -i -e 'mod-host' -- .
-  count c.modhost-words clap-core -i -e 'mod-host' -- tests
-}
-
-self_test() {
-  T="$(mktemp -d)"; local t="$T"; trap 'rm -rf "$T" "$WORK"' EXIT
-  for r in a b c; do mkdir -p "$t/$r"; git -C "$t/$r" init -q; done
-  cat > "$t/a/x.c" <<'EOF'
-static int one(int v)
-{
-  /* a comment */
-  return v + !"same"; /* "comment" */
-}
-static int two(int v) {
-  return v * 2;
-}
-EOF
-  cat > "$t/b/y.py" <<'EOF'
-def one(v):
-    # a comment
-    return v + len("same")  # "comment"
-
-X = 1
-EOF
-  cp "$t/a/x.c" "$t/c/z.c"; sed -i 's/v \* 2/v * 3/' "$t/c/z.c"
-  for r in a b c; do git -C "$t/$r" add -A; git -C "$t/$r" -c user.name=t -c user.email=t@t commit -qm t; done
-  ROOT[qualify]="$t/a"; ROOT[clap-core]="$t/b"; ROOT[hostd]="$t/c"
-  local out fail=0
-  expect() { grep -qxF -- "$1" <<<"$out" || { echo "self-test: missing: $1" >&2; fail=1; }; }
-  out="$(unit u1 qualify c x.c one; unit u2 qualify c x.c two; unit p1 clap-core py y.py one
-         unit h1 hostd c z.c one two; unit h2 qualify c x.c one two
-         pair h2 h1; pair u1 p1; count n qualify -e 'return' -- .)"
-  expect "unit u1 qualify x.c:1-5 lines=5"
-  expect "unit u2 qualify x.c:6-8 lines=3"
-  expect "unit p1 clap-core y.py:1-3 lines=3"
-  expect "pair h2 h1 shared=3 a=4 b=4 overlap=75% diff=2 strings=1/1/1"
-  expect "pair u1 p1 shared=0 a=2 b=2 overlap=0% diff=- strings=1/1/1"
-  expect "count n qualify 2"
-  # a name that is not there is refused, never counted as zero
-  if (unit u3 qualify c x.c three) 2>/dev/null; then echo "self-test: a missing unit was not refused" >&2; fail=1; fi
-  [ "$fail" = 0 ] && echo "audit-overlap self-test: ok"
-  return "$fail"
-}
-
-case "${1:-}" in
-  --self-test) self_test ;;
-  -h|--help|"") sed -n '5,9p' "$0"; [ -n "${1:-}" ] ;;
-  *) [ $# = 2 ] || die "usage: $0 <omx-clap-core dir> <plugin-hostd dir>"
-     ROOT[qualify]="$Q"; ROOT[clap-core]="$(cd "$1" && pwd)"; ROOT[hostd]="$(cd "$2" && pwd)"
-     audit ;;
-esac

package/tools/commit-message-check.sh

@@ -1,128 +0,0 @@
-#!/bin/bash
-# SPDX-License-Identifier: GPL-3.0-or-later
-# commit-message-check.sh: fail when a commit message carries an attribution line.
-#
-#   commit-message-check.sh <range>          every commit in the range (e.g. origin/main..HEAD)
-#   commit-message-check.sh --msg-file FILE  one message (the commit-msg hook; # lines are git comments, skipped)
-#   commit-message-check.sh --text-file FILE any text, every line judged (PR titles and bodies)
-#   commit-message-check.sh --selftest       fixtures plus a sabotage run
-#
-# Exit 0 clean, 1 a hit (each commit and offending line is named), 2 a range, file or pattern list that cannot be read
-# (any crash is 2). Callers refuse on 2: a checker that cannot judge is never a pass.
-# The patterns are commit-message-patterns.json beside this script, the same list the ops sweep strips
-# issue and PR text with, and the one list every door reads: merge-pr.sh, integrate-check.sh, pr-from-devel.sh
-# (ops/tools/tests/commit-message-one-list.t.sh refuses a second list). COMMIT_MESSAGE_PATTERNS names another JSON (self-tests). Repos that cannot see the ops tree carry a copy of both files.
-set -euo pipefail
-export COMMIT_MESSAGE_CHECK_SELF="${BASH_SOURCE[0]}"
-exec python3 -I - "$@" <<'PY'
-import json, os, re, subprocess, sys
-
-here = os.path.dirname(os.path.realpath(os.environ["COMMIT_MESSAGE_CHECK_SELF"]))
-pfile = os.environ.get("COMMIT_MESSAGE_PATTERNS") or os.path.join(here, "commit-message-patterns.json")
-
-
-def load():
-    with open(pfile, encoding="utf-8") as f:
-        return [(m["name"], re.compile(m["pattern"], re.I | re.M)) for m in json.load(f)["markers"]]
-
-
-def hits(text, markers):
-    out = []
-    for n, line in enumerate(text.splitlines(), 1):
-        for name, rx in markers:
-            if rx.search(line):
-                out.append((n, name, line.strip()))
-    return out
-
-
-def report(label, text, markers):
-    h = hits(text, markers)
-    for n, name, line in h:
-        print(f"{label}: line {n} [{name}]: {line}")
-    return len(h)
-
-
-def git(*a):
-    p = subprocess.run(["git", *a], capture_output=True, text=True)
-    if p.returncode:
-        print(f"commit-message-check: git {' '.join(a[:3])}: {p.stderr.strip()}", file=sys.stderr)
-        sys.exit(2)
-    return p.stdout
-
-
-def selftest():
-    # every marker is joined from fragments, so this file carries none of the lines it must refuse
-    CL, cl, AN, OP, CP, GEN = "Cl" + "aude", "cl" + "aude", "anthr" + "opic", "Op" + "us", "Copi" + "lot", "Gener" + "ated"
-    fx = {
-        "co-authored-by": f"Fix x\n\nCo-Authored-By: {CL} {OP} <noreply@{AN}.com>\n",
-        "session-trailer": f"Fix x\n\n{CL}-Session: https://{cl}.ai/code/session_01\n",
-        "generated-footer": f"Fix x\n\n\U0001F916 {GEN} with [{CL} Code](https://{cl}.com/{cl}-code)\n",
-        "session-url": f"Fix x\n\nsee https://{cl}.ai/code/session_9\n",
-        # the shapes the omx-dsp#155 review saw pass
-        "assisted-by": f"Fix x\n\nAssisted-by: {CL}\n",
-        "made-with": f"Fix x\n\nMade with {CL} Code\n",
-        "generated-with-claude": f"Fix x\n\n{GEN} with {CL}\n",
-        "generated-by-trailer": f"Fix x\n\nGenerated-by: {CL}\n",
-        "co-author-model": f"Fix x\n\nCo-authored-by: {OP} 5.5 <x@example.invalid>\n",
-        "co-author-github-copilot": f"Fix x\n\nCo-authored-by: GitHub {CP} <{CP.lower()}@github.com>\n",
-    }
-    clean = ("Fix x\n\nGenerated by the build; mentions .claude/ and a Co-Authored-By: Pau line.\n"
-             "Assisted-by: Pau Aliagas\nMade with care; generated with tools/rules-index-gen.sh\n"
-             f"A review quoted 'Assisted-by: {CL}' and 'Co-authored-by: {OP} 5.5 <x>' as shapes that passed.\n")
-    def run(markers):
-        bad = [k for k, v in fx.items() if not hits(v, markers)]
-        if hits(clean, markers):
-            bad.append("clean-flagged")
-        return bad
-    m = load()
-    first = run(m)
-    print("selftest:", "GREEN" if not first else f"RED {first}")
-    sab = run([x for x in m if x[0] not in ("co-authored-by", "ai-co-author", "anthropic-noreply", "session-trailer")])
-    print("sabotage (the co-author, email and session patterns removed):", "RED as expected" if sab else "still GREEN: blind")
-    # each #152 shape is seen by a pattern of its own family, not by luck
-    new = ["assisted-by", "made-with", "generated-with-claude", "generated-by-trailer", "co-author-model", "co-author-github-copilot"]
-    sab2 = run([x for x in m if x[0] not in ("ai-assisted-by", "generated-footer", "ai-co-author-model")])
-    blind = [k for k in new if k not in sab2]
-    print("sabotage (the assisted-by, generated and model co-author patterns removed):",
-          "RED as expected" if not blind else f"still GREEN for {blind}: blind")
-    return 0 if not first and sab and not blind else 1
-
-
-def main(a):
-    if a == ["--selftest"]:
-        return selftest()
-    markers = load()
-    if len(a) == 2 and a[0] == "--msg-file":
-        try:
-            text = open(a[1], encoding="utf-8", errors="replace").read()
-        except OSError as e:
-            print(f"commit-message-check: {e}", file=sys.stderr)
-            return 2
-        # lines git adds as comments are not part of the message
-        text = "\n".join(l for l in text.splitlines() if not l.startswith("#"))
-        return 1 if report("commit message", text, markers) else 0
-    if len(a) == 2 and a[0] == "--text-file":
-        try:
-            text = open(a[1], encoding="utf-8", errors="replace").read()
-        except OSError as e:
-            print(f"commit-message-check: {e}", file=sys.stderr)
-            return 2
-        return 1 if report("text", text, markers) else 0
-    if len(a) == 1 and not a[0].startswith("-"):
-        shas = git("rev-list", a[0]).split()
-        bad = 0
-        for sha in shas:
-            bad += report(sha[:12], git("log", "-1", "--format=%B", sha), markers)
-        print(f"commit-message-check: {len(shas)} commits, {bad} offending lines")
-        return 1 if bad else 0
-    print(__doc__ if False else "usage: commit-message-check.sh <range> | --msg-file FILE | --text-file FILE | --selftest", file=sys.stderr)
-    return 2
-
-
-try:
-    rc = main(sys.argv[1:])
-except Exception as e:  # a bad or missing pattern file, a decode error: unreadable, never "a hit"
-    print(f"commit-message-check: {type(e).__name__}: {e}", file=sys.stderr)
-    rc = 2
-sys.exit(rc)
-PY

package/tools/commit-message-patterns.json

@@ -1,41 +0,0 @@
-{
- "$comment": "Single source of the attribution patterns (Python re, flags IGNORECASE|MULTILINE). Read by the ops sweep and commit-message-check.sh. Edit here only. A trailer-shaped pattern that eats the rest of its line is anchored at the line start, so prose quoting a trailer keeps its text.",
- "markers": [
-  {
-   "name": "robot-footer",
-   "pattern": "^[^\\S\\r\\n]*[_*>]*[^\\S\\r\\n]*🤖[^\\r\\n]*?(?:Claude|claude\\.(?:ai|com))[^\\r\\n]*"
-  },
-  {
-   "name": "generated-footer",
-   "pattern": "(?:🤖[^\\S\\r\\n]*)?(?:Generated|Made)[^\\S\\r\\n]+(?:with|by)[^\\S\\r\\n]+\\[?Claude(?:[^\\S\\r\\n]+Code)?\\]?(?:\\([^)\\s]*\\))?"
-  },
-  {
-   "name": "co-authored-by",
-   "pattern": "Co-Authored-By:[^\\S\\r\\n]*Claude\\b[^\\r\\n<`]*(?:<[^>\\r\\n]*>)?"
-  },
-  {
-   "name": "ai-co-author",
-   "pattern": "Co-Authored-By:[^\\S\\r\\n]*(?:Anthropic|OpenAI|ChatGPT|Copilot|Gemini|Codex|Cursor|Aider|Devin)\\b[^\\r\\n<`]*(?:<[^>\\r\\n]*>)?"
-  },
-  {
-   "name": "ai-co-author-model",
-   "pattern": "^[^\\S\\r\\n]*Co-Authored-By:[^\\S\\r\\n]*(?:GitHub[^\\S\\r\\n]+Copilot|Opus|Sonnet|Haiku|Fable|GPT)\\b[^\\r\\n<`]*(?:<[^>\\r\\n]*>)?"
-  },
-  {
-   "name": "ai-assisted-by",
-   "pattern": "^[^\\S\\r\\n]*(?:Assisted|Generated)-By:[^\\S\\r\\n]*(?:Claude|Anthropic|OpenAI|ChatGPT|(?:GitHub[^\\S\\r\\n]+)?Copilot|Gemini|Codex|Cursor|Aider|Devin|Opus|Sonnet|Haiku|Fable|GPT)\\b[^\\r\\n<`]*(?:<[^>\\r\\n]*>)?"
-  },
-  {
-   "name": "anthropic-noreply",
-   "pattern": "noreply@anthropic\\.com"
-  },
-  {
-   "name": "claude-session",
-   "pattern": "Claude-Session:[^\\S\\r\\n]*[^\\s`]*"
-  },
-  {
-   "name": "claude.ai/code",
-   "pattern": "\\[[^\\]\\r\\n]*\\]\\([^\\S\\r\\n]*<?https?://claude\\.ai/code[^)\\s]*>?[^\\S\\r\\n]*\\)|<?https?://claude\\.ai/code\\b[^\\s)>`]*>?"
-  }
- ]
-}

package/tools/private-refs-check.sh

@@ -1,90 +0,0 @@
-#!/usr/bin/env bash
-# SPDX-License-Identifier: GPL-3.0-or-later
-# Copyright (C) 2026 Pau Aliagas <linuxnow@gmail.com>
-#
-# private-refs-check.sh — this repository is public, so its tracked files state facts and never point
-# into a private repository: no private repository name, no private issue or pull request number, no
-# private branch name or file path, no name of a private specification file. Say what the value is and
-# why instead, and cite only public repositories (omx-dsp, omx-contract, omx-plugins, omx-clap-core, plugin-qualify).
-# Product-name mentions of OpenMixer, and values such as the org.openmixer.* CLAP ids, the
-# urn:openmixer:* LV2 URIs and the @openmixer npm scope, are not pointers and are not matched.
-#
-#   tools/private-refs-check.sh              the check, over every tracked file (generated ones included)
-#   tools/private-refs-check.sh --self-test  each sabotage, in every kind of file, must go red
-#
-# ALLOW lists the tracked files exempt from the check, each with the reason; nothing else is.
-set -euo pipefail
-HERE="$(cd "$(dirname "$0")/.." && pwd)"
-
-# <file> — <why it may name them>
-ALLOW=(
-  "tools/private-refs-check.sh"   # it spells the patterns it looks for
-)
-EXTRA_PATHSPEC=()                 # the self-test sets a bad one, to prove a git grep error is red
-
-# Extended regexps, matched case-insensitively. A new kind of pointer is one line here.
-PATTERNS=(
-  'FreeMixer/openmixer([^A-Za-z0-9_-]|$)'             # the private repository
-  'openmixer-ops'                                     # the private operations repository
-  'openmixer ?#[0-9]'                                 # one of its issues or pull requests
-  '[A-Za-z0-9_.]-dev#[0-9]'                           # an issue of a private *-dev repository
-  'integration/[A-Za-z0-9]'                           # a private integration branch
-  'packages/[a-z][a-z0-9-]+'                          # a path into the private repository's packages
-  '\.vue([^A-Za-z0-9_]|$)'                            # its web UI components
-  "openmixer's spec"                                  # its specification files
-  'docs/design/'                                      # its design documents
-  'harness/'                                          # its test harness
-  '20[0-9]{2}-[0-9]{2}-[0-9]{2}-[a-z][a-z0-9-]+\.md'  # a dated specification file name
-  'spec 20[0-9]{2}-[0-9]{2}-[0-9]{2}'                 # a citation of one
-)
-
-check() { # <root>
-  local root="$1" fail=0 args=() p a hits
-  for p in "${PATTERNS[@]}"; do args+=(-e "$p"); done
-  local excl=()
-  for a in "${ALLOW[@]}"; do excl+=(":(exclude)${a%% *}"); done
-  [ -n "$(git -C "$root" ls-files)" ] || { echo "private-refs-check: git lists no file" >&2; return 1; }
-  # git grep exits 1 for no match and 128 or more for an error; an error must not read as "no hits"
-  hits=$(git -C "$root" grep -nIiE "${args[@]}" -- . "${excl[@]}" "${EXTRA_PATHSPEC[@]}") || rc=$?
-  case "${rc:-0}" in 0|1) ;; *) echo "private-refs-check: git grep failed (exit $rc)" >&2; return 1 ;; esac
-  hits=$(printf '%s' "$hits" | cut -c1-200)
-  [ -z "$hits" ] || { printf '%s\n' "$hits" >&2; fail=1; }
-  [ "$fail" = 0 ] || { echo "private-refs-check: the lines above point into private repositories; state the fact instead" >&2; return 1; }
-  echo "private-refs-check: no tracked file points into a private repository"
-}
-
-if [ "${1:-}" = --self-test ]; then
-  scratch="$(mktemp -d)"; trap 'rm -rf "$scratch"' EXIT
-  fail=0
-  # a clean tree with one file of each kind the repository tracks; every sabotage writes one private pointer into one
-  mk() { rm -rf "$scratch/t"; mkdir -p "$scratch/t/src" "$scratch/t/tools" "$scratch/t/docs"
-    git -C "$scratch" init -q t
-    printf 'rdfs:comment "The OpenMixer console x." ;\nlv2:binary <x.so> ; # urn:openmixer:x\n' > "$scratch/t/src/x.ttl"
-    printf '// org.openmixer.x, @openmixer/x\n' > "$scratch/t/tools/gen.mjs"
-    printf '# Docs\n\nOpenMixer plugins.\n' > "$scratch/t/docs/a.md"
-    printf '/* x */\n' > "$scratch/t/src/x.h"; printf '#!/bin/sh\n# x\n' > "$scratch/t/tools/x.sh"; }
-  sab() { # <name> <file> <line>
-    mk; printf '%s\n' "$3" >> "$scratch/t/$2"; git -C "$scratch/t" add -A
-    if check "$scratch/t" >/dev/null 2>&1; then echo "SABOTAGE $1: STAYED GREEN"; fail=1; else echo "SABOTAGE $1: red"; fi; }
-  mk; git -C "$scratch/t" add -A
-  check "$scratch/t" >/dev/null || { echo "self-test: the clean tree is not green" >&2; exit 1; }
-  sab repo-in-header src/x.h                         '/* as FreeMixer/openmixer draws it */'
-  sab branch-in-sh   tools/x.sh                      '# drawn on integration/lean-engine'
-  sab issue-in-md    docs/a.md                       'see openmixer#1580'
-  sab path-in-md     docs/a.md                       'packages/web-ui/Foo.vue'
-  sab default-path   tools/x.sh                      'plugin=${P:-$root/../openmixer/packages/omx-plugins/bin/omx-delay.clap}'
-  sab ops-in-mjs     tools/gen.mjs                   '// see openmixer-ops'
-  sab dev-in-mjs     tools/gen.mjs                   '// omx-dsp-dev#32'
-  sab spec-in-mjs    tools/gen.mjs                   "// openmixer's spec 2026-10-09-plugin-from-contract.md"
-  sab ttl            src/x.ttl       'rdfs:comment "see FreeMixer/openmixer#12" ;'
-  sab header         src/x.h         '/* packages/core/src/x.ts */'
-  sab design-dir     docs/a.md                       'the notes in docs/design/specs'
-  sab harness-dir    tools/gen.mjs                   '// harness/dsp-check.sh'
-  mk; git -C "$scratch/t" add -A
-  if ( EXTRA_PATHSPEC=(":(bogus)x"); check "$scratch/t" >/dev/null 2>&1 ); then echo "SABOTAGE git-grep-error: STAYED GREEN"; fail=1; else echo "SABOTAGE git-grep-error: red"; fi
-  [ "$fail" = 0 ] || exit 1
-  check "$HERE" >/dev/null || { echo "self-test: the repository is not green" >&2; exit 1; }
-  echo "private-refs-check self-test: every sabotage red"
-  exit 0
-fi
-check "$HERE"