Frontend Routes and Feature Map

This document maps the primary UI routes in aragora/live to their purpose and related documentation. It is the canonical map for the user-facing surface area.

Canonical UI Domains

• https://aragora.ai serves the live dashboard.
• https://www.aragora.ai serves the marketing landing page.

Local development uses http://localhost:3000 with NEXT_PUBLIC_API_URL and NEXT_PUBLIC_WS_URL from .env.local.

Core Debate Surfaces

• / - Live dashboard (streaming debate view, panels, and controls). Landing page when hosted on www.aragora.ai.
  • Related docs: GETTING_STARTED, FEATURES, WEBSOCKET_EVENTS
• /debate/[id] - Live/archived debate viewer with streaming transcript and metadata.
  • Related docs: DEBATE_PHASES, WEBSOCKET_EVENTS
• /debates - Debate archive list with filtering and sharing links.
  • Related docs: API_USAGE, CLI_REFERENCE
• /debates/graph - Graph debate browser for counterfactual branching.
  • Related docs: GRAPH_DEBATES
• /debates/matrix - Scenario matrix runner and comparison grid.
  • Related docs: MATRIX_DEBATES
• /deliberations - Control plane vetted decisionmaking dashboard and live status.
  • Related docs: CONTROL_PLANE, CONTROL_PLANE_GUIDE
• /gauntlet/[id] - Live gauntlet run viewer (adversarial stress-test).
  • Related docs: GAUNTLET, GAUNTLET_ARCHITECTURE
• /replays - Replay browser to review historical debates and fork at checkpoints.
  • Related docs: API_USAGE, FEATURES
• /reviews - Shareable multi-agent code reviews and consensus summaries.
  • Related docs: CLI_REFERENCE, INDEX
• /code-review - Guided code review workspace with review templates.
  • Related docs: CODING_ASSISTANCE, GITHUB_PR_REVIEW
• /control-plane - Control plane dashboard (agents, queue, vetted decisionmaking sessions).
  • Related docs: CONTROL_PLANE, CONTROL_PLANE_GUIDE

Analysis, Insights, and Memory

• /insights - Pattern analysis, position flips, and learning metrics dashboard.
  • Related docs: FEATURES, MEMORY_ANALYTICS
• /evidence - Evidence and dissent explorer for rebuttals, warnings, and audit trails.
  • Related docs: TRICKSTER, FEATURES
• /memory - Continuum memory explorer (fast/medium/slow/glacial tiers).
  • Related docs: MEMORY_STRATEGY, MEMORY_ANALYTICS
• /pulse - Pulse scheduler for automated trending-topic debates.
  • Related docs: PULSE
• /repository - Repository indexing and knowledge graph explorer.
  • Related docs: KNOWLEDGE_MOUND, ARCHITECTURE
• /security-scan - Codebase security scans and dependency intelligence.
  • Related docs: CODEBASE_ANALYSIS
• /audit - Audit dashboard for sessions, findings, and exports.
  • Related docs: API_REFERENCE, SECURITY_RUNTIME
• /audit/[id] - Audit session detail view (findings, events, report export).
  • Related docs: API_REFERENCE
• /audit/new - Launch a new audit session.
  • Related docs: API_REFERENCE
• /audit/templates - Audit templates and presets.
  • Related docs: GAUNTLET, FEATURES
• /network - Agent relationship network visualization.
  • Related docs: FEATURES, AGENT_SELECTION
• /tournaments - Agent tournaments and rankings dashboard.
  • Related docs: FEATURES, AGENT_SELECTION
• /agents - Agent recommender and leaderboard explorer.
  • Related docs: AGENT_SELECTION
• /agent/[name] - Individual agent profile with stats and comparisons.
  • Related docs: AGENT_DEVELOPMENT, AGENT_SELECTION

Experimentation and Governance

• /laboratory - Persona laboratory (emergent traits, pollinations, evolution, patterns).
  • Related docs: EVOLUTION_PATTERNS, AGENT_DEVELOPMENT
• /evolution - Evolution dashboard for genetic optimization and breeding.
  • Related docs: GENESIS, EVOLUTION_PATTERNS
• /ab-testing - A/B test management for prompt/evolution variants.
  • Related docs: A_B_TESTING
• /breakpoints - Human-in-the-loop approvals triggered by Trickster breakpoints.
  • Related docs: TRICKSTER, API_REFERENCE
• /verification - Formal verification workspace (Z3 and Lean4 proofs).
  • Related docs: FORMAL_VERIFICATION
• /batch - Batch debate submission and monitoring.
  • Related docs: WORKFLOWS, CLI_REFERENCE
• /plugins - Plugin marketplace and integration manager.
  • Related docs: PLUGIN_GUIDE, MCP_INTEGRATION

Account, Org, and Billing

• /auth/login - Login UI (email/password + OAuth).
  • Related docs: SECURITY, SSO_SETUP
• /auth/register - Registration UI.
  • Related docs: SECURITY
• /developer - Developer portal for API key management and usage stats.
  • Related docs: SDK_GUIDE, SDK_TYPESCRIPT
• /settings - User preferences, integrations, and API configuration.
  • Related docs: ENVIRONMENT, INTEGRATIONS
• /inbox - AI smart inbox with prioritization and Gmail/Outlook sync.
  • Related docs: EMAIL_PRIORITIZATION
• /command-center - Unified inbox command center for quick actions.
  • Related docs: EMAIL_PRIORITIZATION
• /shared-inbox - Shared inbox dashboard for team triage and routing rules.
  • Related docs: SHARED_INBOX, EMAIL_PRIORITIZATION
• /accounting - QuickBooks accounting dashboard.
  • Related docs: API_REFERENCE, BILLING
• /organization - Organization profile settings (name, tier, limits).
  • Related docs: BILLING, SSO_SETUP
• /organization/members - Member invites, roles, and removal.
  • Related docs: BILLING, SSO_SETUP
• /pricing - Plan and pricing page.
  • Related docs: BILLING
• /billing - Subscription management portal.
  • Related docs: BILLING, STRIPE_SETUP
• /billing/success - Post-checkout confirmation.
  • Related docs: BILLING
• /costs - Cost visibility dashboard (usage, budgets, alerts).
  • Related docs: COST_VISIBILITY, BILLING
• /api-explorer - Interactive API explorer for live endpoint testing.
  • Related docs: API_REFERENCE, API_ENDPOINTS
• /admin - Admin console for system health, rate limits, and diagnostics.
  • Related docs: OPERATIONS, RUNBOOK

Informational

• /about - Product overview, Nomic loop explanation, and links.
  • Related docs: ARCHITECTURE, NOMIC_LOOP