champollion 0.3.4 → 0.4.0

package/shared/curated-orthography-conventions.json

@@ -1,25 +1,43 @@
 {
   "_comment": [
-    "Curated orthographic-convention register consumed by scripts/derive-orthographies.mjs.",
-    "One entry per language code, keyed by ISO 15924 script code. Each script entry may set",
+    "Curated orthographic-convention register — the decision-layer input to the",
+    "orthographies[] derivation (cli/scripts/derive-orthographies.mjs). NOT WIRED:",
+    "that deriver is a standalone pass, not imported by cli/scripts/cldf/project.mjs,",
+    "so nothing here reaches a card today. An earlier version of this comment claimed",
+    "the wiring existed; it did not. Do not restore that claim before the import does.",
+    "",
+    "ONE entry per language code, keyed by ISO 15924 script code. Each script entry may set",
     "scheme / longVowelMarking / canonicalForMt and MUST set a source string that cites a",
-    "verifiable basis (on-card prose, a tool the card already lists, or a published convention).",
-    "Only add entries whose convention is actually documented — absence means unknown, and the",
-    "deriver writes nothing it cannot cite (index, not arbiter). Do NOT record measured scores here.",
+    "verifiable basis — a source the card already carries, a published convention, or a tool",
+    "in the repo's register. Only add entries whose convention is actually documented:",
+    "absence means unknown, and the deriver writes nothing it cannot cite (index, not",
+    "arbiter). Optional keys are OMITTED when unknown, never guessed. Do NOT record measured",
+    "scores here — a score of method output is a run result and belongs on the leaderboard.",
+    "",
     "Data-over-code (docs/AGENTS.md §1): language-specific conventions live in this file,",
-    "never hardcoded in the deriver."
+    "never hardcoded in the deriver. Decision-layer inputs to the atlas build live under the",
+    "monorepo-root shared/ (parameters.csv, card-field-disposition.json, catalogue/…); this",
+    "file moved here from cli/shared/ on 2026-09-06 for that reason — cli/shared/ is the",
+    "npm-bundled RUNTIME tree, and nothing reads this register at runtime.",
+    "",
+    "STANDING VERDICT (shared/cldf/curated-file-verdicts.json, 2026-08-06):",
+    "'CITABLE BUT NOT MACHINE-FETCHABLE — keep, with a bibliographic citation added, and",
+    "record that it is asserted from the literature rather than fetched.' Every entry below",
+    "is asserted from the literature and from tools the card already lists. None is fetched,",
+    "so none carries a pin; that is the reason this is a curated register and not a source."
   ],
+  "version": 2,
   "conventions": {
     "crk": {
       "Latn": {
         "scheme": "SRO",
         "longVowelMarking": "circumflex",
         "canonicalForMt": true,
-        "source": "manual-curation (SRO = Standard Roman Orthography; long vowels marked with circumflexes as used by itwêwina/ALTLab and the GiellaLT lang-crk FST the card lists in resources.fsts; reference lexicon: Wolvengrey 2001, nēhiýawēwin: itwēwina / Cree: Words; the card's own formality prose names SRO as the working script)"
+        "source": "manual-curation (asserted from the literature and from a tool the card already carries — not machine-fetched). SRO is Standard Roman Orthography for Plains Cree; it writes the seven long vowels with circumflexes (â ê î ô) against unmarked short vowels. AUTHORITY: the GiellaLT / UAlbertaALTLab lang-crk finite-state transducer, which the crk card lists under resources.fsts from the giellalt-resources source (https://github.com/giellalt/lang-crk, https://github.com/UAlbertaALTLab/lang-crk). Both analysers accept the hyphenated preverb spelling (ê-nipâyân, nikî-nipân, kâ-nipât) and return the SAME analysis plus the tag Err/Orth — the FST's own spelling-error tag — for the fused spelling, so 'correct SRO' here is the grammar machine's verdict rather than a house preference. CANONICAL-FOR-MT: crk is written in two scripts and the pipeline's working script is the Roman one (shared/catalogue/card-config.json scriptConverter.crk converts between them); the scripts[] `primary` display flag is NOT this signal. REFERENCE LEXICON, cited and never redistributed (founder ruling 2026-07-19, index-only permanently): Wolvengrey, Arok, ed. 2001. nehiyawewin: itwewina / Cree: Words. Regina: Canadian Plains Research Center."
       },
       "Cans": {
         "canonicalForMt": false,
-        "source": "manual-curation (Syllabics is the display script, SRO the working script — per the card's own formality prose and the crk scriptConverter)"
+        "source": "manual-curation (asserted, not fetched). Unified Canadian Aboriginal Syllabics is an attested writing system for Plains Cree and stays on the card as an alternative — the language is written both ways and an index says so. It is NOT the pipeline's working form: shared/catalogue/card-config.json registers scriptConverter.crk precisely because syllabics is converted to and from the Roman orthography, and the lang-crk analysers cited on the Latn entry above are SRO-facing. longVowelMarking is OMITTED rather than guessed: syllabics marks vowel length by a diacritic over the syllable, which none of the schema's vocabulary terms (circumflex / macron / double-vowel / none) describes."
       }
     }
   }

package/shared/gettext-plural-forms.json

@@ -0,0 +1,45 @@
+{
+  "_about": "The Plural-Forms header GNU gettext's msginit writes for a new catalog, per language: its built-in table (gettext-tools plural-table.c). champollion gives a catalog it creates the same header, so the catalog's msgstr[] slots are the ones gettext and Django select at runtime. Looked up as msginit does: the full code first (pt_BR), then the language (pt). A language not listed gets no header from msginit; champollion derives one from CLDR (lib/po.js synthesizePluralForms). An existing catalog's own header is never replaced.",
+  "_source": "Probed 2026-10-03 with `msginit --no-translator --no-wrap --locale=<code>` (GNU gettext-tools 1.0, GETTEXTCLDRDIR unset) for every ISO 639-1 code and pt_BR, pt_PT, en_GB, de_AT, es_AR, fr_CA, zh_CN, zh_TW, sr_Latn; region variants not listed resolved to their language's entry.",
+  "forms": {
+    "be": "nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);",
+    "bg": "nplurals=2; plural=(n != 1);",
+    "ca": "nplurals=2; plural=(n != 1);",
+    "cs": "nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;",
+    "da": "nplurals=2; plural=(n != 1);",
+    "de": "nplurals=2; plural=(n != 1);",
+    "el": "nplurals=2; plural=(n != 1);",
+    "en": "nplurals=2; plural=(n != 1);",
+    "eo": "nplurals=2; plural=(n != 1);",
+    "es": "nplurals=2; plural=(n != 1);",
+    "et": "nplurals=2; plural=(n != 1);",
+    "fi": "nplurals=2; plural=(n != 1);",
+    "fo": "nplurals=2; plural=(n != 1);",
+    "fr": "nplurals=2; plural=(n > 1);",
+    "ga": "nplurals=3; plural=n==1 ? 0 : n==2 ? 1 : 2;",
+    "he": "nplurals=2; plural=(n != 1);",
+    "hr": "nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);",
+    "hu": "nplurals=2; plural=(n != 1);",
+    "it": "nplurals=2; plural=(n != 1);",
+    "ja": "nplurals=1; plural=0;",
+    "ko": "nplurals=1; plural=0;",
+    "lt": "nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && (n%100<10 || n%100>=20) ? 1 : 2);",
+    "lv": "nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n != 0 ? 1 : 2);",
+    "nb": "nplurals=2; plural=(n != 1);",
+    "nl": "nplurals=2; plural=(n != 1);",
+    "nn": "nplurals=2; plural=(n != 1);",
+    "no": "nplurals=2; plural=(n != 1);",
+    "pl": "nplurals=3; plural=(n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);",
+    "pt": "nplurals=2; plural=(n != 1);",
+    "pt_BR": "nplurals=2; plural=(n > 1);",
+    "ro": "nplurals=3; plural=n==1 ? 0 : (n==0 || (n%100 > 0 && n%100 < 20)) ? 1 : 2;",
+    "ru": "nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);",
+    "sk": "nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;",
+    "sl": "nplurals=4; plural=(n%100==1 ? 0 : n%100==2 ? 1 : n%100==3 || n%100==4 ? 2 : 3);",
+    "sr": "nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);",
+    "sv": "nplurals=2; plural=(n != 1);",
+    "tr": "nplurals=2; plural=(n != 1);",
+    "uk": "nplurals=3; plural=(n%10==1 && n%100!=11 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2);",
+    "vi": "nplurals=1; plural=0;"
+  }
+}

package/shared/method-registry.json

@@ -65,6 +65,7 @@
         "OPENAI_API_KEY"
       ],
       "default_base_url": "http://localhost:11434/v1",
