champollion 0.3.4 → 0.5.0

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 }
+          }
+        }
       }
     }
   }

package/shared/schemas/retired-model-aliases.schema.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://champollion.dev/schemas/retired-model-aliases.schema.json",
+  "title": "Champollion retired model aliases (shared/retired-model-aliases.json)",
+  "description": "Short model names Champollion USED to accept, each with the exact provider slug it used to stand for. Founder ruling 2026-10-05: exact slugs only, no aliasing — every name in `retired` is REFUSED with a message naming its slug; it never resolves. The bundled mini-schema validator does not support additionalProperties-as-schema, so per-entry validation iterates `retired` against $defs.aliasName / $defs.modelId (see cli/test/shared-ssot-schemas.test.js).",
+  "type": "object",
+  "required": ["_comment", "retired"],
+  "properties": {
+    "_comment": {
+      "type": "string",
+      "description": "Human note: why these names are retired."
+    },
+    "retired": {
+      "type": "object",
+      "description": "Retired short name → the exact slug it used to stand for (used ONLY in the refusal message)."
+    }
+  },
+  "$defs": {
+    "aliasName": {
+      "type": "string",
+      "description": "Retired short name: lowercase alphanumerics and hyphens.",
+      "pattern": "^[a-z0-9][a-z0-9-]*$",
+      "minLength": 2
+    },
+    "modelId": {
+      "type": "string",
+      "description": "Exact provider-qualified model slug: <provider>/<model>, never a floating id (no leading '~', no '-latest').",
+      "pattern": "^[a-z0-9-]+/[A-Za-z0-9._-]+$",
+      "minLength": 3
+    }
+  }
+}