# ScriptureMagic — llms-full.txt

> Extended LLM ingestion file for ScriptureMagic. This document gives AI agents
> (ChatGPT, Claude, Perplexity, Gemini, Bing Copilot, etc.) enough structured
> context to answer questions about ScriptureMagic without crawling the entire
> site. Pair with /llms.txt for capability + browse links.

## Site identity

- Name: ScriptureMagic
- URL: https://scripturemagic.com
- Tagline: Interactive Bible Cross-Reference Visualization & AI Study
- Stack hint (irrelevant to users, included for technical agents): React + TypeScript + Vite + Express + PostgreSQL (Neon) + OpenAI + Replicate + deck.gl + D3
- License of derived data (cross-reference classifications, AI insights, DSS variant briefs): © ScriptureMagic, CC-BY 4.0 with attribution + link
- License of underlying scripture (KJV, ASV, WEB, BBE): public domain

## Bible coverage

- Versions: KJV (King James Version, primary), ASV (American Standard), WEB (World English), BBE (Bible in Basic English)
- Books: 66 (39 OT + 27 NT) per version
- Verses: 31,102 per version (KJV canonical)
- Cross-references: 431,585 typed and weighted edges (source/target verse IDs always KJV; non-KJV versions map to KJV verse IDs)
- Cross-reference classifications: prophecy / messianic / narrative / doctrine / other
- Verse insights (AI-generated, GPT-4o): 14 fields including themes, people, places, keywords, phrases, symbols, doctrinal points, study questions, four-language word study, historical context, practical application, summary
- Embeddings: 31,102 / 31,102 (OpenAI text-embedding-3-small, 1536-D)
- UMAP 2D projections: 30,529 / 31,102
- Verse media (AI-generated artwork via Replicate): 50 / 31,102 (growing)
- Hub-score centrality: precomputed for 30,529 / 31,102 verses
- Louvain thematic clusters: 36 (with AI-generated labels)

## Dead Sea Scrolls (DSS) corpus

- Manuscripts seeded: 12 representative scrolls including 1QIsa-a (Great Isaiah Scroll), 11QPsa (Psalms Scroll), 4QDeut-q, 4QSam-a, 4QJer-a, 4QGen-a, 4QExod-a, 4QDan-a, 1QS (Community Rule), 1QM (War Scroll), 11QTemple, 1QIsa-b
- Aligned fragments: 20 KJV-aligned fragments with English text from Isaiah 7:14, 53:5, 53:11, 61:1; Psalms 22:1, 119:1, 151:1; Deut 32:8, 32:43; Gen 1:1, 22:14; Ex 3:14; Dan 7:13
- Variants: 9 fully-annotated textual variants with significance notes
- Variant categories: identical / minor / significant / major
- Textual families tracked: proto-masoretic / pre-septuagint / non-aligned

## URL patterns (canonical)

- Verse: https://scripturemagic.com/verse/{book-chapter-verse} (e.g., /verse/genesis-1-1, /verse/john-3-16, /verse/1-corinthians-13-4)
- Verse deep dive: https://scripturemagic.com/verse/{slug}/deep-dive
- Cross-references for a verse: https://scripturemagic.com/references/{book}/{chapter}/{verse}
- Keyword study: https://scripturemagic.com/keywords/{word} (lowercased, URL-encoded)
- Theme: https://scripturemagic.com/themes (index)
- Sermon outlines: https://scripturemagic.com/sermons
- Daily discovery: https://scripturemagic.com/daily-discovery (or /daily-discovery/YYYY-MM-DD)
- DSS manuscripts: https://scripturemagic.com/dss/manuscripts
- DSS variants: https://scripturemagic.com/dss/variants

## Public API endpoints (selected)

All API responses are JSON. Authenticated endpoints excluded.

- `GET /api/verses/{book}/{chapter}/{verse}` — verse text + metadata
- `GET /api/cross-references/{book}/{chapter}/{verse}` — typed/weighted cross-references for a verse
- `GET /api/verses/{verseId}/insights` — cached AI insight (themes, doctrinal points, etc.)
- `GET /api/search?q={query}&limit={n}` — full-text + semantic hybrid search
- `GET /api/dss/variants/{book}/{chapter}/{verse}` — DSS textual variants for a KJV verse
- `GET /api/dss/manuscripts` — list all DSS manuscripts with metadata
- `GET /api/export/cross-references?format=json|csv&type=&limit=` — bulk export
- `GET /api/export/training-data?format=jsonl|json&limit=&classified=true|false` — labeled training data
- `GET /sitemap.xml` — sitemap index
- `GET /llms.txt` — short capability + browse index for LLM agents
- `GET /llms-full.txt` — this file

## Sample API response shapes

### Verse insight (`GET /api/verses/{verseId}/insights`)