+      "keyless": true,
       "homepage": "https://github.com/ollama/ollama",
       "license": "Varies (self-hosted / OpenAI-compatible gateway)",
       "commercialReady": false,
@@ -147,6 +148,7 @@
         "APERTIUM_API_KEY"
       ],
       "default_base_url": "https://apertium.org/apy",
+      "keyless": true,
       "homepage": "https://www.apertium.org",
       "license": "GPL-3.0+ (Apertium)",
       "commercialReady": false,

package/shared/metric-registry.json

@@ -14,7 +14,15 @@
       "level": "both",
       "in_composite": true,
       "verifier_reproducible": true,
-      "notes": "Harness core (tester.py), no plugin. Binary predicted == reference; corpus rate = matches/total."
+      "notes": "Harness core (tester.py), no plugin. Binary predicted == reference; corpus rate = matches/total.",
+      "ranking": {
+        "rounding": 4,
+        "ci_columns": null,
+        "segment_level": false,
+        "signature": {
+          "kind": "harness"
+        }
+      }
     },
     "equivalent_match_rate": {
       "category": "surface",
@@ -42,7 +50,19 @@
       "level": "both",
       "in_composite": true,
       "verifier_reproducible": true,
-      "notes": "sacrebleu (word_order=2), harness core. Normalized /100 for the composite (scoring.NORMALIZATIONS)."
+      "notes": "sacrebleu (word_order=2), harness core. Normalized /100 for the composite (scoring.NORMALIZATIONS).",
+      "ranking": {
+        "rounding": 2,
+        "ci_columns": [
+          "chrf_ci_lower",
+          "chrf_ci_upper"
+        ],
+        "segment_level": true,
+        "signature": {
+          "kind": "sacrebleu",
+          "key": "chrf"
+        }
+      }
     },
     "bleu": {
       "category": "surface",
@@ -56,7 +76,16 @@
       "level": "corpus",
       "in_composite": false,
       "verifier_reproducible": true,
-      "notes": "sacrebleu, harness core. Reported for MT-literature compatibility, never composited. Run-card key is top-level 'corpus_bleu' (not scores.bleu) — see _proposed_renames."
+      "notes": "sacrebleu, harness core. Reported for MT-literature compatibility, never composited. Run-card key is top-level 'corpus_bleu' (not scores.bleu) — see _rename_decisions.",
+      "ranking": {
+        "rounding": 2,
+        "ci_columns": null,
+        "segment_level": true,
+        "signature": {
+          "kind": "sacrebleu",
+          "key": "bleu"
+        }
+      }
     },
     "ter": {
       "category": "surface",
@@ -70,7 +99,16 @@
       "level": "both",
       "in_composite": false,
       "verifier_reproducible": true,
-      "notes": "sacrebleu corpus_ter. Excluded from composite (correlates with chrF++)."
+      "notes": "sacrebleu corpus_ter. Excluded from composite (correlates with chrF++).",
+      "ranking": {
+        "rounding": 2,
+        "ci_columns": null,
+        "segment_level": false,
+        "signature": {
+          "kind": "sacrebleu",
+          "key": "ter"
+        }
+      }
     },
     "length_ratio": {
       "category": "surface",
@@ -196,7 +234,16 @@
       "level": "both",
       "in_composite": false,
       "verifier_reproducible": true,
-      "notes": "Harness core (metrics_comet.py); model auto-selected via the card's metricModelSupport. NEURAL — reported in the separate lane, never composited; verifier re-derives fail-closed (recompute_corpus_comet)."
+      "notes": "Harness core (metrics_comet.py); model auto-selected via the card's metricModelSupport. NEURAL — reported in the separate lane, never composited; verifier re-derives fail-closed (recompute_corpus_comet).",
+      "ranking": {
+        "rounding": 4,
+        "ci_columns": null,
+        "segment_level": false,
+        "signature": {
+          "kind": "model",
+          "key": "comet_model"
+        }
+      }
     },
     "qe_score": {
       "category": "neural",
@@ -284,7 +331,7 @@
     },
     "compliance_index": {
       "category": "compliance",
-      "status": "implemented",
+      "status": "planned",
       "display_name": "Double-Pass Compliance",
       "plugin_name": "double_pass_compliance",
       "card_key": null,
@@ -294,11 +341,11 @@
       "level": "both",
       "in_composite": false,
       "verifier_reproducible": true,
-      "notes": "DoublePassCompliancePlugin. Quality GATE (placeholder/quote/casing integrity), not a quality score; lives in plugin_metrics/report only, no run_cards column."
+      "notes": "DoublePassCompliancePlugin. Quality GATE (placeholder/quote/casing integrity), not a quality score; no run_cards column. Planned, not implemented: no run path constructs the plugin (it needs a card with a `rules` field, which the atlas cutover dropped from every card as uncited script-family templates, and no atlas parameter carries quote or letter-case conventions). Passed a card without `rules`, only the 60% variable-integrity term measures anything; quote and casing score a constant 1.0."
     },
     "repair_effectiveness": {
       "category": "compliance",
-      "status": "implemented",
+      "status": "planned",
       "display_name": "Repair Effectiveness",
       "plugin_name": "double_pass_compliance",
       "card_key": null,
@@ -308,7 +355,7 @@
       "level": "corpus",
       "in_composite": false,
       "verifier_reproducible": true,
-      "notes": "Fraction of compliance violations auto-repaired by post-translation hooks; same plugin as compliance_index."
+      "notes": "Fraction of compliance violations auto-repaired by post-translation hooks; same plugin as compliance_index, and planned for the same reason: no run path constructs it."
     },
     "spbleu": {
       "category": "comparator",
@@ -322,7 +369,16 @@
       "level": "corpus",
       "in_composite": false,
       "verifier_reproducible": true,
-      "notes": "Comparability sidecar (FLORES/NLLB lingua-franca tokenizer). JSONB only."
+      "notes": "Comparability sidecar (FLORES/NLLB lingua-franca tokenizer). JSONB only.",
+      "ranking": {
+        "rounding": 2,
+        "ci_columns": null,
+        "segment_level": false,
+        "signature": {
+          "kind": "sacrebleu",
+          "key": "spbleu"
+        }
+      }
     },
     "chrf_plain": {
       "category": "comparator",
@@ -336,7 +392,16 @@
       "level": "corpus",
       "in_composite": false,
       "verifier_reproducible": true,
-      "notes": "The chrF figure FLORES/WMT tables report. JSONB only."
+      "notes": "The chrF figure FLORES/WMT tables report. JSONB only.",
+      "ranking": {
+        "rounding": 2,
+        "ci_columns": null,
+        "segment_level": true,
+        "signature": {
+          "kind": "sacrebleu",
+          "key": "chrf_plain"
+        }
+      }
     },
     "fuse_score": {
       "category": "comparator",
@@ -383,7 +448,7 @@
     "composite": {
       "category": "composite",
       "status": "implemented",
-      "display_name": "Composite Score (experimental)",
+      "display_name": "Legacy composite (retired)",
       "plugin_name": null,
       "card_key": null,
       "db_column": "composite_score",
@@ -392,12 +457,24 @@
       "level": "corpus",
       "in_composite": false,
       "verifier_reproducible": true,
-      "notes": "Derived by scoring.compute_composite_score from the profile weight tables (SSOT: scoring spec §4.3). A convenience sort key, NOT a validated quality measurement."
+      "notes": "RETIRED by scoring standard/1 (2026-10-04): no new run is scored, ranked or labelled with it — new run cards publish composite = null. Runs are ranked by corpus chrF++ with its 95% bootstrap CI; BLEU, spBLEU, TER and COMET are shown beside it, never blended. A card published before the standard keeps its stored composite, re-derivable by scoring.compute_composite_score from the profile weight tables (scoring spec §4.3) and shown only as 'legacy composite (retired)'. It was a convenience sort key, never a validated quality measurement: an untrained model repeating one valid sentence for every input scored 0.6244 ('functional') at chrF++ 5.5.",
+      "ranking": {
+        "rounding": 4,
+        "ci_columns": [
+          "composite_ci_lower",
+          "composite_ci_upper"
+        ],
+        "segment_level": false,
+        "signature": {
+          "kind": "harness"
+        },
+        "retired": "scoring standard/1 (2026-10-04) retired the weighted composite: a NEW contest ranks on corpus chrF++ (the default) or another standard metric. A contest that already recorded primary_metric=composite still ranks on it, labelled legacy composite (retired)."
+      }
     },
     "cost_adjusted": {
       "category": "composite",
       "status": "implemented",
-      "display_name": "Cost-Adjusted Score",
+      "display_name": "Legacy cost-adjusted composite (retired)",
       "plugin_name": null,
       "card_key": null,
       "db_column": null,
@@ -406,12 +483,12 @@
       "level": "corpus",
       "in_composite": false,
       "verifier_reproducible": true,
-      "notes": "scoring.cost_adjusted_score (composite / log2(1 + cost*1000), penalty-only). JSONB only."
+      "notes": "RETIRED with the composite by scoring standard/1 (2026-10-04): new run cards publish cost_adjusted = null. Legacy cards: scoring.cost_adjusted_score (composite / log2(1 + cost*1000), penalty-only). JSONB only."
     },
     "quality_tier": {
       "category": "composite",
       "status": "implemented",
-      "display_name": "Quality Tier",
+      "display_name": "Legacy quality tier (retired)",
       "plugin_name": null,
       "card_key": null,
       "db_column": "quality_tier",
@@ -420,7 +497,7 @@
       "level": "corpus",
       "in_composite": false,
       "verifier_reproducible": true,
-      "notes": "Heuristic label on the composite (scoring.QUALITY_TIERS); only human review confirms usability."
+      "notes": "RETIRED by scoring standard/1 (2026-10-04): new run cards publish quality_tier = null, and no surface labels a new run with a tier. Legacy cards keep the heuristic label they were published with (scoring.QUALITY_TIERS on the retired composite); only human evaluation certifies quality."
     },
     "tokens_per_second": {
       "category": "efficiency",
@@ -591,7 +668,8 @@
       "notes": "clamp0((chrF++ - floor)/(100 - floor)) — removes the orthography-specific chance floor so scores are cross-language comparable; the clamp at 0 doubles as the noise rail (at-or-below-floor = indistinguishable from chance). PARTIAL: implemented today only in the connection-quality lane (arena/mt_eval_harness/connection_quality.py cchrf(); JS twins cli/website/src/utils/connectionQuality.mjs + arcStrength.mjs; constants SSOT shared/connection-quality.json cq-v1) — NOT computed by tester.py and never a leaderboard column. Floors: cli/website/src/data/cchrf-floors.json (196 languages, champollion-derived), regenerated from research/cchrf/results/atlas.json (Monte-Carlo N1-unigram floors over FLORES-200 dev monolingual text; the study + paper live in research/cchrf). Known caveat before any RANKING consumer wires this: N1 undershoots fluent-output chance by ~2.3 chrF++ measured on 24/204 languages (research/cchrf REVIEW_2026-07-11 M1); the N1-vs-N_w estimator choice is an open founder decision recorded in docs/METRICS_RESEARCH_PROGRAM_2026-07-10.md. Forbidden on language cards (card-integrity R3)."
     }
   },
