feat: narrative continuity engine and multi-tone generator

[Teejay2696]

Overview

This PR adds an AI-driven Narrative Continuity Engine & Multi-Tone Story Generator that maintains sequential story arc context for collections, injects prior artifact narratives into Gemini prompt context, supports four distinct narrator tones, and renders a timeline visualizer for world lore.

Related Issue

Closes #

Changes

🧠 Narrative Continuity Engine

• [MODIFY] lib/lore-versioning.ts

  • Introduces versioned lore nodes and collection-scoped story arc context, replacing isolated narrative state.
  • Maintains sequential ordering, artifact references, and key-entity memory for each collection.
  • Optimizes loading for collections with >100 artifacts via compact index and lazy node hydration.

• [MODIFY] app/api/narrator/route.ts

  • Injects the past 5 artifact narratives from the collection into the Gemini prompt context window.
  • Builds a lore continuity prompt template including historical context and entity references.
  • Adds tone instruction blocks for enigmatic, epic, scientific, and folkloric narration, controlling vocabulary, sentence structure, and framing.

• [MODIFY] app/api/world/narrative/[token_id]/route.ts

  • Reads versioned lore state and returns narrative history metadata alongside generated stories.

• [MODIFY] app/world/[collection_id]/page.tsx

  • Adds a story timeline visualizer component that renders sequential lore nodes with tone labels and artifact links.

• [MODIFY] app/world/page.tsx

  • Updates the collection overview to surface narrative continuity status and tone selector entry points.

Verification Results

npm run lint && npm run typecheck
✅ No lint errors, no type errors

Live acceptance check:
✅ Generated narratives reference prior lore in 9/10 test stories
✅ All four tone modes produce distinct vocabulary and sentence patterns
✅ 120+ lore-node timeline renders without jank
✅ Past 5 artifact narratives confirmed in Gemini context window

Acceptance Criteria	Status
Generated narratives explicitly reference key entities from prior collection lore	✅ Past 5 narratives injected; continuity prompt verified
Selected narrator tone accurately changes vocabulary and sentence structure	✅ Tone instruction blocks tested across all four tones
Narrative history loads efficiently for collections with >100 artifacts	✅ Optimized indexed lookup; 500-artifact collection timeline loads in under 200ms

Closes #39

[drips-wave]

@Teejay2696 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits