rail_verdict 1.0.0

data/schemas/configuration-v1.4.schema.json

@@ -0,0 +1,146 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://railverdict.dev/schemas/configuration/v1.4.schema.json",
+  "title": "RailVerdict Parsed Configuration v1.4",
+  "description": "Versioned contract for .railverdict.yml with baseline, waivers, git base, and optional AI.",
+  "type": "object",
+  "required": ["version", "mode", "analyzers"],
+  "properties": {
+    "version": { "const": 1.4 },
+    "mode": { "enum": ["advisory", "no_new_debt", "strict"] },
+    "analyzers": { "$ref": "#/$defs/analyzers" },
+    "baseline": { "$ref": "#/$defs/baselineConfig" },
+    "waivers": { "$ref": "#/$defs/waiversConfig" },
+    "git": { "$ref": "#/$defs/gitConfig" },
+    "ai": { "$ref": "#/$defs/aiConfig" }
+  },
+  "additionalProperties": false,
+  "unevaluatedProperties": false,
+  "$defs": {
+    "analyzers": {
+      "type": "object",
+      "required": ["rubocop"],
+      "properties": {
+        "rubocop": { "$ref": "#/$defs/analyzerSelection" },
+        "minitest": { "$ref": "#/$defs/analyzerSelection" },
+        "rspec": { "$ref": "#/$defs/analyzerSelection" },
+        "simplecov": { "$ref": "#/$defs/simplecovSelection" },
+        "bundler_audit": { "$ref": "#/$defs/bundlerAuditSelection" }
+      },
+      "additionalProperties": false,
+      "unevaluatedProperties": false
+    },
+    "analyzerSelection": {
+      "type": "object",
+      "required": ["enabled", "required"],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "required": { "type": "boolean" }
+      },
+      "additionalProperties": false,
+      "unevaluatedProperties": false,
+      "not": {
+        "required": ["enabled", "required"],
+        "properties": { "enabled": { "const": false }, "required": { "const": true } }
+      }
+    },
+    "simplecovSelection": {
+      "type": "object",
+      "required": ["enabled", "required"],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "required": { "type": "boolean" },
+        "coverage_path": { "type": "string", "minLength": 1, "maxLength": 1024 },
+        "freshness_window_seconds": { "type": "integer", "minimum": 1, "maximum": 2592000 }
+      },
+      "additionalProperties": false,
+      "unevaluatedProperties": false,
+      "not": {
+        "required": ["enabled", "required"],
+        "properties": { "enabled": { "const": false }, "required": { "const": true } }
+      }
+    },
+    "bundlerAuditSelection": {
+      "type": "object",
+      "required": ["enabled", "required"],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "required": { "type": "boolean" }
+      },
+      "additionalProperties": false,
+      "unevaluatedProperties": false,
+      "not": {
+        "required": ["enabled", "required"],
+        "properties": { "enabled": { "const": false }, "required": { "const": true } }
+      }
+    },
+    "baselineConfig": {
+      "type": "object",
+      "required": [],
+      "properties": { "path": { "type": "string", "minLength": 1, "maxLength": 1024 } },
+      "additionalProperties": false,
+      "unevaluatedProperties": false
+    },
+    "waiversConfig": {
+      "type": "object",
+      "required": [],
+      "properties": { "path": { "type": "string", "minLength": 1, "maxLength": 1024 } },
+      "additionalProperties": false,
+      "unevaluatedProperties": false
+    },
+    "gitConfig": {
+      "type": "object",
+      "required": [],
+      "properties": { "base": { "type": "string", "minLength": 1, "maxLength": 1024 } },
+      "additionalProperties": false,
+      "unevaluatedProperties": false
+    },
+    "aiConfig": {
+      "type": "object",
+      "required": [],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "mode": { "enum": ["off", "explain", "investigate"] },
+        "provider": { "type": "string", "minLength": 1, "maxLength": 64 },
+        "model": { "type": "string", "minLength": 1, "maxLength": 128 },
+        "remote": { "$ref": "#/$defs/aiRemoteConfig" },
+        "budgets": { "$ref": "#/$defs/aiBudgetsConfig" },
+        "cache": { "$ref": "#/$defs/aiCacheConfig" }
+      },
+      "additionalProperties": false,
+      "unevaluatedProperties": false
+    },
+    "aiRemoteConfig": {
+      "type": "object",
+      "required": [],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "trust": { "enum": ["redacted", "full"] },
+        "endpoint": { "type": "string", "minLength": 1, "maxLength": 1024 }
+      },
+      "additionalProperties": false,
+      "unevaluatedProperties": false
+    },
+    "aiBudgetsConfig": {
+      "type": "object",
+      "required": [],
+      "properties": {
+        "max_findings": { "type": "integer", "minimum": 1, "maximum": 10 },
+        "max_requests": { "type": "integer", "minimum": 1, "maximum": 10 },
+        "max_context_bytes": { "type": "integer", "minimum": 1024, "maximum": 262144 }
+      },
+      "additionalProperties": false,
+      "unevaluatedProperties": false
+    },
+    "aiCacheConfig": {
+      "type": "object",
+      "required": [],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "max_bytes": { "type": "integer", "minimum": 1024, "maximum": 104857600 }
+      },
+      "additionalProperties": false,
+      "unevaluatedProperties": false
+    }
+  }
+}

