madoo.audio-quality-report/v1

Madoo audio quality report — Deterministic loudness, peak, clipping, and silence measurements for one audio signal.

Reference	madoo.audio-quality-report/v1
Schema id	urn:madoo:schema:audio-quality-report:v1
Version	1.0.0
Served at	GET /api/v1/json-schemas/madoo.audio-quality-report/v1 · MCP get_json_schema

Where it appears

• Produced by: audio/loudness_normalize → after, audio/loudness_normalize → before, audio/quality_report → metrics
• Read by: utility/dubbing_manifest → final_audio_report

Fields

Field	Type	Required	Rules	Description
schema	"madoo.audio-quality-report/v1"	yes
durationMilliseconds	integer	yes	≥ 0
sampleRateHz	integer or null	yes	≥ 1
channels	integer or null	yes	≥ 1; ≤ 64
integratedLoudnessLufs	number or null	yes
loudnessRangeLu	number or null	yes	≥ 0
maximumShortTermLoudnessLufs	number or null	yes
truePeakDbtp	number or null	yes
samplePeakDbfs	number or null	yes
clippedSampleCount	integer	yes	≥ 0
headSilenceMilliseconds	integer	yes	≥ 0
tailSilenceMilliseconds	integer	yes	≥ 0
dropoutCandidates	array of objects	yes	max items 128
dropoutCandidates[].startMilliseconds	integer	yes	≥ 0
dropoutCandidates[].endMilliseconds	integer	yes	≥ 0
dropoutCandidates[].durationMilliseconds	integer	yes	≥ 0
technique	object	yes	no other fields
technique.name	string	yes	min length 1; max length 128
technique.version	string	yes	min length 1; max length 64
technique.engine	string	yes	min length 1; max length 64
technique.engineVersion	string	yes	min length 1; max length 128
warnings	array of objects	yes	max items 128
warnings[].code	string	yes	min length 1; max length 128
warnings[].message	string	yes	min length 1; max length 1000
warnings[].path	string or null		max length 500

The complete schema

madoo.audio-quality-report/v1 (JSON Schema)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "urn:madoo:schema:audio-quality-report:v1",
  "title": "Madoo Audio Quality Report v1",
  "description": "Deterministic, normalized measurements of one audio signal.",
  "type": "object",
  "required": [
    "schema",
    "durationMilliseconds",
    "sampleRateHz",
    "channels",
    "integratedLoudnessLufs",
    "loudnessRangeLu",
    "maximumShortTermLoudnessLufs",
    "truePeakDbtp",
    "samplePeakDbfs",
    "clippedSampleCount",
    "headSilenceMilliseconds",
    "tailSilenceMilliseconds",
    "dropoutCandidates",
    "technique",
    "warnings"
  ],
  "properties": {
    "schema": {
      "const": "madoo.audio-quality-report/v1"
    },
    "durationMilliseconds": {
      "type": "integer",
      "minimum": 0
    },
    "sampleRateHz": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 1
    },
    "channels": {
      "type": [
        "integer",
        "null"
      ],
      "minimum": 1,
      "maximum": 64
    },
    "integratedLoudnessLufs": {
      "type": [
        "number",
        "null"
      ]
    },
    "loudnessRangeLu": {
      "type": [
        "number",
        "null"
      ],
      "minimum": 0
    },
    "maximumShortTermLoudnessLufs": {
      "type": [
        "number",
        "null"
      ]
    },
    "truePeakDbtp": {
      "type": [
        "number",
        "null"
      ]
    },
    "samplePeakDbfs": {
      "type": [
        "number",
        "null"
      ]
    },
    "clippedSampleCount": {
      "type": "integer",
      "minimum": 0
    },
    "headSilenceMilliseconds": {
      "type": "integer",
      "minimum": 0
    },
    "tailSilenceMilliseconds": {
      "type": "integer",
      "minimum": 0
    },
    "dropoutCandidates": {
      "type": "array",
      "maxItems": 128,
      "items": {
        "$ref": "#/$defs/segment"
      }
    },
    "technique": {
      "$ref": "#/$defs/technique"
    },
    "warnings": {
      "type": "array",
      "maxItems": 128,
      "items": {
        "$ref": "#/$defs/warning"
      }
    }
  },
  "$defs": {
    "segment": {
      "type": "object",
      "required": [
        "startMilliseconds",
        "endMilliseconds",
        "durationMilliseconds"
      ],
      "properties": {
        "startMilliseconds": {
          "type": "integer",
          "minimum": 0
        },
        "endMilliseconds": {
          "type": "integer",
          "minimum": 0
        },
        "durationMilliseconds": {
          "type": "integer",
          "minimum": 0
        }
      },
      "additionalProperties": false
    },
    "technique": {
      "type": "object",
      "required": [
        "name",
        "version",
        "engine",
        "engineVersion"
      ],
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "version": {
          "type": "string",
          "minLength": 1,
          "maxLength": 64
        },
        "engine": {
          "type": "string",
          "minLength": 1,
          "maxLength": 64
        },
        "engineVersion": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        }
      },
      "additionalProperties": false
    },
    "warning": {
      "type": "object",
      "required": [
        "code",
        "message"
      ],
      "properties": {
        "code": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "message": {
          "type": "string",
          "minLength": 1,
          "maxLength": 1000
        },
        "path": {
          "type": [
            "string",
            "null"
          ],
          "maxLength": 500
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}