API Explorer | LuminAIT Developer Portal

Corpus: The Outsiders

Kernel

GET /kernels/themes

GET /kernels/evidence

GET /kernels/devices

Routing

GET /routing/thread-focus

Curation

GET /curation/step-contracts

Layer 2: Thematic Architecture

Returns the high-level structural patterns derived from the text, independent of chronological plot events.

Contracts Enforced: Narrative Arc Validator Stage 6: Thematic DerivationPrevents isolated plot grouping. A theme is only validated if its underlying evidence_indices stretch across the established chronological timeline (INTR/DEV/PEAK).

{

"status": 200,
"data": {

"lens" Schema Definition (String)The macro-analytical perspective applied to the text. Derived natively by the pipeline without human prompting constraint. : "social",
"primary_system" Schema Definition (String)The dominant structural pattern governing this cluster. Algorithmically clustered from the verified Layer 1 objects below. : "Class Masquerade",
"concept": "Class Identity Performance",

// Linking Mechanism: IDs pointing to verified text anchors in Layer 1
"evidence_indices" Relational Data ArrayThese IDs point directly to Stage 5 evidence (Layer 1). This link proves the abstract theme is physically anchored to exact textual instances. : [

4 Click to fetch the verified quote (ID: 4) that anchors this theme to the physical text. ,
6

],
"arc_coverage": ["exposition", "development", "climax"],
"quote_verified": true

}

Layer 1: Verified Evidence Database

Returns specific, authenticated text excerpts. Governed by the QVR Gate to ensure zero LLM hallucination.

Contracts Enforced: The QVR Gate (Precision) Stage 5: Quote VerificationNo string enters this array unless a deterministic script proves its exact character boundaries exist within the authenticated source text. Kills LLM semantic drift. Cognitive Load Thresholds Stage 5: Scope LimiterLimits extraction to strict density bounds (4–6 quotes per chapter) to prevent bloating the downstream pedagogical engines.

// Querying Evidence ID: 4 (linked from 'Class Masquerade' theme)
{

"id": 4,
"device_name": "Juxtaposition",

// Character strings matched against the source text
"full_quote": "I'm not sure how you spell it, but it's the abbreviation for the Socials, the jet set, the West-side rich kids. It's like the term greaser, which is used to class all us boys on the East Side.",

"quote_verified" Quote Verification Rate (QVR) GateA deterministic Python function searched the source text and verified the character boundaries. This guarantees the LLM did not hallucinate the plot. : true,

"chapter": 1,
"location_percent": 8.5

}

Layer 3: Device Inventory

Returns active literary devices for the selected lens, ranked by semiotic tier and arc role. The full taxonomy indexes 71 devices.

Contracts Enforced: Device Taxonomy Gate Device Inventory ContractEvery device in this list traces to at least one verified quote via the device_object_associations contract. Devices without verified evidence are excluded from API output.

// GET /kernels/the-outsiders/devices?lens=social
{

"lens": "social",
"total_indexed": 71,
"filter": "active",
"results": [

{ "name": "Juxtaposition", "semiotic_tier": "L3", "arc_role": "peaks", "occurrence_count": 12 },
{ "name": "Loaded Language", "semiotic_tier": "L2", "arc_role": "developed", "occurrence_count": 8 },
{ "name": "Metaphor", "semiotic_tier": "L2", "arc_role": "introduced", "occurrence_count": 9 },
{ "name": "Symbolism", "semiotic_tier": "L4", "arc_role": "peaks", "occurrence_count": 4 }
// ... 67 more devices in full response

]

}

Routing: Thread Focus

Returns the pre-selected pedagogical thread and metalanguage concept for the current learning cycle. Derived by precision code — no LLM involvement.

Contracts Enforced: Routing Contract Bridge 1: Routing JSONthread_focus is derived deterministically from kernel arc data. Route selection, concept assignment, and arc_entries are all PRECISION operations — $0 cost, fully reproducible.

// GET /routing/the-outsiders/thread-focus
{

"thread_name": "Fraternal Interdependence and Trauma-Driven Transformation",
"concept": "Fraternal Interdependence",
"lens": "relational",
"devices": ["Juxtaposition", "Symbolism", "Metaphor"],
"arc_entries": [

{ "chapter": 1, "arc_role": "introduced", "anchor_quote_count": 4 },
{ "chapter": 6, "arc_role": "developed", "anchor_quote_count": 6 },
{ "chapter": 9, "arc_role": "peaks", "anchor_quote_count": 7 }

]

}

Curation: Step Contracts

Returns per-step density caps and audience routing assignments. Governs what each worksheet surface is permitted to show.

Contracts Enforced: Density Cap Enforcer Bridge 2: Curation Manifestmax_events_per_task ≤ 5 enforces Miller's working memory floor across all downstream generators. No generator may display more data than the manifest permits.

// GET /curation/the-outsiders/step-contracts?step=A1_arc_synthesis
{

"step": "A1_arc_synthesis",
"tlc_stage": "deconstruction",
"scaffold_level": "medium",
"density_caps": {

"max_events_per_task": 5,
"max_words_per_evidence_block": 45

},
"audience_routing": {

"student_surface": ["scaffold_text", "write_box", "arc_badge"],
"teacher_surface": ["model_answer", "overflow_evidence"]

}

Interactive API Explorer