Kernel Schema
Alignment patterns and evidence structure.
GET /kernels/{title}/themes — response shape
{
"lens": "social", // string — analytical perspective
"primary_system": "Class Masquerade", // string — dominant pattern name
"concept": "Class Identity Performance", // string — metalanguage term
"evidence_indices": [4, 6], // int[] — IDs in /evidence
"arc_coverage": ["exposition", "development", "climax"],
"quote_verified": true // bool — QVR gate passed
}
| Field | Type | Description |
|---|---|---|
| lens | string | Analytical perspective applied to the text. Derived by the pipeline without human constraint. |
| primary_system | string | The dominant structural pattern for this cluster. Algorithmically derived from verified Layer 1 evidence. |
| concept | string | Classroom-facing metalanguage term for this pattern. Used as the cycle focus by downstream generators. |
| evidence_indices | int[] | IDs of verified evidence entries in /kernels/evidence that anchor this theme to the physical text. |
| arc_coverage | string[] | Chronological arc phases covered by this theme's evidence. Validated by the Narrative Arc Validator gate. |
| quote_verified | bool | True when all linked evidence has passed the QVR Gate — character boundaries confirmed against source text. |
2 of 3
Routing Schema
Thread focus and arc routing structure.
GET /routing/{title}/thread-focus — response shape
{
"thread_name": "Fraternal Interdependence...", // string — full thread label
"concept": "Fraternal Interdependence", // string — cycle focus term
"lens": "relational", // string — thread lens
"devices": ["Juxtaposition", "Symbolism"], // string[] — active devices
"arc_entries": [ // object[] — chapter arc data
{ "chapter": 1, "arc_role": "introduced", "anchor_quote_count": 4 }
]
}
| Field | Type | Description |
|---|---|---|
| thread_name | string | Full label of the selected pedagogical thread. Used for display; not consumed by precision generators. |
| concept | string | The cycle focus metalanguage term selected for this learning cycle. Drives all downstream worksheet steps. |
| lens | string | Analytical lens for this thread. Filters the device inventory to the relevant subset. |
| devices | string[] | Literary devices active for this thread, filtered from the full device inventory. |
| arc_entries[].chapter | int | Chapter number. Selected by arc-phase distribution algorithm to cover the full narrative arc. |
| arc_entries[].arc_role | string | The chapter's role in the concept arc: introduced, developed, complicated, peaks, or resolved. |
3 of 3
Curation Schema
Step contract and density cap structure.
GET /curation/{title}/step-contracts — response shape
{
"step": "A1_arc_synthesis", // string — step identifier
"tlc_stage": "deconstruction", // string — Teaching-Learning Cycle stage
"scaffold_level": "medium", // string — heavy | medium | light | minimal
"density_caps": {
"max_events_per_task": 5, // int — Miller working memory floor
"max_words_per_evidence_block": 45
},
"audience_routing": {
"student_surface": ["scaffold_text", "write_box"],
"teacher_surface": ["model_answer", "overflow_evidence"]
}
}
| Field | Type | Description |
|---|---|---|
| step | string | Worksheet step identifier. Maps to a specific step in the Track A writing workflow. |
| tlc_stage | string | Teaching-Learning Cycle stage: building_field, deconstruction, joint_construction, or independent_construction. |
| scaffold_level | string | Vygotskian scaffold intensity: heavy, medium, light, or minimal. Fades across the TLC arc. |
| density_caps.max_events_per_task | int | Maximum content items per task region. Enforces Miller's working memory floor. Hard cap: ≤ 5. |
| audience_routing.student_surface | string[] | Content types permitted on the student worksheet. model_answer is never included — audience isolation is enforced. |
| audience_routing.teacher_surface | string[] | Content types routed to the teacher companion only. Includes model answers and overflow evidence not shown to students. |