Epic: Hermeneutic Lenses Content

[CraigBuckmaster]

Hermeneutic Lenses — Content Epic

Status: App code + DB schema complete. Content empty.

---

Feature Overview

Hermeneutic lenses let users read Scripture through different interpretive frameworks. When a lens is active, the app surfaces relevant panels, reorders content, and provides per-chapter guidance tailored to that approach.

Premium feature — lens toggle is gated.

---

DB Schema (already exists)

hermeneutic_lenses (
 id TEXT PRIMARY KEY,
 name TEXT NOT NULL,
 description TEXT NOT NULL,
 icon TEXT,
 display_order INTEGER NOT NULL
)

chapter_lens_content (
 chapter_id TEXT NOT NULL,
 lens_id TEXT NOT NULL,
 guidance TEXT NOT NULL,
 panel_filter_json TEXT,
 panel_order_json TEXT
)

---

Proposed Lenses (6-8)

Lens ID	Name	Description	Panel Priority
grammatical	Grammatical-Historical	What did the text mean to the original audience? Focus on language, history, and author intent.	heb, hist, ctx, scholar
typological	Typological	How do OT persons, events, and institutions foreshadow Christ and the church?	cross, themes, thread
redemptive	Redemptive-Historical	Where does this passage fit in the unfolding story of redemption?	themes, cross, thread
christocentric	Christ-Centered	How does this text point to, prepare for, or reflect Jesus?	cross, mac, themes
devotional	Devotional	What is God saying to me today? Application-focused reading.	mac, calvin, coaching
literary	Literary	Attend to genre, structure, chiasm, and artistry.	lit, chiasm, discourse
canonical	Canonical	How does this text relate to the whole Bible's witness?	cross, thread, themes
mission	Missional	How does this passage shape the church's mission to the world?	themes, mac, hist

---

Content Scope

Phase 1 — Lens definitions (1 session)

• Create content/meta/hermeneutic-lenses.json with 6-8 lens definitions
• Update build_sqlite.py to populate hermeneutic_lenses table

Phase 2 — Chapter guidance (~60 sessions @ 20 chapters each)

• Create per-chapter guidance for each lens
• 1,189 chapters × 6 lenses = ~7,134 entries
• Guidance: 2-3 sentences explaining what to notice through this lens
• Panel filter/order: JSON arrays specifying which panels to highlight

Suggested batch plan:

Batch	Scope	Chapters
1	Genesis	50
2	Exodus-Leviticus	67
3	Numbers-Deuteronomy	70
...	...	...

---

Content Guidelines

• Guidance text: Brief, actionable. "Notice how the water imagery here echoes the Red Sea crossing and anticipates baptism."
• Panel filter: Only include panels that exist for that chapter
• No fabrication: Lens guidance must reflect genuine hermeneutical approaches, not invented frameworks

---

Sub-Issues (to be created)

• Phase 1: Lens definitions JSON
• Phase 2: Pentateuch lens content (187 chapters)
• Phase 2: Historical Books lens content (249 chapters)
• Phase 2: Poetry/Wisdom lens content (243 chapters)
• Phase 2: Prophets lens content (250 chapters)
• Phase 2: Gospels + Acts lens content (117 chapters)
• Phase 2: Epistles lens content (121 chapters)
• Phase 2: Revelation lens content (22 chapters)

[CraigBuckmaster]

Sub-issue tree created and PR #1779 opened with Phase 0 scaffolding.

Sub-issues

• [#820 / 1] Wire panel_filter_json / panel_order_json in ChapterScreen #1780 — Phase 1: Wire panel_filter_json / panel_order_json in ChapterScreen (parallel-safe with Phase 0)
• [#820 / 2] Pilot batch — Genesis (50 chapters) #1781 — Phase 2 GATE: Genesis pilot (50 ch) — must ship clean before any genre batch opens
• [#820 / 3] Pentateuch rest — Exodus, Leviticus, Numbers, Deuteronomy (137 ch) #1782 — Pentateuch rest (137 ch)
• [#820 / 4] Historical Books — Joshua through Esther (249 ch) #1783 — Historical Books (249 ch)
• [#820 / 5] Poetry & Wisdom — Job, Psalms, Proverbs, Ecclesiastes, Song (243 ch) #1784 — Poetry & Wisdom (243 ch)
• [#820 / 6] Major Prophets — Isaiah through Daniel (183 ch) #1785 — Major Prophets (183 ch)
• [#820 / 7] Minor Prophets — Hosea through Malachi (67 ch) #1786 — Minor Prophets (67 ch)
• [#820 / 8] Gospels — Matthew, Mark, Luke, John (89 ch) #1787 — Gospels (89 ch)
• [#820 / 9] Acts and Epistles — Acts through Jude (149 ch) #1788 — Acts & Epistles (149 ch)
• [#820 / 10] Revelation (22 ch) #1789 — Revelation (22 ch)

Ordering

1. PR feat(lenses): Phase 0 scaffolding for hermeneutic lenses (#820) #1779 + [#820 / 1] Wire panel_filter_json / panel_order_json in ChapterScreen #1780 → ship in parallel
2. [#820 / 2] Pilot batch — Genesis (50 chapters) #1781 (gate) → must pass before unblocking the rest
3. [#820 / 3] Pentateuch rest — Exodus, Leviticus, Numbers, Deuteronomy (137 ch) #1782 through [#820 / 10] Revelation (22 ch) #1789 → parallel-safe once gate passes (different content directories, no overlap)

Decisions baked in

• Lens set: 8 — grammatical, literary, typological, redemptive, christocentric, canonical, devotional, mission
• Coverage: curated sparse — lenses only where they genuinely illuminate the chapter
• panel_filter_json / panel_order_json — in scope ([#820 / 1] Wire panel_filter_json / panel_order_json in ChapterScreen #1780 wires them)
• Generation: AI-generated batches with full quality + accuracy gates
• Quality bar: strictest — every entry runs accuracy auditor pre-merge, 90-point DVCR floor