-  "_proposed_renames": [
+  "_proposed_renames": [],
+  "_rename_decisions": [
     {
       "current": "run-card key 'corpus_bleu' (top-level) vs canonical 'bleu' vs db_column 'corpus_bleu'",
       "proposal": "Move BLEU into scores as scores.bleu (spec §9 already shows it there) and keep db_column corpus_bleu; OR rename nothing and let this registry carry the mapping.",

package/shared/schemas/champollion-plugin.schema.json

@@ -42,6 +42,10 @@
       "format": "uri",
       "description": "Required for type 'api'. The server-side translation endpoint URL."
     },
+    "acceptsInstructions": {
+      "type": "boolean",
+      "description": "api plugins: whether the endpoint follows per-key instructions (the plural forms a key needs, a quality-gate retry's feedback). false — a trained NMT model that only translates text (e.g. nmt-forge serve): the CLI never asks it twice for the same text (it would answer the same) and sends what it refuses to the pair's fallback. true — requests carry an \"instructions\" object (key → text) beside \"keys\". Omitted — unknown: the CLI asks once more without feedback and says so."
+    },
     "config": {
       "type": "object",
       "description": "Method configuration — canonical MethodConfig shape.",

package/shared/schemas/corpora-card.schema.json

@@ -639,8 +639,8 @@
       "properties": {
         "risk": {
           "type": "string",
-          "enum": ["NONE", "LOW", "MEDIUM", "HIGH"],
-          "description": "NONE = private/unpublished. LOW = niche/recent. MEDIUM = public but not widely used. HIGH = known to be in major training sets."
+          "enum": ["NONE", "LOW", "MEDIUM", "HIGH", "UNCHECKED"],
+          "description": "NONE = private/unpublished. LOW = niche/recent. MEDIUM = public but not widely used. HIGH = known to be in major training sets. UNCHECKED = not graded: written by `champollion network register-corpus` when the file could not be compared with the public corpora (no corpora cards, public catalogue unreachable) and no grade was stated. Like every grade but LOW, it keeps a corpus in the relative-comparison-only lane."
         },
         "reasoning": {
           "type": "string",
@@ -718,6 +718,12 @@
       "default": "local-only"
     },
 
+    "transmission": {
+      "type": "string",
+      "enum": ["local-only"],
+      "description": "The steward's transmission mark — SEPARATE from the licence. 'local-only' = only a model on the steward's own machine may see the text; every remote model API is refused. Written by `champollion network register-corpus` for a local-only set (and kept when a file it registers was already marked), mirroring the <file>.champollion.json sidecar the harness reads (mt_eval_harness.corpus_loader.read_steward_sidecar). It is not a licence term: license.* says what others may do with the text under its licence; this mark says where the steward lets it travel. Absent = no steward mark (the licence decides which model services may see it)."
+    },
+
     "sealed": {
       "type": ["object", "null"],
       "description": "Sealed-tier crypto metadata (exposureTier='sealed'). CONTENT-FREE: records how a community-controlled secret test set was encrypted client-side, never the plaintext. The ciphertext lives in an off-git, off-allowlist store; this block only names the cipher suite, the custodian group, the ciphertext digest, and the AAD binding, plus the paired public qualifier a method must clear before a sealed run can be proposed. The decryption key exists only as M-of-N custodian shares — Champollion cannot decrypt. See cli/lib/seal.mjs and the community-custodian multisig plan (docs/governance) (M1).",

package/shared/schemas/method-index-record.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://champollion.dev/schemas/method-index-record.schema.json",
+  "title": "Champollion Method Index Record",
+  "description": "The public index record of a contest method: a deterministic projection of its bundle manifest (arena/mt_eval_harness/method_index.py) that keeps what the method is, who owns it, under what licence and how it decodes, plus the bundle's sha256 — and drops the contest binding, the qualifier receipt and the developer email. The record's canonical bytes (sorted keys, no whitespace, UTF-8) are minted once, by the harness; a node's signed score manifest carries their sha256 as indexEntrySha256. Consumers verify that sha over the bytes they are given; they never re-serialize.",
+  "type": "object",
+  "required": ["indexRecordVersion", "lane", "method", "owner", "licence", "languagePair", "methodSha256"],
+  "additionalProperties": false,
+  "properties": {
+    "indexRecordVersion": { "const": 1 },
+    "lane": {
+      "type": "string",
+      "enum": ["declarative-model", "method-execution"],
+      "description": "declarative-model = Lane A (weights run by the node's trusted engine, no participant code); method-execution = Lane B (code run in a --network=none sandbox)."
+    },
+    "method": {
+      "type": "object",
+      "required": ["name", "version"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 },
+        "class": { "type": ["string", "null"] },
+        "paradigm": { "type": ["string", "null"] }
+      }
+    },
+    "owner": {
+      "type": "object",
+      "required": ["name"],
+      "additionalProperties": false,
+      "description": "Display identity only. Never an email.",
+      "properties": {
+        "name": { "type": ["string", "null"], "not": { "type": "string", "pattern": "@" } },
+        "affiliation": { "type": ["string", "null"] }
+      }
+    },
+    "licence": { "type": "string", "minLength": 1, "description": "The weights/code licence the participant declared (SPDX id or LicenseRef-*)." },
+    "weightsPublic": { "type": ["boolean", "null"] },
+    "parameterCount": { "type": ["integer", "null"], "minimum": 1 },
+    "track": { "type": ["string", "null"], "enum": ["constrained", "unconstrained", null] },
+    "trainingData": { "type": ["string", "null"], "maxLength": 2000 },
+    "languagePair": {
+      "type": "object",
+      "required": ["source", "target"],
+      "additionalProperties": false,
+      "description": "The pair measured. Index entries are keyed to the variety measured and never compared across test sets.",
+      "properties": {
+        "source": { "type": "string", "minLength": 1 },
+        "target": { "type": "string", "minLength": 1 }
+      }
+    },
+    "methodSha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" },
+    "model": {
+      "type": "object",
+      "description": "Lane A only: the decoding the node's engine applies.",
+      "additionalProperties": false,
+      "properties": {
+        "architecture": { "type": ["string", "null"] },
+        "srcLang": { "type": ["string", "null"] },
+        "tgtLang": { "type": ["string", "null"] },
+        "generation": { "type": "object" }
+      }
+    },
+    "requirements": { "type": "object", "description": "Lane B only: the resources the method declared." },
+    "imageDigest": { "type": ["string", "null"], "description": "Lane B only: the built image the node ran." }
+  }
+}

package/shared/schemas/method-registry.schema.json

@@ -60,6 +60,10 @@
           "description": "When true, ALL credential_env vars must be set for 'ready' — key-pair auth (e.g. AWS access-key id + secret; Lara id + secret). Default false = any one suffices (alias lists). Only meaningful alongside credential_env."
         },
         "default_base_url": { "type": "string" },
+        "keyless": {
+          "type": "boolean",
+          "description": "True when the default endpoint needs no credential at all — a server on the user's own machine (local) or a free public API (apertium). Its env vars only POINT ELSEWHERE, so availability surfaces report it ready with no key set. Hosted APIs with a default_base_url are NOT keyless."
+        },
         "homepage": { "type": "string" },
         "license": { "type": "string" },
         "commercialReady": { "type": "boolean" },

package/shared/schemas/metric-registry.schema.json

@@ -32,6 +32,21 @@
           "decision": { "type": "string", "enum": ["founder-pending", "accepted", "rejected"] }
         }
       }