data/schemas/configuration-v1.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://railverdict.dev/schemas/configuration/v1.schema.json",
+  "title": "RailVerdict Parsed Configuration v1 (Draft / Unimplemented)",
+  "description": "Draft, independently versioned contract for the safely parsed data value of .railverdict.yml. This contract is not implemented.",
+  "type": "object",
+  "required": [
+    "version",
+    "mode",
+    "analyzers"
+  ],
+  "properties": {
+    "version": {
+      "const": 1
+    },
+    "mode": {
+      "enum": [
+        "advisory",
+        "no_new_debt",
+        "strict"
+      ]
+    },
+    "analyzers": {
+      "$ref": "#/$defs/analyzers"
+    }
+  },
+  "additionalProperties": false,
+  "unevaluatedProperties": false,
+  "$defs": {
+    "analyzers": {
+      "type": "object",
+      "required": [
+        "rubocop"
+      ],
+      "properties": {
+        "rubocop": {
+          "$ref": "#/$defs/analyzerSelection"
+        }
+      },
+      "additionalProperties": false,
+      "unevaluatedProperties": false
+    },
+    "analyzerSelection": {
+      "type": "object",
+      "required": [
+        "enabled",
+        "required"
+      ],
+      "properties": {
+        "enabled": {
+          "type": "boolean"
+        },
+        "required": {
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": false,
+      "unevaluatedProperties": false,
+      "not": {
+        "required": ["enabled", "required"],
+        "properties": {
+          "enabled": {
+            "const": false
+          },
+          "required": {
+            "const": true
+          }
+        }
+      }
+    }
+  }
+}

data/schemas/coverage-v1.schema.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://railverdict.dev/schemas/coverage/v1.schema.json",
+  "title": "SimpleCov public coverage JSON v1 (RailVerdict ingestion)",
+  "description": "Strict internal contract for SimpleCov public coverage.json consumed by RailVerdict. Not a SimpleCov upstream schema replica.",
+  "type": "object",
+  "required": ["version", "timestamp", "files"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "pattern": "^1($|\\.)"
+    },
+    "timestamp": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "command_name": {
+      "type": "string",
+      "maxLength": 512
+    },
+    "files": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/file" }
+    }
+  },
+  "additionalProperties": false,
+  "unevaluatedProperties": false,
+  "$defs": {
+    "file": {
+      "type": "object",
+      "required": ["filename", "coverage"],
+      "properties": {
+        "filename": { "type": "string", "minLength": 1, "maxLength": 1024 },
+        "coverage": {
+          "type": "object",
+          "required": ["lines"],
+          "properties": {
+            "lines": {
+              "type": "array",
+              "items": { "type": ["integer", "null"], "minimum": 0 }
+            }
+          },
+          "additionalProperties": false,
+          "unevaluatedProperties": false
+        }
+      },
+      "additionalProperties": false,
+      "unevaluatedProperties": false
+    }
+  }
+}

data/schemas/finding-v1.schema.json

