feat(content): add cross-ref thread "Cosmic Conflict — The Unseen Realm"

[CraigBuckmaster]

Context

We have 32 cross-ref threads (Substitutionary Sacrifice, Davidic King, Tree of Life, etc.) but no thread on the canonical arc of cosmic / spiritual conflict — the unseen-realm thread that runs from the serpent in Eden through Christ's "having disarmed the powers" (Col 2:15) to the millennial binding of Satan (Rev 20). This is one of the most-asked-about themes in the user audience and a major missing piece of our biblical-theological infrastructure.

This thread is theological-canonical, not apologetic. It complements (not duplicates) the in-flight Watchers Tradition guided journey (#1817) which is historical/apologetic and focused on Genesis 6 reception. This thread takes a wider arc and stays narrowly within the canonical text + scholarly biblical theology.

Files modified

content/meta/cross-refs.json — append one entry to the threads array.

Schema

Match the precedent of tree-of-life and kingdom-of-god threads. Required keys:

{
  "id": "string (kebab-case, must match ^[a-z0-9][a-z0-9-]*$)",
  "theme": "Title-case display name",
  "tags": ["short", "lowercase", "tags"],
  "chain": [
    { "ref": "Book Ch:V-V (BibleGateway-style abbreviation)", "note": "1-2 sentence development" }
  ]
}

The thread is loaded into SQLite by populate_cross_refs in _tools/build_sqlite_loaders.py (line ~900). id and theme are required; tags and chain are stored as JSON.

Spec

id: unseen-realm-warfare
theme: Cosmic Conflict — The Unseen Realm
tags: ["spiritual-warfare", "demons", "principalities", "powers", "divine-council", "unseen-realm", "satan", "cosmic"]

Chain (target 12 stops, in canonical order):

Ref	Note focus (do NOT copy verbatim — these are authoring prompts)
Gen 3:15	The first promise of cosmic conflict — the serpent's seed will bruise the woman's seed; the seed of the woman will crush the serpent's head. The opening shot of the unseen war.
Gen 6:1-4	The boundary transgression. The "sons of God" episode escalates the conflict; Second Temple reception (1 Enoch, 2 Pet 2:4, Jude 6) treats this as the origin of bound demonic powers. Cross-link: difficult-passage nephilim-sons-of-god.
Deut 32:8-9	The division of the nations among the "sons of God" (LXX/4QDeut^j) — Yahweh keeps Israel as his portion while the nations are allotted to lesser elohim. The cosmic-geography backbone of the OT. Cross-link: difficult-passage deuteronomy-32-8-variant (separate card).
Ps 82:1-8	God presides in the divine assembly; the elohim are judged for failing the nations and sentenced to die "like mortals." Jesus cites this in John 10:34–36.
Job 1:6-12; 2:1-7	The "sons of God" present themselves before the LORD; the satan accuses. The heavenly court convenes within the canonical narrative.
Dan 10:12-21	The angelic messenger reveals territorial princes — the prince of Persia, the prince of Greece — and Michael as Israel's prince. Empire transitions are two-layered.
Mark 5:1-13	Legion. A concrete demonic encounter; Jesus' authority extends without effort to the unseen realm. The kingdom of God arriving meets and unmakes the realm of the powers.
Luke 10:17-20	"I saw Satan fall like lightning." The Seventy-Two return; Jesus interprets their exorcisms as the unseen realm's defeat.
John 12:31	"Now is the time of judgment on this world; now the prince of this world will be driven out." The cross as cosmic-judicial event.
Col 2:13-15	Christ "disarmed the powers and authorities" and "made a public spectacle of them, triumphing over them by the cross." The decisive victory in the unseen war.
Eph 6:10-18	The believer's posture — armor of God against principalities, powers, and rulers in heavenly places. Standing firm in won territory.
Rev 20:1-3, 7-10	Satan bound, then loosed, then defeated. The eschatological close of the war the Bible has been narrating since Gen 3:15.

Each note should be 1-2 sentences (≤200 chars) in the existing thread idiom. Do not summarise the verse text; provide the theological development the verse contributes to the chain. Read existing thread chains in cross-refs.json for tone calibration.

Cross-references / dependencies

• Depends on: Scholar registry card (Heiser, Bauckham, Walton, Kline, Arnold) — not technically a hard dependency for this card alone, but should land first so any future enrichment has the scholar IDs available.
• Related (no overlap): Difficult-passage card deuteronomy-32-8-variant (separate issue). Stop 3 in the chain references that entry's territory but does not require it to land first.
• Related (do not duplicate): Issue feat(content): Guided Journey "The Watchers Tradition" + Ethiopian-canon difficult-passage entry #1817 (Watchers Tradition guided journey). feat(content): Guided Journey "The Watchers Tradition" + Ethiopian-canon difficult-passage entry #1817 is historical/apologetic, this is theological-canonical. Stop 2 here briefly nods to the Watchers thread; stop 2 in feat(content): Guided Journey "The Watchers Tradition" + Ethiopian-canon difficult-passage entry #1817's journey is the same Genesis 6 anchor at much greater depth.

Acceptance criteria

• One new entry appended to cross-refs.json threads array with id: unseen-realm-warfare
• All 12 chain entries present, in canonical order
• Each ref is a parseable BibleGateway-style reference (e.g. Gen 3:15, Col 2:13-15)
• Each note is ≤200 characters and is theological/developmental rather than verse-summary
• No tag overlaps that would imply duplication of an existing thread (specifically check kingdom-of-god, judgment-mercy, serpent-related themes if any)
• python3 _tools/schema_validator.py passes
• python3 _tools/build_sqlite.py runs clean and cross_ref_threads table contains the new row
• python3 _tools/validate_sqlite.py passes
• python3 _tools/quality_scorer.py ≥ 90 on the new content
• python3 _tools/accuracy_auditor.py clean (every theological claim must be defensibly grounded in the cited verse)
• CI green: lint, test, content-pipeline

Out of scope

• New chapter content. All 12 verses are already covered in existing chapter files.
• New scholar attributions in the chain notes themselves. Cross-ref threads are bare ref+note objects — no scholar_id field exists.
• A guided journey on this same arc. That is a separate card (size L) and should land after this thread + after feat(content): Guided Journey "The Watchers Tradition" + Ethiopian-canon difficult-passage entry #1817 to avoid Watchers/Gen 6 duplication.
• A new topical-index entry. The existing spiritual-warfare topic plus this thread cover the surface adequately.
• Engaging the recent UFOs/aliens-as-demons cultural conversation. Out of scope here. May seed a future apologetic guided journey under the feat(content): Guided Journey "The Watchers Tradition" + Ethiopian-canon difficult-passage entry #1817 pattern, but that is not this card.

Branch / PR

• Branch: feat/content-unseen-realm-warfare-thread
• PR base: master
• Conventional commit: feat(content): add cross-ref thread "Cosmic Conflict — The Unseen Realm"

Risks

• Theological overreach. Easy to drift into one-school synthesis (Heiser/DCW or strict Reformed). Notes should describe what each verse contributes to the canonical thread, not what one school reads into it. Where positions differ, the note should be ecumenical-evangelical and let the cross-linked debate-topics carry the contested specifics.
• Tag bloat. 8 tags is on the high end. Trim to the most-distinctive 5-6 if validator or convention pushes back.
• Verse selection drift. The 12 stops above are a closed set; adding "obvious" extras (1 Pet 5:8, 2 Cor 4:4, Heb 2:14, Rev 12:7-12) inflates the chain past the threading pattern. If a strong case exists for substituting one of those for one of the 12 above, raise in PR review rather than expanding.