feat: Narrative Guilds & Faction Wars UI — Innovation Cycle #52#49
Open
feat: Narrative Guilds & Faction Wars UI — Innovation Cycle #52#49
Conversation
Complete production implementation of the Prophecy NFT system: ## Database - Add Prophecy model (sealed prophecies per chapter, max 100 mints each) - Add ProphecyMint model (one per user per prophecy, mint order 1-100) - Add ProphecyStatus enum: PENDING | FULFILLED | ECHOED | UNFULFILLED - SQL migration: 20260218_prophecy_nft - Regenerated Prisma client (0 TypeScript errors) ## API Routes (4 new endpoints) - GET/POST /api/prophecies — list all / seed new (oracle) - GET/PATCH /api/prophecies/[chapterId] — chapter gallery + fulfill - GET/POST /api/prophecies/mint — user mints + oracle pack - GET /api/prophecies/leaderboard — oracle rankings ## Components (6 new) - ProphecyCard — NFT card with status-based art (dark/silver/golden) - ProphecyGallery — filterable chapter gallery with sort - ProphecyMintModal — full mint flow (single + oracle pack 10% discount) - ProphecyRarityBadge — rarity tier indicator (COMMON → MYTHIC) - ProphecyBanner — compact story sidebar teaser with progress bar - OracleLeaderboard — top collectors ranked by fulfilled prophecy count ## Pages (2 new) - /prophecies — global gallery with leaderboard sidebar - /prophecies/[chapterId] — chapter-specific gallery + My Mints ## Integrations - Navbar: added 'Prophecies ✦' link - Story page: ProphecyBanner injected in sidebar above betting interface ## Documentation - docs/PROPHECY_NFT_SYSTEM.md — full API, migration, and seeding guide Closes Innovation Cycle #49 Week 1-6 priority (Prophecy NFTs)
… pages - next.config.js: add Web3 fallbacks, scrollRestoration, AVIF-first images, per-route cache headers, remove duplicate .mjs config - Leaderboards page: dynamic import with skeleton loader (better FCP/TTI) - Lore dynamic pages: add force-dynamic + ISR fetch revalidate (300s) - API routes: in-memory cache (5min TTL) for stories, houses, protocols, leaderboards - API routes: add force-dynamic where request.url/searchParams used - Dashboard: 285kB → 272kB (-4.6%), Lore: 242kB → 229kB (-5.4%)
5 breakthrough innovations for Voidborne: 1. House Agent Protocol (HAP) — 5 autonomous AI agents with real wallets 2. Narrative DNA Engine (NDE) — 12-dim betting pattern personalization 3. Sage Staking Protocol (SSP) — Skill-as-asset tier system with Wisdom Pool 4. Story Parameter Markets (SPM) — Continuous narrative attribute markets 5. Cross-Story Universe Bridge (CUB) — Parallel universe story expansion POC: 3 TypeScript modules (house-agents.ts, narrative-dna.ts, sage-protocol.ts) Revenue potential: $7.19M/year by Year 5 Combined moat: 270 months
Implements the full frontend for the House Agent Protocol (HAP) from Innovation Cycle #50 — The Autonomous Character Economy. ## What's New ### API Routes - GET /api/house-agents — All 5 House Agents + aggregate stats (ISR 60s) - POST /api/house-agents/:id/align — Align or rival a House Agent (wallet-gated) - GET /api/house-agents/:id/align — Alignment stats for a house ### Components (7 new) - HouseAgentsContent — Main client wrapper with auto-refresh (60s polling) - HouseAgentCard — Individual agent card with personality, stats, live bet, history - PersonalityBars — Animated 5-dim personality matrix bars (risk/contrarian/survival/memory/bluff) - AlignmentModal — Wallet-gated modal for Align (+20% yield) or Rival (+10% on loss) - RivalryMatrix — 5x5 inter-house rivalry heatmap - AgentLeaderboard — Ranked sidebar by Net PnL with live bet indicators - index.ts — Component barrel ### Page - /house-agents — New page with hero, stat bar, card grid, rivalry matrix, leaderboard ### Navigation - Added 'House Agents ⚔' link to Navbar (desktop + mobile) ## Design Decisions - All mock data in API route (DB tables pending schema migration) - ISR 60s + client-side 60s polling for near-real-time agent updates - Dynamic import for main content block (keeps page lightweight) - Follows Ruins of the Future design system (Cinzel font, gold/void palette, glass-card) - TypeScript strict: 0 errors - Next.js build: exit code 0, page bundles at 7.11 kB / 725 kB total
5 innovations: Live Narrative Broadcast, Betrayal Protocol, Chapter Auction House, Temporal Oracle Markets, Narrative Resonance Index. POC files: - packages/agent-sdk/src/live-narrative-broadcast.ts (LNB engine, SSE streaming, betting windows) - packages/agent-sdk/src/betrayal-protocol.ts (social deduction layer, stitcher assignment, revelation) - packages/agent-sdk/src/temporal-markets.ts (long-range markets, horizon multipliers, AI oracle) - apps/web/src/app/api/stream/chapter/route.ts (SSE API endpoint) - apps/web/src/components/LiveNarrativeStudio.tsx (React UI for live broadcasts) Revenue potential: $10.71M Year-5 | Combined moat: 216 months
…ycle #51 ## Chapter Auction House (Innovation Cycle #51, CAH) Every 10th chapter is a 'Blank Chapter' auctioned to the highest bidder. Winner earns narrative authorship rights + Patron NFT + 10% of all bets. ### API Routes - GET /api/auction — list all auctions with summary stats - GET /api/auction/[chapterId] — single auction with time/bid details - POST /api/auction/[chapterId]/bid — place a bid (5% minimum raise rule) ### UI Components (apps/web/src/components/auction/) - AuctionCard.tsx — compact card (active glow, countdown, status) - AuctionCountdown.tsx — live timer with urgency states (critical/warning) - AuctionBidForm.tsx — wallet-connected bid form with approval flow - AuctionContent.tsx — listing page client wrapper (30s polling) - AuctionDetailContent.tsx — full detail view with bid history + winner form - PatronParameters.tsx — genre/house/twist picker for auction winners ### Pages - /auction — Auction House listing (ISR 30s) - /auction/[chapterId] — Single auction detail (ISR 15s, SSG params) ### Data Layer - src/lib/auction-data.ts — shared types + mock data (replace with Prisma) ## Live Narrative Broadcast Page - /live — wraps LiveNarrativeStudio.tsx with proper page layout + metadata ## Bug Fixes - LiveNarrativeStudio.tsx: fix TS2352 type assertion errors (as unknown as T) ## Navbar - Added '🔴 Live' and 'Auction House 🏛' links to nav ## Quality - TypeScript: 0 errors - Next.js build: ✅ clean (pre-existing warnings only) - Mobile responsive: grid → single col on small screens - Design system: Ruins of the Future palette (gold, void-*, drift-*) - Error boundaries + loading skeletons on all async components - ISR + cache: no-store for client polls, 15-30s revalidation for ISR
## Performance - Fix new PrismaClient() anti-pattern in trending/recent/platform-stats routes - Was creating a new DB connection pool on EVERY serverless invocation - Now use shared prisma singleton from @voidborne/database - Eliminates connection exhaustion under load - Add 15s in-memory + CDN caching to betting/pools/[poolId] (most-hit endpoint) - Open pools: 15s cache / stale-while-revalidate=30 - Resolved/closed pools: 5min cache (stable data) - Rewrite getWeeklyChampions: JS aggregation → single DB GROUP BY - Was: SELECT all winning bets → JS Map reduce → N+1 user fetch - Now: Single SQL JOIN+GROUP BY returns ranked rows in one query ## Security - Fix SQL injection in platform-stats/route.ts - Was: timeframeCutoff interpolated directly into $queryRawUnsafe - Now: parameterized $queryRaw with typed Date parameter ## Bug Fixes - Fix walletAddress vs userId mismatch in betting/place route - Frontend sends walletAddress; route expected userId (silent failure) - Route now accepts walletAddress, upserts user, resolves userId correctly ## UX / Frontend - Hero.tsx: remove mounted guard causing CLS on first paint - No wallet/hydration-sensitive state in Hero; guard was unnecessary - Navbar: replace <a> with Next.js <Link> across all nav items - <a> was triggering full-page reloads instead of SPA navigation - Navbar: add passive: true to scroll event listener (less main-thread work) - Navbar: memoize scroll handler with useCallback - BettingInterface: memoize countdown timer with useCallback - BettingInterface: add ARIA label + aria-describedby to bet input ## Code Quality - Replace console.error/warn/log with logger utility across 37 API routes - logger silences debug output in production while keeping error/warn - next.config.js: add @tanstack/react-query to optimizePackageImports - next.config.js: add optimisticClientCache for faster perceived navigation - Remove unused imports (useState in Hero)
Introduces 5 new innovations that transform Voidborne from a prediction market into a living narrative civilization: 1. Narrative Guilds & Faction Wars — player factions aligned to story Houses, collective treasury betting, 6-sector Void Map territory control, war declaration/resolution, War Trophy NFTs, and Agenda Injection (winner injects narrative directive into Claude prompt) 2. AI Style Oracle — bid USDC to set narrator personality before each chapter; winner earns 8% of all chapter bets as Chapter Patron 3. Prophet Lineage System — on-chain knowledge propagation; root prophets earn 2% of follower wins forever; Void Prophet rank = lore canonization 4. Void Mirror Protocol — player betting behavior generates AI Shadow Self character; top 10 Shadows become canonical story lore entries 5. Fragment Hunt Protocol — 7 chapter fragments distributed cross-platform pre-release; collectors earn Early Access NFT + 1.15x bet multiplier POC: packages/agent-sdk/src/guild-faction-engine.ts (870+ lines) - GuildRegistry: create/join guilds, tier system, max 50 members - GuildTreasuryManager: collective betting, 70/20/10 yield distribution - VoidMapController: 6 sectors, territory tracking, SVG map generation - FactionWarEngine: war declaration, chapter scoring, trophy NFT minting - GuildLeaderboard: monthly scoring, rank computation - AgendaInjector: Claude prompt enrichment with winning guild's agenda - NarrativeGuildEngine: master orchestrator with chapter resolution Revenue projection: $12.83M Year-5 (cumulative target: $80.23M) New competitive moat: 234 months Docs: INNOVATION_CYCLE_52_FEB_19_2026.md (16KB full spec) Social: INNOVATION_CYCLE_52_TWEET.md (7 platforms) Do NOT merge — pending manual review.
- /guilds — directory page with filter/sort toolbar, platform stats bar, Void Territory Map sidebar, monthly leaderboard, and guild card grid - /guilds/create — 3-step guild creation flow (house picker → name/tag/desc → review+submit) - /guilds/[guildId] — full guild detail with hero banner, war history, treasury stats, top bets, territory VoidMap, member roster, and join CTA - 3 API routes: GET /api/guilds, GET /api/guilds/[guildId], POST /api/guilds/[guildId]/join - POST /api/guilds for guild creation with validation - VoidMap SVG territory visualization component (6 sectors, house colors, yield badges) - GuildCard compact tile with tier badge, stats grid, house color stripe - GuildLeaderboard with animated score bars and season timer - Shared types/constants extracted to @/lib/guilds.ts - Navbar updated with Guilds ⚔️ link - TypeScript: 0 errors, Next.js build: ✓ all routes
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
🏰 Narrative Guilds & Faction Wars — Full Frontend
Innovation Cycle #52
guild-faction-engine.tsPOC existed with 870+ lines of engine logic but had zero UI. This PR ships the complete frontend.Changes
📄 Pages (3 new routes)
/guilds/guilds/create/guilds/[guildId]🔌 API Routes (4 endpoints)
/api/guilds/api/guilds/api/guilds/[guildId]/api/guilds/[guildId]/join🧩 Components (6 new)
GuildCardVoidMapGuildLeaderboardGuildsContentGuildDetailContentCreateGuildForm📚 Shared Lib
src/lib/guilds.ts— All types (HouseAlignment,GuildPublicProfile,GuildDetailProfile, etc.) +HOUSE_METAextracted so route files stay clean🧭 Navbar
Feature Highlights
🗺 Void Territory Map
SVG hexagonal grid showing all 6 sectors with:
highlightGuildIdprop to focus one guild's territory on detail page🏆 Tiered Guild System
5 tiers: Ember → Iron → Silver → Gold → Void
Each with distinct border/badge styles, progressive visual weight
👑 Agenda Holder Banner
The #1-ranked guild's
agendastring displays as a golden banner on both the guild detail page AND the guilds directory — showing exactly what narrative directive they've injected into Claude's chapter prompt3-Step Guild Creation
Architecture Notes
Mock data pattern mirrors
/api/house-agents— rich mock data with documented interfaces, ready to swap for real Prisma queries once DB migration addsguilds,guild_members,faction_wars, andterritory_controltables.ISR strategy:
/guilds→revalidate = 60(directory changes slowly)/guilds/[guildId]→revalidate = 30(member activity more frequent)dynamic(..., { ssr: false })Testing
Documentation
src/lib/guilds.tsDeployment Notes
No environment changes needed. No DB migration required (mock data). Works with existing Vercel/Railway setup.
To connect real data: Add Prisma models for
Guild,GuildMember,FactionWar,TerritoryControland replace mock arrays in route files with Prisma queries.