Changelog

Q4 2025 Changelog (Oct-Dec)

v2-iconic hexagrams, SEO optimization, and ChatGPT-style UI.

2025-12-01 — ChatGPT-Style Divination UI

Added

  • ChatGPT-Style Sidebar Navigation - New collapsible sidebar on the divination page with quick access to all tools
  • Desktop: Persistent sidebar that collapses to icon-only mode
  • Mobile: Slide-out drawer with hamburger menu trigger
  • Remembers your preference (expanded/collapsed) across sessions

  • Search in History Panel - Find past divinations quickly with real-time search
  • Debounced search (300ms) for smooth performance
  • Searches across divination titles and content

  • Exit Button - Quick navigation back to home from the divination interface

  • Server-Side Bot Detection - Improved SEO for search engines and AI crawlers
  • Detects 50+ bot user agents (Google, Bing, ChatGPT, Claude, Perplexity, etc.)
  • Serves optimized content for crawlers without affecting user experience

  • New Translations - Added sidebar-related translations for all supported languages (EN, ZH, ZH-CN, TH)

Changed

  • Divination Page Layout - Redesigned with centered chat container (max-width 768px) matching modern chat interfaces
  • Mobile Top Bar - New compact header with hamburger menu, mode dropdown, and new divination button
  • Desktop Controls - Floating top-right controls with language switcher, online users, and theme toggle
  • Sidebar State Management - New useSidebarState hook with proper SSR/hydration handling

2025-11-15 — v2-iconic Hexagram Expansion

Added

  • New v2-iconic Hexagrams - 10+ new digital artifacts with translations
  • Hex 15: Ada Lovelace (First Computer Program)
  • Hex 26: von Neumann (Self-Replicating Machines)
  • Hex 29: Blade Runner
  • Hex 31: Duran Duran Rio
  • Hex 37: Interstellar (23 Years of Messages)
  • Hex 44: Matrix Trinity Typing
  • Hex 52: Spirited Away (No-Face)
  • Admin Dashboard - New admin page for managing content and settings
  • Daily Hexagram Enhancements - Full header view and server-side redirects

Changed

  • Improved hexagram search to include creator and year
  • Enhanced article scrapability for SEO crawlers
  • Externalized tech-noir transformation prompt for better image quality

Fixed

  • TypeScript error handling in validation scripts
  • Hexagram 29 zh JSON syntax repair
  • Binary representation fixes across hexagram data

2025-11-01 — SSR & SEO Optimization

Added

  • Evaluation Infrastructure - A/B testing framework for AI model comparison
  • Moonshot Kimi evaluation scripts
  • Emotional depth and performance metrics
  • Thai language evaluation results
  • Feature Access System - Dynasty theme with controlled feature rollout

Changed

  • Comprehensive SSR bailout fixes for Next.js 14
  • Wrapped components in Suspense boundaries
  • Dynamic imports for client components
  • Improved hydration handling
  • Layout component restructuring for better SSR

Fixed

  • Error boundary for Dynasty feature in ModeToggle
  • SEOLinks wrapped in Suspense to prevent SSR bailout
  • HexagramViewTracker SSR compatibility

2025-10-19 — v2-iconic Image System & Build Cleanup

Added

  • Multi-reference image compositing support in imageGenerationService.ts
  • Batch image processing system with manifest-based tracking
  • Image archiving before regeneration (public/images/processed-archive/)

Changed

  • v2-iconic hexagrams now use processed images (6 active hexagrams)
  • Hex 22: Heavy Metal Magazine (Sorayama chrome fembot)
  • Hex 24: Gunship Synthwave Revival
  • Hex 42: Legend of the Red Dragon (LORD BBS)
  • Hex 43: Apple 1984 Commercial (regenerated with multi-image composite)
  • Hex 51: Joy Division Unknown Pleasures (regenerated with stronger tech-noir)
  • Hex 59: Star Trek Transporter
  • Updated hexagramImages.ts with absolute paths to processed images
  • Enhanced metadata and alt text for all v2-iconic variants

Fixed

  • Regenerated Joy Division image with phosphor green transformation
  • Regenerated Apple 1984 using multi-image composite (Big Brother + woman with hammer)
  • Removed stale TypeScript build artifacts (.js files in src/)
  • Updated .gitignore to prevent future build artifact accumulation

2025-10-10 — WhatsApp OG Images & SEO Schema

Added

  • Static OG Image Generation - Pre-generated images for WhatsApp compatibility
  • File-based metadata using Next.js opengraph-image.tsx convention
  • All 256 images (64 hexagrams × 4 locales) generated at build time
  • SEO Schema Markup - Comprehensive structured data
  • Organization, WebSite, WebApplication schemas
  • Article and BreadcrumbList for content pages
  • Hreflang support for multi-language SEO
  • Hexagram Versioning System - Support for v1/v2-iconic variants

Changed

  • Optimized font loading in OG image routes
  • Enhanced hexagram page metadata for SEO
  • Git-based lastModified timestamps in sitemap

Fixed

  • OG image text layout for long hexagram meanings
  • Edge Runtime font loading with import.meta.url
  • OpenGraph metadata for social sharing

2025-10-01 — Component Refactoring

Changed

  • DivinationGrid Refactoring - Extracted into focused hooks and components
  • useGroupRoomSetup - Room lifecycle and real-time setup
  • useParticipantDisplayItems - Participant display computation
  • ParticipantsList, ReadingPanel - Focused UI components
  • DivinationPageClient Refactoring - Improved composability
  • Documented isHydrated flag implementation for auth state

Fixed

  • Black screen pitfall with isHydrated flag in auth transitions

2025-09-20 — Group Divination Stability

Added

  • Chinese Simplified (zh-CN) - Full locale support
  • Admin-protected debug API for AI response times

Changed

  • English-only generation with on-demand language translation
  • Updated model configurations in openRouterService
  • Expanded language support in group divination

Fixed

  • Yin yang button stuck in disabled state after casting
  • Group divination resilience with exponential backoff
  • Timeout handling for Matrix overlay
  • Locale-specific model selection

2025-09-01 — Foundation

Added

  • Memory system architecture documentation
  • Claude Code sessions system integration

Changed

  • Removed 8+ major unused dependencies
  • Updated FFmpeg and other dependency cleanup