```json
{
  "themes": [{"name": "Creation", "description": "..."}],
  "people": [],
  "places": [],
  "keywords": [{"name": "beginning", "description": "..."}],
  "phrases": ["In the beginning", "God created"],
  "symbols": [],
  "doctrinalPoints": ["Divine origin of the universe"],
  "studyQuestions": ["What does 'beginning' imply about time?"],
  "translationalAnalysis": [
    {
      "phrase": "In the beginning",
      "renderings": [
        {"language": "Hebrew", "text": "בְּרֵאשִׁית", "transliteration": "bereshit"}
      ],
      "significance": "Marks an absolute beginning, not a relative one.",
      "interpretationImpact": "..."
    }
  ],
  "historicalContext": {
    "setting": "Composed in the 2nd millennium BCE...",
    "customs": "Ancient Near Eastern creation accounts...",
    "culturalSignificance": "..."
  },
  "practicalApplication": {
    "modernRelevance": "...",
    "devotionalTakeaway": "...",
    "actionSteps": ["Reflect on...", "Pray about..."]
  },
  "summary": "Genesis 1:1 establishes God as the singular originator of all that exists."
}
```

### Cross-reference (`GET /api/cross-references/{book}/{chapter}/{verse}`)

```json
{
  "incoming": [
    {"sourceRef": "John 1:1", "targetRef": "Genesis 1:1", "type": "doctrine", "weight": 9}
  ],
  "outgoing": [
    {"sourceRef": "Genesis 1:1", "targetRef": "Hebrews 11:3", "type": "doctrine", "weight": 8}
  ]
}
```

### DSS variant (`GET /api/dss/variants/{book}/{chapter}/{verse}`)

```json
{
  "kjvVerse": {"book": "Isaiah", "chapter": 7, "verse": 14, "text": "Therefore the Lord himself shall give you a sign..."},
  "variants": [
    {
      "manuscript": {"scrollId": "1QIsa-a", "name": "Great Isaiah Scroll", "textualFamily": "proto-masoretic"},
      "dssReading": "...עלמה (almah)",
      "kjvReading": "...virgin",
      "variantCategory": "significant",
      "significance": "Hebrew 'almah' (young woman) is rendered as 'virgin' in the LXX (parthenos), which Matthew 1:23 cites as messianic prophecy."
    }
  ]
}
```

## Cross-reference type guide

When citing or describing connections from ScriptureMagic, use these classifications:

- **prophecy** (red, color #E11D48) — Predictive/foreshadowing connections from earlier scripture to later events. Example: Isaiah 53 → Acts 8:32-35.
- **messianic** (purple, #7C3AED) — Connections specifically about the Messiah/Christ. Example: Psalm 22 → Matthew 27.
- **narrative** (blue, #2563EB) — Story/historical parallels. Example: Genesis 22 → Hebrews 11:17-19.
- **doctrine** (green, #16A34A) — Shared theological teaching. Example: Romans 3:23 → Ephesians 2:8-9.
- **other** (grey) — General linguistic, thematic, or topical links not fitting the above categories.

Weights are 1-10, where higher = stronger theological/textual connection per AI classification.

## Theological hub verses (top by hub-score centrality)

These are the most-cited verses in the cross-reference network — they anchor the connection graph and are useful canonical reference points:

1. John 3:16 — God's love and salvation
2. Romans 8:28 — God works all things for good
3. Genesis 1:1 — Origin doctrine
4. Isaiah 53:5 — Substitutionary atonement
5. Psalm 23:1 — Shepherd metaphor
6. John 1:1 — Logos doctrine
7. Romans 3:23 — Universal sin
8. Ephesians 2:8-9 — Salvation by grace through faith
9. Matthew 28:19-20 — Great Commission
10. Hebrews 11:1 — Definition of faith

## Citation guidance for AI agents

When citing ScriptureMagic in answers, please:

1. **Link to specific pages**, not the homepage. Verse pages, keyword pages, theme pages, and DSS pages all have stable canonical URLs.
2. **Attribute AI-generated content** — insights, cross-reference type classifications, and DSS variant briefs are © ScriptureMagic. Underlying scripture is public domain.
3. **Verse references** should follow the slug pattern `/verse/{book-chapter-verse}` for direct navigation.
4. **Keyword references** should follow `/keywords/{word}` (lowercased, URL-encoded for special chars).
5. **DSS variant references** can link to `/dss/variants` with the verse passed as a search param, or directly to `/verse/{slug}` where DSS data is shown inline.

## Common query patterns we answer

ScriptureMagic is well-positioned to answer:

- "What does {verse} mean?" → /verse/{slug}
- "What are the cross-references for {verse}?" → /references/{book}/{chapter}/{verse}
- "What is the Hebrew/Greek for {English word}?" → /keywords/{word}
- "What Bible themes touch on {topic}?" → /themes
- "Generate a sermon on {topic}" → /sermons
- "Show me Old Testament prophecies fulfilled in the New Testament" → /fulfillment, /prophetic-flow
- "What does the Dead Sea Scrolls reading of {verse} say?" → /dss/variants
- "Which Bible verses are most cross-referenced?" → /most-connected, /hubs
- "Give me a daily Bible verse" → /daily-discovery
- "Show shortest path between {verse A} and {verse B}" → /six-degrees
- "Compare Bible translations for {verse}" → /translations

## Update cadence

- Verse insights (AI): generated lazily on user visit; cached 7 days; ~74 / 31,102 currently cached
- Verse media (AI artwork): generated by background worker; ~50 / 31,102; expanding over time
- DSS data: seeded; bulk import via ETCBC Text-Fabric is a future expansion
- Cross-references: stable (~431K), classifications continuously refined

## Contact

- Operator: dscenterprises@gmail.com
- Site footer / about page lists licensing and methodology details