- Add hover tooltip showing brief definition preview
- Smooth lift animation on word hover
- Green border highlight on expanded word
- Improved detail panel with header section
- Show word position as "X of Y"
- Better typography and spacing
- Hide tooltip on mobile, use bottom sheet instead
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Replace card grid with inline flow layout
- Click-to-expand word details
- Add link to full interlinear page
- Mobile bottom sheet for word details
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Clean inline flow layout for words (no cards/grid)
- Click-to-expand word details with definition popup
- Hebrew/Greek testament badges
- Separated OT/NT book lists with color coding
- Mobile: word details appear as bottom sheet
- Cleaner typography and spacing throughout
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Fix interactive tree deep linking via query parameter
- Redesign /family-tree main page with card-based layout
- Add feature cards, stats card, generation cards, notable figures
- Highlight Family Tree on /resources with Interactive badge
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Person profile links now include ?person=ID parameter
- Interactive tree reads query param and starts with that person
- Updates breadcrumb and dropdown to show the person name
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Main person card with blue/pink/gold gender & Kekulé coloring
- Section cards for Spouse, Parents, Siblings, Children
- Family member cards with gender colors and Kekulé badges
- Verse cards with scripture references
- Clean navigation with links to generation and interactive tree
- Consistent styling with generation view
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add DISABLE_ANALYTICS=true to docker-compose.yml for local dev
- Pass disable_analytics to Jinja2 templates as global
- Wrap Gauges analytics in conditional block
- Add blue/pink gender-based coloring to generation cards
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Replace verbose list with compact person cards
- Add generation stats bar (people count, Christ's line, offspring)
- Golden highlight for Kekulé ancestors
- Inline family info (spouse, parents, children)
- Show first verse reference with preview
- Streamlined navigation with prev/next and quick links
- Reduced whitespace throughout
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Create timeline page showing when biblical figures lived
- Display horizontal bars for each person's lifespan
- Filter by era (Antediluvian, Patriarchs, Judges, Kings, Exile)
- Filter to show Messianic line only or all people
- Golden highlighting for Christ's ancestors (Kekulé numbers)
- Hover tooltips with detailed person info
- Click to navigate to person's profile
- Zoom and pan support
- Update family tree page with prominent links to visualizations
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add golden/yellow highlight for Kekulé ancestors (blood relations to Christ)
- Add search autocomplete for finding people quickly
- Implement back button navigation with history tracking
- Add more Messianic lineage starting points (Seth, Enoch, Shem, Isaac, Jacob, Judah, Solomon, Josiah, Joseph)
- Set vertical layout as default
- Default to 3 generations for cleaner view
- Adjust zoom for better readability
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Completely rewrote the interactive family tree visualization with a
much more polished, professional design inspired by FamilySearch and
MacFamilyTree applications.
Visual improvements:
- Person cards with gender-based color coding (blue for male, pink for female)
- Rounded card corners with subtle shadows and gradients
- Generation badges on each card
- Birth/death dates displayed on cards
- Smooth hover effects with border highlighting
- Clean, modern control bar with grouped buttons
- Slide-out info sidebar instead of inline panel
Functional improvements:
- Multiple starting points (Adam, Noah, Abraham, David, Jesus ancestors)
- Adjustable generation depth (3-10)
- Horizontal and vertical layout options
- Zoom controls (+, -, reset, fit to view)
- Scroll to zoom, drag to pan
- Click any person to see detailed info in sidebar
- Responsive design for mobile
Technical changes:
- Custom SVG card rendering with D3.js
- Dynamic tree building with direction support (descendants/ancestors)
- Fit-to-view algorithm for automatic centering
- Window resize handling
- Gender inference from name database
This provides a much better user experience for exploring the biblical
genealogy, matching the quality expected from professional genealogy
applications.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Created a new interactive family tree visualization page that allows
users to explore biblical genealogies with a zoomable, clickable tree
diagram.
Features:
- D3.js tree layout with horizontal orientation
- Click nodes to view person details in info panel
- Zoom in/out and pan functionality
- Multiple view options (descendants, ancestors, generation, lineage)
- Multiple layout options (tree, radial, dendrogram - foundation laid)
- Expand/collapse controls
- Hover effects and selection highlighting
- Links to full person profiles
- Responsive design with Tufte CSS styling
Technical details:
- New route: /family-tree/interactive
- Template: family_tree_interactive.html
- D3.js v7 for tree rendering
- Hierarchical data built from GEDCOM family tree data
- Passes family_tree_data and generations to template as JSON
- Max depth control to prevent infinite recursion
Also updated family tree overview page to link to new visualizations
section featuring both the interactive tree and messianic lineage.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Fixed issue where spouse links weren't rendering in the person detail
page. The problem was that Jinja2's `{% set %}` inside a for loop doesn't
persist variable values outside the loop scope.
Solution: Use Jinja2's `namespace()` object to create mutable variables
that persist across scopes. Applied fix to three locations where spouse
lookups occur:
1. Inline spouse in vitals section (line 119)
2. Spouse name in family diagram (line 204)
3. Dedicated Spouse relationship section (line 257)
Now Adam and Eve (and all other spouses) properly show as clickable
links to their person pages with full metadata.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Enhanced the person detail page with a proper Spouse relationship section
to match the existing Parents, Siblings, and Children sections.
Features:
- Dedicated "Spouse" section between Parents and Siblings
- Clickable link to spouse's person page if in family tree
- Displays spouse metadata (generation, Kekulé number, lifespan)
- Shows "not in family tree data" note for spouses not in GEDCOM
- Consistent styling with other relationship sections
This makes spouse information more prominent and easier to find,
improving navigation between married couples in the family tree.
Previously spouse was only shown inline in the vitals section.
Now it has its own dedicated section for better visibility and
consistency with how other relationships are displayed.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Added additional historically documented marriages:
1. Esau & Mahalath (first cousins) - Genesis 28:9
- Mahalath was daughter of Ishmael, Isaac's half-brother
2. Othniel & Achsah (uncle-niece) - Judges 1:12-13
- Achsah was daughter of Caleb, Othniel's brother
- Given as reward for capturing Kiriath Sepher
3. Zelophehad's five daughters & their cousins - Numbers 36:11
- Mahlah, Tirzah, Hoglah, Milcah and Noah
- Married their father's brothers' sons (first cousins)
- Required to keep tribal inheritance within the family
Total documented close family marriages: 9 cases
These marriages provide important historical context about:
- Ancient Near Eastern marriage customs
- Tribal inheritance laws in Israel
- How family structures evolved over biblical history
- Cultural differences between ancient and modern times
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Created supplemental data file with 6 known close family marriages
from Scripture to provide accurate historical context.
New Data Files:
- close_family_marriages.json: Documented biblical marriages including:
* Abraham & Sarah (half-siblings) - Genesis 20:12
* Amram & Jochebed (aunt-nephew) - Exodus 6:20
* Jacob & Leah (first cousins) - Genesis 29:16
* Jacob & Rachel (first cousins) - Genesis 29:16
* Nahor & Milcah (uncle-niece) - Genesis 11:29
* Isaac & Rebekah (first cousin once removed) - Genesis 24:15
- schemas/close_family_marriages.schema.json: JSON schema with:
* Required fields: person1, person2, relationship, description, verse
* Enum for relationship types
* Pattern validation for verse references
* Optional notes field for additional context
API Changes:
- Add _load_close_family_marriages() helper function with LRU cache
- Load and count known marriages in statistics endpoint
- Statistics now show accurate count: 6 close family marriages
- Provides educational context about ancient Near Eastern customs
Each marriage entry includes:
- Names of both parties
- Specific relationship type (half-siblings, first cousins, etc.)
- Detailed description of the family connection
- Biblical verse reference documenting the marriage
- Additional notes with relevant quotes or context
This helps users understand how family structures and marriage
customs differed in biblical times compared to modern standards.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
New statistics added to the family tree overview:
Most Siblings:
- Tracks which person had the most siblings
- Currently shows Nathan with 18 siblings (one of David's 19 children)
Close Family Marriages:
- Detects marriages between close relatives
- Checks for sibling marriages and aunt/uncle-niece/nephew relationships
- Shows 0 in current GEDCOM data
- Provides historical context: "common in early biblical times"
- Important for understanding biblical/ancient Near Eastern culture
API Changes:
- Add most_siblings field to FamilyTreeStatsResponse
- Add close_family_marriages field with description
- Calculate sibling counts from GEDCOM relationship data
- Detect close family relationships through parent/sibling analysis
Template Updates:
- Add "Most Siblings" row with clickable link to person page
- Add "Close Family Marriages" row with contextual note
- Populate values via JavaScript from stats API
Test Updates:
- Add assertions for most_siblings structure
- Add assertions for close_family_marriages value
- Verify all new fields are present and correctly typed
This helps provide educational context about how family structures
differed in ancient biblical times compared to modern norms.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Major improvements to statistics endpoint and display:
API Enhancements:
- Add person_id to PersonStat model for accurate linking
- Integrate biographies.json data to supplement GEDCOM ages
- Support name aliases (e.g., "Mathusala or Methuselah" -> "Methuselah")
- Fix Methuselah showing as longest lived (969 years vs Adam's 930)
- Increase age data coverage from 1 to 53 people with known ages
- Improve average lifespan calculation (241.5 years with better data)
Template Improvements:
- Add clickable links to person pages in statistics
- Use actual GEDCOM person IDs instead of name slugs
- Remove average lifespan display from table (cleaner UI)
Test Updates:
- Add person_id field assertions to stats endpoint test
- Verify correct response structure with IDs
Statistics now show:
- 479 total people in genealogy
- 41 generations from Adam to Jesus
- Methuselah as longest lived (969 years)
- David with most children (19)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add statistics table to family tree overview showing:
- Total people (479)
- Total generations (41)
- Longest lived person (Adam - 930 years)
- Person with most children (David - 19 children)
- Average lifespan with data coverage
- Fetch statistics from /api/family-tree/stats endpoint via JavaScript
- Display loading state while fetching data
- Clean table layout for better readability
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add GET /api/family-tree/stats endpoint with comprehensive GEDCOM statistics
- Returns total people, generations, longest lived person, person with most children
- Parses "Lived XXX years" format from GEDCOM death records
- Calculates average lifespan for people with known ages
- Add comprehensive tests for statistics endpoint
- Update API index to include new stats endpoint
Statistics from the biblical genealogy GEDCOM:
- 479 total people
- 41 generations from Adam to Jesus
- David had the most children (19)
- Adam is the longest lived with recorded age (930 years)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Added comprehensive biographies for the last 3 missing major figures:
1. Isaiah - The evangelical prophet
- Vision of God's holiness in the temple
- Extensive messianic prophecies (virgin birth, suffering servant)
- Most quoted OT prophet in the New Testament
2. Ezra - Priest and scribe
- Led second wave of exiles from Babylon
- Reestablished centrality of God's Law
- Religious reform and covenant renewal
3. Nehemiah - Rebuilding leader
- Rebuilt Jerusalem's walls in 52 days
- Exemplary prayer and practical leadership
- Worked with Ezra in spiritual restoration
All major biblical figures now have biographies. The remaining ~400
people in the GEDCOM are mostly genealogical entries (the 'begats').
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Added comprehensive biography for Jonathan including:
- Summary of his friendship with David and royal lineage
- Theological significance as example of sacrificial friendship
- 7 key life events from military victories to death at Mount Gilboa
Jonathan was the only major figure from the list missing - all others
(Eve, Cain, Abel, Jesus, David, Solomon, Mary, Daniel, Ruth) already
had biographies.
Now accessible via GET /api/family-tree/Jonathan
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Keep blue-green deployment strategy but with single minimum machine to reduce costs. During deployment, Fly.io will:
- Start new machine (green)
- Run health checks
- Switch traffic
- Stop old machine (blue)
Note: This may have brief startup time during deployment, but significantly reduces operating costs.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Changes:
- Added [deploy] strategy = "bluegreen" to fly.toml
- Increased min_machines_running from 1 to 2
- Disabled auto_stop_machines to keep both environments ready
- Updated GitHub Actions workflow with --strategy bluegreen flag
How Blue-Green Works:
1. Deploy creates new "green" environment alongside current "blue"
2. Health checks verify green environment is healthy
3. Traffic switches instantly from blue to green
4. Old blue environment kept briefly for instant rollback
5. Zero downtime during deployments
Cost Impact:
- Runs minimum 2 machines instead of 1
- Ensures true zero-downtime deployments
- Instant rollback capability
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Added comprehensive biography for Job including:
- Summary of his story from the Book of Job
- Theological significance as prefiguring Christ
- 7 key life events from suffering to restoration
Now accessible via GET /api/family-tree/Job
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
The warnings are cosmetic - we use 'example' instead of 'examples' because it works better for pre-filling Swagger UI input fields with default values.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
New Endpoints:
1. GET /api/verse/random - Random verse with OT/NT/book filtering
2. GET /api/commentary/{book}/{chapter}/{verse} - AI-generated verse commentary
3. GET /api/chapter-commentary/{book}/{chapter} - Chapter explanations
4. POST /api/verses/bulk - Bulk verse lookup
5. GET /api/family-tree - List biblical figures
6. GET /api/family-tree/{name} - Get biography with alias support
Features:
- Random verse supports testament (ot/nt) and book filters
- Commentary includes analysis, historical context, and reflection questions
- Chapter commentary provides context for each chapter
- Bulk lookup handles multiple verse references in one request
- Family tree supports name aliases (e.g., Israel → Jacob)
- All endpoints include comprehensive OpenAPI documentation
Tests:
- Added 19 new tests (78 total, all passing)
- Test coverage for all new endpoints
- Edge case handling (invalid inputs, 404s, etc.)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Added /api/red-letter endpoint for listing all verses where Jesus speaks
- Supports filtering by book
- Includes pagination (limit/offset)
- Returns verse text, reference, and whether full or partial
- Added /api/red-letter/stats endpoint for statistics
- Total count of red letter verses
- Breakdown by full vs partial verses
- Count by book
- List of books containing red letter verses
- Added 8 comprehensive tests (59 total tests now)
- All tests passing
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Updated all API endpoint parameters to use `example` instead of `examples` for better Swagger UI experience
- Parameters now pre-fill with reasonable defaults when testing endpoints in /api/docs
- Added --reload and --reload-include '*.json' flags to docker-compose for auto-reload on JSON changes
- Included commentary-generator agent configuration for AI-powered verse commentary
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
New features:
- PDF export endpoints for resources
* GET /api/resources/{category}/pdf - Category PDF
* GET /api/resources/{category}/{slug}/pdf - Item PDF
* Proper error handling (404 before 503)
* Uses existing resource_detail_pdf.html templates
- Add html_url field to resource categories
* Provides web URL in addition to API URL
* Format: /biblical-locations (kebab-case)
* Helps clients link to HTML pages
Comprehensive test coverage (12 new tests):
- test_list_all_resources - List all 39 categories
- test_get_resource_category - Get category items
- test_get_resource_category_biblical_locations - Nested structures
- test_get_resource_item - Get specific item with verses
- test_get_resource_item_from_different_categories - Multiple types
- test_get_nonexistent_resource_category - 404 handling
- test_get_nonexistent_resource_item - Item 404
- test_resource_category_pdf - PDF generation
- test_resource_item_pdf - Item PDF
- test_resource_pdf_nonexistent_category - PDF 404
- test_resource_pdf_nonexistent_item - Item PDF 404
- test_all_resource_categories_accessible - All categories work
All 51 API tests passing (was 39, added 12).
Note: PDF route ordering with FastAPI path matching is documented
in tests. More specific routes should ideally come before general ones.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
New endpoints:
- GET /api/resources - List all 39 resource categories
- GET /api/resources/{category} - Get all items in a category
- GET /api/resources/{category}/{slug} - Get specific resource details
Features:
- Pydantic response models with OpenAPI documentation
- Complete examples in Swagger UI
- Support for all 39 resource categories:
* Biblical locations (Old/New Testament)
* Angels, Prophets, Apostles, Women of the Bible
* Parables, Miracles, Prayers, Beatitudes
* Names of God, Names of Christ, I AM Statements
* Theological resources (Trinity, Christology, Soteriology, etc.)
* Systematic theology (Bibliology, Pneumatology, Eschatology, etc.)
* Armor of God, Ten Commandments, Fruits of the Spirit
* Covenants, Festivals, Types & Shadows, Messianic Prophecies
* And many more...
Technical implementation:
- Handles nested resource structures (e.g., biblical_locations with OT/NT subcategories)
- Recursive slug-based search for flexible data access
- Full verse references included with each resource item
- Comprehensive category metadata (item counts, URLs)
- Clean JSON responses with proper field descriptions
All existing tests pass - no breaking changes.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Add red_letter field to all verse API responses
* /api/verse/{book}/{chapter}/{verse} - single verse
* /api/verse-range/{book}/{chapter}/{start}/{end} - verse ranges
* /api/verse-of-the-day - daily verse
Red letter field values:
* null - Jesus doesn't speak in this verse
* "full" - entire verse is Jesus speaking (e.g., John 3:16)
* "quoted text" - partial verse with exact words Jesus spoke
- Add Pydantic response models for OpenAPI documentation
* VerseResponse - single verse with red_letter field
* VerseRangeResponse - verse range with red_letter per verse
* DailyVerseResponse - daily verse with red_letter
* Includes comprehensive examples showing all red letter scenarios
- Enhance OpenAPI/Swagger documentation
* Add detailed response examples for each endpoint
* Multiple example scenarios (Jesus speaking, not speaking, partial)
* Improved parameter descriptions with validation (ge=1)
* Better endpoint summaries and descriptions
- Add comprehensive test coverage for red letter feature
* test_red_letter_full_verse - Jesus speaks entire verse
* test_red_letter_partial_verse - Jesus speaks part of verse
* test_red_letter_no_words - Jesus doesn't speak
* test_red_letter_verse_range_with_christ_words - range test
* Update existing tests to verify red_letter field presence
All 39 API tests pass with no warnings.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Generated using commentary-generator agent with Reformed theological perspective.
Commentary includes:
- Deep theological analysis with Hebrew text and transliteration
- Messianic prophecy exposition (John the Baptist and Jesus)
- Post-exilic historical context
- Cross-references to NT fulfillment passages
- Practical application questions
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
WeasyPrint outputs logging messages to stdout/stderr when imported,
which pollutes the console output. This change temporarily redirects
stdout/stderr to /dev/null during the import, then restores them.
Changes:
- Added sys and os imports
- Wrapped WeasyPrint import with stdout/stderr suppression
- Properly restore stdout/stderr in finally block
Result: Clean import with no console noise
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
The verse_commentary.json already contains extensive high-quality commentary
on all Pauline epistles with superior analysis. The pauline_commentary.json
was redundant and of lower quality.
Current Pauline coverage in verse_commentary.json:
- Complete: Romans, 1-2 Corinthians, Galatians, Ephesians, Philippians,
Colossians, 1-2 Thessalonians, 1-2 Timothy, Titus, Philemon
- All key verses already covered with detailed theological analysis
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Organize schema files:
- Moved red_letter_verses.schema.json to schemas/ directory
- Updated README.md references to point to new location (schemas/red_letter_verses.schema.json)
- Maintains consistency with other schema files (all now in schemas/ directory)
The validation script (scripts/validate_data.py) already uses the schemas/ directory, so no code changes needed.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
kennethreitz