7ce4598a0b
Phase 3 (L39, ST13, ST9, ST10). - L39: deleted codegen/seed-midi-devices.ts. It regenerated — and therefore silently CLOBBERED — the hand-tuned device schemas it had originally created. Its purpose is served and git retains it. Confirmed nothing invokes it (the root package.json that once might have was deleted in Phase 1). - ST13: moved the provenance artifact out of the repo root. AUDIT CORRECTION: the finding's proposed destination, schemas/midi_devices/synth-midi-cc.sources.json, would have BROKEN codegen and CI — generate-midi-devices.ts treats every *.json directly under that directory as a device template and ajv-validates it, and the sources file has no device_id/midi/params, so the generator would exit non-zero. It went to schemas/midi_devices/sources/ instead. - ST9: schemas/schema.json's own description stated the direction of truth BACKWARDS. Rewritten: schemas are canonical, codegen emits C++ and TypeScript. (The audit cited params_notes.md; the real path is schemas/modes/params_notes.md.) - ST10: codegen/README.md rewritten against current reality — it described retired playground paths and a phantom temp dir. Descriptions are never emitted, so this is behaviour-inert; proven by regenerating all four generated directories byte-identically.
111 lines
3.8 KiB
JSON
111 lines
3.8 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://memlnaut/schemas/mode.schema.json",
|
|
"title": "MEMLNaut Mode Schema",
|
|
"description": "Meta-schema for one MEMLNaut mode: parameter contract, ML config, and UI hints. The schemas/modes/*.json files it validates are the canonical contract — codegen/generate.ts emits the C++ headers (nisps/modes/generated/) and TypeScript modules (manifold/src/modes/generated/) from them. Provenance notes and judgement calls live in schemas/modes/params_notes.md.",
|
|
"type": "object",
|
|
"required": [
|
|
"mode_id",
|
|
"engine_id",
|
|
"ml",
|
|
"params",
|
|
"voice_spaces",
|
|
"ui"
|
|
],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"$schema": { "type": "string" },
|
|
"_note": {
|
|
"type": "string",
|
|
"description": "Free-text note from the schema author (e.g. about ranges that were guessed)."
|
|
},
|
|
"mode_id": {
|
|
"type": "string",
|
|
"pattern": "^[a-z][a-z0-9_]*$",
|
|
"description": "snake_case identifier for the mode. Must be unique."
|
|
},
|
|
"engine_id": {
|
|
"type": "string",
|
|
"pattern": "^[a-z][a-z0-9_]*$",
|
|
"description": "snake_case identifier for the audio engine the mode uses."
|
|
},
|
|
"ml": {
|
|
"type": "object",
|
|
"required": [
|
|
"input_channels",
|
|
"input_size",
|
|
"hidden_layers",
|
|
"output_size",
|
|
"default_spread",
|
|
"default_learning_rate",
|
|
"default_max_iterations"
|
|
],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"input_channels": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"pattern": "^[a-z][a-z0-9_]*$"
|
|
},
|
|
"minItems": 1,
|
|
"description": "Names of abstract input channels (e.g. joy_x, midi_velocity, audio_pitch)."
|
|
},
|
|
"input_size": { "type": "integer", "minimum": 1 },
|
|
"hidden_layers": {
|
|
"type": "array",
|
|
"items": { "type": "integer", "minimum": 1 },
|
|
"minItems": 1
|
|
},
|
|
"output_size": { "type": "integer", "minimum": 1 },
|
|
"default_spread": { "type": "number", "minimum": 0.0, "maximum": 1.0 },
|
|
"default_learning_rate": { "type": "number", "exclusiveMinimum": 0.0 },
|
|
"default_max_iterations": { "type": "integer", "minimum": 1 }
|
|
}
|
|
},
|
|
"params": {
|
|
"type": "array",
|
|
"minItems": 1,
|
|
"items": {
|
|
"type": "object",
|
|
"required": ["name", "label", "min", "max", "default", "curve", "group"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"name": {
|
|
"type": "string",
|
|
"pattern": "^[a-z][a-z0-9_]*$",
|
|
"description": "snake_case identifier; unique within this mode."
|
|
},
|
|
"label": { "type": "string" },
|
|
"min": { "type": "number" },
|
|
"max": { "type": "number" },
|
|
"default": { "type": "number" },
|
|
"curve": {
|
|
"type": "string",
|
|
"enum": ["linear", "exp", "log", "square", "sqrt", "sigmoid", "cubic"]
|
|
},
|
|
"group": { "type": "string" },
|
|
"_note": { "type": "string" }
|
|
}
|
|
}
|
|
},
|
|
"voice_spaces": {
|
|
"type": "array",
|
|
"items": { "type": "string" },
|
|
"description": "Names of C++ voice space lambdas the mode supports. May be empty for engines with no voice spaces (e.g. sequencers)."
|
|
},
|
|
"ui": {
|
|
"type": "object",
|
|
"required": ["primary_input", "show_voice_space_selector", "show_synth_visualizer"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"primary_input": {
|
|
"type": "string",
|
|
"enum": ["xy_pad", "joystick", "sliders", "audio_in", "midi_in", "none"]
|
|
},
|
|
"show_voice_space_selector": { "type": "boolean" },
|
|
"show_synth_visualizer": { "type": "boolean" }
|
|
}
|
|
}
|
|
}
|
|
}
|