madoo.audio-processing-report/v1

Madoo audio processing report — Explainable before-and-after envelope for an Audio Finishing transformation.

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

Where it appears

• Produced by: audio/duck → ducking_report, audio/fit_duration → fit_report, audio/loop → processing_report, audio/loudness_normalize → processing_report, audio/speech_enhance → processing_report

Fields

Field	Type	Required	Rules	Description
schema	"madoo.audio-processing-report/v1"	yes
operation	one of "loudness_normalize", "fit_duration", "duck", "speech_enhance"	yes
profile	string	yes	min length 1; max length 64
effectiveParameters	object	yes
inputSha256	string or null	yes	pattern “^[a-f0-9]{64}$”
before	object or null	yes
after	object or null	yes
actions	array of string	yes	max items 64
operationMetrics	object	yes
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-processing-report/v1 (JSON Schema)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "urn:madoo:schema:audio-processing-report:v1",
  "title": "Madoo Audio Processing Report v1",
  "description": "Versioned, explainable before/after envelope for an Audio Finishing transformation.",
  "type": "object",
  "required": [
    "schema",
    "operation",
    "profile",
    "effectiveParameters",
    "inputSha256",
    "before",
    "after",
    "actions",
    "operationMetrics",
    "technique",
    "warnings"
  ],
  "properties": {
    "schema": {
      "const": "madoo.audio-processing-report/v1"
    },
    "operation": {
      "type": "string",
      "enum": [
        "loudness_normalize",
        "fit_duration",
        "duck",
        "speech_enhance"
      ]
    },
    "profile": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "effectiveParameters": {
      "type": "object",
      "maxProperties": 64
    },
    "inputSha256": {
      "type": [
        "string",
        "null"
      ],
      "pattern": "^[a-f0-9]{64}$"
    },
    "before": {
      "$ref": "#/$defs/qualityReportOrNull"
    },
    "after": {
      "$ref": "#/$defs/qualityReportOrNull"
    },
    "actions": {
      "type": "array",
      "maxItems": 64,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 256
      }
    },
    "operationMetrics": {
      "type": "object",
      "maxProperties": 64
    },
    "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
    },
    "warnings": {
      "type": "array",
      "maxItems": 128,
      "items": {
        "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
      }
    }
  },
  "$defs": {
    "qualityReportOrNull": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "schema"
          ],
          "properties": {
            "schema": {
              "const": "madoo.audio-quality-report/v1"
            }
          }
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "additionalProperties": false
}