feat(schema): 2.1 types, fragments, and JSON Schemas

Add the term, equation, value, and misconception registries
(src/model/course/glossary.rs) and the new optional fields on objectives,
targets, lectures, readings, bank options, and policy. Load registry
entries from objective files, glossary.yaml, and course.yaml, with one
definition site per id as for every other registry. Port every edit in
docs/design/2.1/build_schemas.py into the hand-written schema builders,
add glossary.schema.json, and test the generated schemas against the
targets; the only differences are two 2.0 spellings the code already had.

The 2.0 example fragments load and validate unchanged. The 2.1 example
bank gains `status: draft`, which every coursebank item requires.
tests/docs.rs skips docs/design/, which holds design records rather than
guide pages.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
alexmandClaude committed 2026-11-16 11:55:18 -05:00
1 parent 15175f64fd
commit 51a2fd235f
47 files changed
+10568 -55

No files matched your search

@@ -0,0 +1,213 @@
{
"$id": "https://coursebank.dev/schema/measurements.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"description": "What one administration measured. Written once and not rewritten, like a seal: it records a thing that happened on a day. Cohort aggregates only — no per-section or per-student breakdown, because a small cell crossed with anything else stops being an aggregate.",
"properties": {
"administration": {
"additionalProperties": false,
"properties": {
"assessment": {
"type": "string"
},
"coursebank": {
"type": "string"
},
"date": {
"description": "When it was given.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"forms": {
"description": "The forms in play.",
"items": {
"type": "string"
},
"type": "array"
},
"generated": {
"description": "When the analysis was run.",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"id": {
"type": "string"
},
"model": {
"type": "string"
},
"n_examinees": {
"description": "The number to read before any of the others: a point-biserial on twenty-seven students is a different kind of claim than one on three hundred.",
"minimum": 0,
"type": "integer"
},
"term": {
"type": "string"
}
},
"required": [
"id",
"assessment",
"n_examinees"
],
"type": "object"
},
"items": {
"items": {
"additionalProperties": false,
"properties": {
"discrimination_index": {
"maximum": 1.0,
"minimum": -1.0,
"type": "number"
},
"flags": {
"items": {
"enum": [
"negative_discrimination",
"low_discrimination",
"distractor_outperforms_key",
"key_underperforms",
"too_easy",
"too_hard",
"high_rapid_guess",
"nonfunctioning_distractor",
"dif_flagged",
"ambiguous",
"design_mismatch"
],
"type": "string"
},
"type": "array"
},
"irt": {
"additionalProperties": false,
"properties": {
"a": {
"description": "Discrimination.",
"type": "number"
},
"b": {
"description": "Difficulty.",
"type": "number"
},
"bayesian": {
"description": "Whether priors were used. On a class-sized sample they should be.",
"type": "boolean"
},
"c": {
"description": "Lower asymptote, 3PL only.",
"maximum": 1.0,
"minimum": 0.0,
"type": "number"
},
"model": {
"enum": [
"rasch",
"2pl",
"3pl"
],
"type": "string"
},
"n": {
"minimum": 0,
"type": "integer"
},
"se_a": {
"minimum": 0.0,
"type": "number"
},
"se_b": {
"minimum": 0.0,
"type": "number"
}
},
"required": [
"a",
"b"
],
"type": "object"
},
"item": {
"type": "string"
},
"n": {
"minimum": 0,
"type": "integer"
},
"number": {
"minimum": 1,
"type": "integer"
},
"option_stats": {
"additionalProperties": {
"additionalProperties": false,
"properties": {
"lower_group_rate": {
"description": "Rate in the bottom 27%.",
"maximum": 1.0,
"minimum": 0.0,
"type": "number"
},
"point_biserial": {
"maximum": 1.0,
"minimum": -1.0,
"type": "number"
},
"selection_rate": {
"description": "How often chosen.",
"maximum": 1.0,
"minimum": 0.0,
"type": "number"
},
"upper_group_rate": {
"description": "Rate in the top 27%.",
"maximum": 1.0,
"minimum": 0.0,
"type": "number"
}
},
"type": "object"
},
"type": "object"
},
"p_value": {
"description": "Proportion correct on this administration.",
"maximum": 1.0,
"minimum": 0.0,
"type": "number"
},
"point_biserial": {
"maximum": 1.0,
"minimum": -1.0,
"type": "number"
},
"stem_digest": {
"type": "string"
},
"variant": {
"type": "string"
}
},
"required": [
"item",
"number",
"n"
],
"type": "object"
},
"type": "array"
},
"schema_version": {
"type": [
"string",
"number"
]
}
},
"required": [
"administration"
],
"title": "coursebank administration record",
"type": "object"
}