@terpjs/spec 0.14.0

package/scorecard.schema.json

@@ -0,0 +1,52 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://terp.dev/spec/scorecard.schema.json",
+  "title": "Terp Standard conformance scorecard",
+  "description": "The machine-readable certification summary a checker emits after running the corpus: which spec version it certified against, which rules it claims, and the per-rule verdict over the corpus cases. This turns 'certified against spec X.Y.Z' into a verifiable artifact instead of a claim — a consumer can re-run the corpus and reproduce the scorecard. Residual claims must be a subset of corpus/RESIDUALS.json for the rule; claiming a residual the spec does not record is a conformance failure.",
+  "type": "object",
+  "required": ["spec_version", "checker", "rules"],
+  "additionalProperties": false,
+  "properties": {
+    "spec_version": {
+      "type": "string",
+      "description": "The spec semver (VERSION) the checker certified against.",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "checker": {
+      "type": "object",
+      "description": "The checker's identity: tool name and its own version.",
+      "required": ["tool", "version"],
+      "additionalProperties": false,
+      "properties": {
+        "tool": { "type": "string", "minLength": 1 },
+        "version": { "type": "string", "minLength": 1 }
+      }
+    },
+    "rules": {
+      "type": "array",
+      "description": "One entry per catalog rule the checker claims conformance for. A rule not listed is not claimed.",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["rule", "pass"],
+        "additionalProperties": false,
+        "properties": {
+          "rule": {
+            "type": "string",
+            "description": "The catalog rule id the verdict is for.",
+            "pattern": "^(backend/[a-z0-9_]+|frontend/[a-z0-9-]+)$"
+          },
+          "pass": {
+            "type": "boolean",
+            "description": "True when every violation-* case produced a finding for this rule and every compliant-* case produced none."
+          },
+          "residuals_claimed": {
+            "type": "array",
+            "description": "The corpus/RESIDUALS.json entries (verbatim strings) for this rule the checker relies on; must be a subset of the spec's recorded residuals.",
+            "items": { "type": "string", "minLength": 1 }
+          }
+        }
+      }
+    }
+  }
+}