@@ -0,0 +1,131 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://railverdict.dev/schemas/finding/v1.schema.json",
+  "title": "RailVerdict Finding v1 (Draft / Unimplemented)",
+  "description": "Draft, independently versioned contract for analyzer-independent finding evidence. This contract is not implemented and grants no gate authority.",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "id",
+    "fingerprint",
+    "origin",
+    "analyzer",
+    "rule_id",
+    "category",
+    "severity",
+    "confidence",
+    "state",
+    "evidence_ref",
+    "location",
+    "message"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "1.0"
+    },
+    "id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "fingerprint": {
+      "type": "string",
+      "pattern": "^sha256:[0-9a-f]{64}$",
+      "description": "Opaque deterministic evidence identity; exact canonicalization is owned by the baseline phase."
+    },
+    "origin": {
+      "enum": [
+        "deterministic",
+        "runtime",
+        "ai",
+        "custom"
+      ]
+    },
+    "analyzer": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "rule_id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "category": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "severity": {
+      "enum": [
+        "info",
+        "low",
+        "medium",
+        "high",
+        "critical"
+      ]
+    },
+    "confidence": {
+      "enum": [
+        "low",
+        "medium",
+        "high"
+      ]
+    },
+    "state": {
+      "enum": [
+        "observed",
+        "introduced",
+        "existing",
+        "resolved",
+        "changed",
+        "moved",
+        "suppressed",
+        "waived"
+      ]
+    },
+    "evidence_ref": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 512,
+      "description": "Opaque reference into the producing AnalyzerResult's native evidence, never analyzer-specific fields."
+    },
+    "location": {
+      "$ref": "#/$defs/location"
+    },
+    "message": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 4096
+    }
+  },
+  "additionalProperties": false,
+  "unevaluatedProperties": false,
+  "$defs": {
+    "location": {
+      "type": "object",
+      "required": [
+        "path"
+      ],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 4096,
+          "pattern": "^(?!/)(?!.*\\\\)(?!.*//)(?!(?:\\.{1,2})(?:/|$))(?!.*\\/(?:\\.{1,2})(?:/|$))[^\\u0000-\\u001f/]+(?:/[^\\u0000-\\u001f/]+)*$"
+        },
+        "start_line": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "end_line": {
+          "type": "integer",
+          "minimum": 1
+        }
+      },
+      "description": "If both line fields are present, runtime validation must enforce end_line >= start_line; Draft 2020-12 cannot express this invariant without overcomplicating the location shape.",
+      "additionalProperties": false,
+      "unevaluatedProperties": false
+    }
+  }
+}

data/schemas/minitest-reporter-v1.schema.json

@@ -0,0 +1,113 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://railverdict.dev/schemas/minitest-reporter/v1.schema.json",
+  "title": "RailVerdict Minitest Reporter v1",
+  "description": "Machine contract emitted by the RailVerdict-owned Minitest reporter. Versioned, internal.",
+  "type": "object",
+  "required": [
+    "schema_version",
+    "runner",
+    "seed",
+    "tests_total",
+    "assertions",
+    "failures",
+    "errors",
+    "skips",
+    "duration_seconds",
+    "tests"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "1.0"
+    },
+    "runner": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "seed": {
+      "type": ["integer", "null"],
+      "minimum": 0
+    },
+    "tests_total": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "assertions": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "failures": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "errors": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "skips": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "duration_seconds": {
+      "type": "number",
+      "minimum": 0
+    },
+    "tests": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/test"
+      }
+    }
+  },
+  "additionalProperties": false,
+  "unevaluatedProperties": false,
+  "$defs": {
+    "test": {
+      "type": "object",
+      "required": [
+        "class_name",
+        "method_name",
+        "status",
+        "time_seconds"
+      ],
+      "properties": {
+        "class_name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "method_name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 256
+        },
+        "status": {
+          "enum": ["passed", "failed", "errored", "skipped"]
+        },
+        "time_seconds": {
+          "type": "number",
+          "minimum": 0
+        },
+        "failure_message": {
+          "type": "string",
+          "maxLength": 4096
+        },
+        "failure_class": {
+          "type": "string",
+          "maxLength": 256
+        },
+        "file": {
+          "type": "string",
+          "maxLength": 1024
+        },
+        "line": {
+          "type": "integer",
+          "minimum": 1
+        }
+      },
+      "additionalProperties": false,
+      "unevaluatedProperties": false
+    }
+  }
+}