+    },
+    "_rename_decisions": {
+      "type": "array",
+      "description": "Rename proposals the FOUNDER has already decided, moved out of _proposed_renames with the decision recorded verbatim (dated wording such as KEEP or DEFER, which the pending-proposal enum does not express). Advisory — not consumed by code.",
+      "items": {
+        "type": "object",
+        "required": ["current", "proposal", "impact", "decision"],
+        "additionalProperties": false,
+        "properties": {
+          "current": { "type": "string" },
+          "proposal": { "type": "string" },
+          "impact": { "type": "string" },
+          "decision": { "type": "string", "minLength": 1 }
+        }
+      }
     }
   },
   "$defs": {
@@ -89,7 +104,46 @@
           "type": "boolean",
           "description": "True iff the verifier can deterministically re-derive it from the sha-pinned corpus + stored entries (+ card-pinned FST / pinned neural model under the fail-closed contract). Speed/cost/style metrics are false."
         },
-        "notes": { "type": "string" }
+        "notes": { "type": "string" },
+        "ranking": { "$ref": "#/$defs/ranking" }
+      }
+    },
+    "ranking": {
+      "type": "object",
+      "description": "Present iff a contest may rank on this metric (contests.metadata.primary_metric). Absent = not rankable. Adding a metric to the rankable set is a data change here plus a rankable_metrics row (migration 076 pattern), never a code change.",
+      "required": ["rounding", "ci_columns", "segment_level", "signature"],
+      "additionalProperties": false,
+      "properties": {
+        "rounding": {
+          "type": "integer", "minimum": 0, "maximum": 6,
+          "description": "Display rounding; also the precision of the point-equality tie rung."
+        },
+        "ci_columns": {
+          "description": "The run_cards bootstrap-CI column pair [lower, upper] for the CI-overlap tie rung, or null when the metric has no CI columns.",
+          "oneOf": [
+            { "type": "null" },
+            { "type": "array", "items": { "type": "string" }, "minItems": 2, "maxItems": 2 }
+          ]
+        },
+        "segment_level": {
+          "type": "boolean",
+          "description": "True iff the harness has a corpus function over per-segment rows (significance.py) so a paired test (approximate randomization / paired bootstrap) can compare two entries on this metric."
+        },
+        "retired": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Present iff the metric is RETIRED as a ranking choice for NEW contests (the reason, said to whoever tries). A contest that already recorded it as metadata.primary_metric still ranks on it, labelled legacy; the block stays so the rankable_metrics table (migration 076) keeps its row and existing contests keep passing contest_lifecycle_guard()."
+        },
+        "signature": {
+          "type": "object",
+          "description": "How this metric's computation is identified, so a contest can freeze it as a promise (contests.metadata.metric_signature). sacrebleu: the run card's scores.sacrebleu_signatures[key]; model: the run card's scores[key] (the neural model id) plus the harness version; harness: the harness version alone.",
+          "required": ["kind"],
+          "additionalProperties": false,
+          "properties": {
+            "kind": { "type": "string", "enum": ["sacrebleu", "model", "harness"] },
+            "key": { "type": "string", "minLength": 1 }
+          }
+        }
       }
     }
   }