Files
03dd578435 feat(schemas): add JSON Schemas and validation helper for inter-stage documents (#2) (#46)
Define the nine JSON Schemas (draft 2020-12) exchanged between compiler stages
per MASTER_SPEC §10–§11, plus a reusable validation helper.

Schemas (schemas/json/, cross-referenced by $id):
- scene, character, concept, interaction, metadata, knowledge_base_entry,
  resolved_tag, category_map, prompt_output
- Scene requires all seven sections (collections may be empty); Concept is a
  bare string or an object with required name; Character has an integer id plus
  seven concept arrays; Interaction has integer participants and a concept.
- Each schema carries a major.minor version; unknown fields rejected by default.

Helper (schemas/validation.py):
- validate_document(doc, schema_name, *, allow_unknown=False) -> list of
  structured ValidationIssue (empty = valid); collects all errors.
- Loads all schemas into a referencing registry so cross-schema $ref resolves.
- allow_unknown relaxes additionalProperties per config without duplicating
  schemas (schema-valued additionalProperties, e.g. Category Map, is preserved).

Tests: valid + several invalid documents per schema, unknown-field toggle,
unknown-schema error (34 assertions). Bumps jsonschema to >=4.18 for referencing.

Co-authored-by: kunail0804 <kunail0804@gmail.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-07 18:52:32 +02:00

17 lines
561 B
JSON

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "metadata",
"version": "1.0",
"title": "Metadata",
"description": "Compiler metadata. MASTER_SPEC §9.7 / §11.5. MUST NOT affect compilation.",
"type": "object",
"required": ["schema_version"],
"additionalProperties": false,
"properties": {
"schema_version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+$" },
"compiler_version": { "type": "string" },
"language": { "type": "string" },
"warnings": { "type": "array", "items": { "type": "string" } }
}
}