[Feature]: House Agent Protocol UI — Autonomous AI Agents Dashboard

[Eli5DeFi]

Summary

Implements the full production frontend for the House Agent Protocol (HAP) from Innovation Cycle #50 — The Autonomous Character Economy.

Five autonomous AI agents — one per House — hold real wallets and bet on every chapter aligned with their House ideology. Players can align (earn 20% of winnings) or declare rivalry (earn 10% on agent losses). This creates a daily content drama loop: House Obsidian bet 1,200 USDC against the crowd AGAIN. They lost. → Twitter content machine.

---

What's Shipped

API Routes

Route	Method	Description
/api/house-agents	GET	All 5 agents + aggregate stats. ISR 60s.
/api/house-agents/:id/align	POST	Align or rival a house (wallet-gated)
/api/house-agents/:id/align	GET	Alignment stats for a house

Data is mock (realistic) — pending DB schema migration for house_agent_alignments table.

Components (7 new in /components/house-agents/)

Component	Purpose
HouseAgentsContent	Client wrapper, auto-refresh every 60s
HouseAgentCard	Agent card: personality, stats, live bet, history expand
PersonalityBars	Animated 5-dim personality matrix (risk / contrarianism / survival / memory / bluff)
AlignmentModal	Wallet-gated Align vs Rival modal with reward breakdown
RivalryMatrix	5×5 inter-house rivalry heatmap (color-coded by intensity)
AgentLeaderboard	Ranked by Net PnL, live-bet indicators
index.ts	Barrel export

Page

• /house-agents — New page with hero section, platform stats, card grid (responsive 1→2→3 col), rivalry matrix, leaderboard

Navigation

• Added House Agents ⚔ to Navbar.tsx (desktop + mobile)

---

Architecture Decisions

• ISR 60s + client 60s polling — Near real-time agent updates without hammering server
• Dynamic import — Heavy client content lazy-loaded, page skeleton shown instantly
• Mock data in API route — Easy to swap for real DB calls once schema is ready
• Wallet-gated alignment — Uses useAccount() wagmi hook, ConnectWallet fallback built in

---

Testing

• TypeScript compiles — 0 errors (npx tsc --noEmit)
• Next.js build succeeds — exit code 0
• /house-agents page included in build at 7.11 kB (725 kB total)
• API routes registered: /api/house-agents ✓ /api/house-agents/[houseId]/align ✓
• Mobile responsive (1-col on mobile, 2-col on md, sidebar on xl)
• Error states handled (API failure, wallet not connected)
• Loading states present (spinner, skeleton)

---

DB Migration Needed (post-merge)

For live data, add these tables:

-- House agent bet history
CREATE TABLE house_agent_bets (
  id           TEXT PRIMARY KEY,
  house_id     TEXT NOT NULL,
  chapter_id   TEXT NOT NULL,
  choice_id    TEXT NOT NULL,
  amount_usdc  DECIMAL(18,2) NOT NULL,
  reasoning    TEXT,
  placed_at    TIMESTAMPTZ DEFAULT now(),
  resolved     BOOLEAN DEFAULT false,
  won          BOOLEAN,
  payout_usdc  DECIMAL(18,2)
);

-- Player alignments / rivalries
CREATE TABLE house_agent_alignments (
  wallet_address TEXT NOT NULL,
  house_id       TEXT NOT NULL,
  is_rival       BOOLEAN DEFAULT false,
  reward_rate    DECIMAL(5,4) DEFAULT 0.20,
  aligned_at     TIMESTAMPTZ DEFAULT now(),
  active_until   TIMESTAMPTZ,
  PRIMARY KEY (wallet_address, house_id)
);

---

Screenshots

Live at /house-agents after deploy.

Features visible:

• 5 House Agent cards with personality bars + live bet banners
• Rivalry matrix heatmap (Valdris vs Obsidian = Mortal 88)
• Agent leaderboard ranked by Net PnL
• Align / Rival modal with reward breakdown
• Nav link in header