octopus-workflow/core/schemas/port-analysis.schema.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://eightarms.net/octopus-workflow/schemas/port-analysis.schema.json",
  "title": "Port Analysis Reviewer Output",
  "description": "Schema for per-dimension port-analysis reviewer findings. Used by the large-port-pipeline source analysis review (Phase B1.5). The port source-analysis pipeline uses a deliberate three-value severity contract — BLOCKER / MAJOR / MINOR — and never emits INFO (matching implement/reference/large-port-pipeline.md and source-analysis.md, which name only those three). This is a documented exception to the canonical four-value set (BLOCKER / MAJOR / MINOR / INFO) in reviewer-output.schema.json and synthesis.schema.json.",
  "type": "object",
  "required": ["dimension", "findings"],
  "properties": {
    "dimension": {
      "type": "string",
      "enum": [
        "SRC-CMP",
        "SRC-API",
        "SRC-DATA",
        "SRC-BIZ",
        "SRC-ERR",
        "SRC-DEP",
        "SRC-TST",
        "SRC-MAP",
        "TGT-SURF",
        "CAP-BOUND"
      ],
      "description": "Audit dimension code"
    },
    "findings": {
      "type": "array",
      "items": {
        "type": "object",
        "required": ["id", "severity", "description"],
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^(SRC-CMP|SRC-API|SRC-DATA|SRC-BIZ|SRC-ERR|SRC-DEP|SRC-TST|SRC-MAP|TGT-SURF|CAP-BOUND)-\\d{3}$",
            "description": "Finding ID in {DIM_CODE}-{NNN} format"
          },
          "severity": {
            "type": "string",
            "enum": ["BLOCKER", "MAJOR", "MINOR"]
          },
          "description": {
            "type": "string",
            "description": "Human-readable finding description"
          },
          "source_evidence": {
            "type": "string",
            "description": "Source file:line reference citing the evidence"
          },
          "recommendation": {
            "type": "string",
            "description": "Concrete fix suggestion"
          }
        }
      }
    }
  }
}