feat(Cycle #51): Chapter Auction House + Live Broadcast Page

[Eli5DeFi]

Overview

Production-ready implementation of two Innovation Cycle #51 features:

1. Chapter Auction House (CAH) — the highest-impact unimplemented Cycle [Innovation Cycle #53]: The Living Story Protocol #51 feature
2. Live Narrative Broadcast Page — connects existing LiveNarrativeStudio to a proper route

---

🏛️ Feature 1: Chapter Auction House (CAH)

Every 10th Voidborne chapter is a 'Blank Chapter' auctioned to the highest bidder. The winner earns narrative authorship rights, a Patron NFT, and 10% of all bets placed on their chapter.

API Routes

Method	Route	Description
GET	/api/auction	List all auctions + summary stats
GET	/api/auction/[chapterId]	Single auction detail (time remaining, min bid)
POST	/api/auction/[chapterId]/bid	Place a bid (5% min raise rule enforced)

Pages

Route	Description
/auction	Auction House listing (ISR 30s)
/auction/[chapterId]	Full detail view (ISR 15s, SSG params)

Components

apps/web/src/components/auction/
├── AuctionCard.tsx          — compact listing card with live glow for active auctions
├── AuctionCountdown.tsx     — urgency-aware live timer (green → amber → red → CRITICAL)  
├── AuctionBidForm.tsx       — wallet-connected bid flow (approval → bid → success)
├── AuctionContent.tsx       — listing page client wrapper (30s polling)
├── AuctionDetailContent.tsx — full detail: bid history, winner parameters, revenue
├── PatronParameters.tsx     — winner's configuration modal (genre, house, twist)
└── index.ts                 — barrel export

Data Layer

apps/web/src/lib/auction-data.ts  — shared types + mock data

Seeded with 6 auctions: Ch10, Ch20, Ch30 (settled), Ch40 (won), Ch50 (active 🔴), Ch60 (upcoming).

Auction Mechanics

• Starting bid: 1,000 USDC
• Minimum raise: 5% above current bid
• Duration: 48 hours per auction
• Winner rights: Genre + House spotlight + Twist + optional custom notes
• Patron NFT: minted on Base post-chapter
• Revenue share: 10% of all chapter bets → patron address

---

🔴 Feature 2: Live Narrative Broadcast Page

/live — Wraps the existing LiveNarrativeStudio.tsx (Innovation Cycle #51, already built) in a proper Next.js page with:

• Live status indicator bar with viewer count + pool size
• Full SEO metadata (OG + Twitter cards)
• Context footer (story arc, how betting works, next broadcast)
• Cross-link to the active Chapter 50 auction

---

Navbar Updates

Added two new nav links:

• 🔴 Live → /live
• Auction House 🏛 → /auction

---

Bug Fixes

• LiveNarrativeStudio.tsx: Fixed 2 pre-existing TS2352 type assertion errors

---

Testing

• TypeScript compiles (0 errors: npx tsc --noEmit)
• Next.js build passes (npm run build — clean, pre-existing warnings only)
• Mobile responsive (grid → single column on sm screens)
• Loading skeletons on all async components
• Error boundaries with retry on all data-fetching components
• ISR configured (30s auction list, 15s detail page)
• generateStaticParams for auction detail pages (Ch10, 20, 30, 40, 50, 60)
• Wallet-disconnected state handled gracefully in bid form

Documentation

• Types fully documented with JSDoc
• Data layer isolated to auction-data.ts (ready for DB migration)
• API routes include production upgrade notes (contract + Prisma refs)

Deployment Notes

To go fully production:

1. Add AuctionHouse Solidity contract (inherits CombinatorialPool pattern)
2. Replace MOCK_AUCTIONS in auction-data.ts with Prisma queries
3. Add ChapterAuction + AuctionBid tables to packages/database schema
4. Set Redis pub/sub for real-time bid updates (replace 30s polling)
5. Wire AuctionBidForm to useWriteContract for on-chain bid settlement
6. Add /api/auction/[chapterId]/configure for winner parameter submission

Screenshots

/auction (Auction House listing)

• Hero banner with live stats
• Active auction card (Chapter 50) with gold glow + countdown
• Historical auction grid with patron details

/auction/50 (Active auction detail)

• Left: Stats, countdown, bid history
• Right (sticky): Wallet-connected bid form

/live (Live Broadcast)

• Full LiveNarrativeStudio with context footer