Add interactive demo scripts for exploring persona responses

New Features:
- demo_interactive.py: Full-featured interactive demo with multiple modes
* Quick demo (1 question, all personas)
* Full demo (4 preset questions)
* Custom questions (user input)
* Compare mode (2 personas side-by-side)
- quick_demo.py: Simple script for rapid testing with any question

Both scripts demonstrate the system's ability to generate diverse
stakeholder perspectives on urban planning issues.

Usage:
python demo_interactive.py # Interactive menu-driven experience
python quick_demo.py # Simple question prompt

Tested successfully with questions about food trucks, community gardens,
and other urban planning scenarios. Shows authentic persona responses
with clear value differences across stakeholders.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

demo_interactive.py

@@ -0,0 +1,221 @@
+"""
+Interactive Demo: AI Personas for Urban Planning
+
+This script demonstrates the system with interesting questions
+and shows how different stakeholders respond.
+"""
+
+import sys
+from pathlib import Path
+sys.path.insert(0, str(Path(__file__).parent))
+
+from src.pipeline.query_engine import QueryEngine
+from rich.console import Console
+from rich.panel import Panel
+from rich.prompt import Prompt, Confirm
+from rich.table import Table
+
+console = Console()
+
+
+def show_personas(engine):
+    """Display available personas in a nice table"""
+    personas = engine.list_available_personas()
+
+    table = Table(title="🏙️  Your Urban Planning Stakeholders", show_header=True, header_style="bold cyan")
+    table.add_column("#", style="dim", width=3)
+    table.add_column("Name", style="green", width=20)
+    table.add_column("Role", style="yellow", width=25)
+    table.add_column("Perspective", style="white")
+
+    descriptions = [
+        "Progressive, sustainability-focused",
+        "Pragmatic, economy-focused",
+        "Data-driven, safety-first",
+        "Traditional, community-protective",
+        "Activist, equity-focused",
+        "Market-driven, growth-oriented"
+    ]
+
+    for i, (persona_id, name, role) in enumerate(personas, 1):
+        table.add_row(str(i), name, role, descriptions[i-1])
+
+    console.print("\n")
+    console.print(table)
+    console.print("\n")
+
+
+def ask_question(engine, question, persona_ids=None):
+    """Ask a question to one or more personas"""
+    console.print(Panel(
+        f"[bold cyan]Question:[/bold cyan]\n{question}",
+        border_style="cyan"
+    ))
+    console.print()
+
+    if persona_ids is None:
+        # Ask all personas
+        persona_ids = [p[0] for p in engine.list_available_personas()]
+
+    console.print(f"[dim]Querying {len(persona_ids)} persona(s)...[/dim]\n")
+
+    responses = engine.query_multiple(
+        persona_ids=persona_ids,
+        question=question,
+        context_id="downtown_district"
+    )
+
+    for i, response in enumerate(responses, 1):
+        console.print(f"[bold green]━━━ {i}. {response.persona_name}[/bold green] [dim]({response.persona_role})[/dim] [bold green]━━━[/bold green]")
+        console.print()
+        console.print(response.response)
+        console.print("\n")
+
+    return responses
+
+
+def main():
+    console.print("\n")
+    console.print("╔═══════════════════════════════════════════════════════════════════╗", style="bold cyan")
+    console.print("║        🏙️  AI Personas for Urban Planning - Demo Session        ║", style="bold cyan")
+    console.print("╚═══════════════════════════════════════════════════════════════════╝", style="bold cyan")
+    console.print()
+
+    # Initialize
+    console.print("[dim]Initializing system...[/dim]")
+    engine = QueryEngine()
+
+    if not engine.test_system():
+        console.print("[red]System initialization failed![/red]")
+        return
+
+    console.print("[green]✓ System ready![/green]")
+
+    # Show personas
+    show_personas(engine)
+
+    # Demo questions
+    questions = [
+        {
+            "q": "Should we allow food trucks in the downtown plaza?",
+            "desc": "A simple yes/no question with complex stakeholder implications"
+        },
+        {
+            "q": "The city is considering a $100M affordable housing bond. What's your opinion?",
+            "desc": "A major policy decision with fiscal and social dimensions"
+        },
+        {
+            "q": "What's the most important issue facing our downtown right now?",
+            "desc": "An open-ended question showing different priorities"
+        },
+        {
+            "q": "How would you improve public transit in the city?",
+            "desc": "Solution-oriented question revealing different approaches"
+        },
+    ]
+
+    console.print("[bold]Choose your adventure:[/bold]")
+    console.print()
+    console.print("  [cyan]1[/cyan] - Quick demo (1 question, all stakeholders)")
+    console.print("  [cyan]2[/cyan] - Full demo (4 questions, showing diverse perspectives)")
+    console.print("  [cyan]3[/cyan] - Custom question (you choose)")
+    console.print("  [cyan]4[/cyan] - Compare two personas (see contrasting views)")
+    console.print()
+
+    choice = Prompt.ask("Your choice", choices=["1", "2", "3", "4"], default="1")
+    console.print()
+
+    if choice == "1":
+        # Quick demo
+        console.print("[bold cyan]═══ QUICK DEMO ═══[/bold cyan]\n")
+        ask_question(engine, questions[0]["q"])
+
+    elif choice == "2":
+        # Full demo
+        console.print("[bold cyan]═══ FULL DEMO ═══[/bold cyan]\n")
+        for i, q_info in enumerate(questions, 1):
+            console.print(f"\n[bold yellow]Question {i}/4:[/bold yellow] [dim]{q_info['desc']}[/dim]\n")
+            ask_question(engine, q_info["q"])
+
+            if i < len(questions):
+                if not Confirm.ask("\n[cyan]Continue to next question?[/cyan]", default=True):
+                    break
+                console.print("\n" + "─" * 70 + "\n")
+
+    elif choice == "3":
+        # Custom question
+        console.print("[bold cyan]═══ CUSTOM QUESTION ═══[/bold cyan]\n")
+        console.print("[dim]Ask the personas anything about urban planning![/dim]")
+        console.print("[dim]Examples: parking policies, green spaces, housing, transit, development, etc.[/dim]\n")
+
+        question = Prompt.ask("[cyan]Your question[/cyan]")
+        console.print()
+
+        ask_all = Confirm.ask("Ask all 6 personas?", default=True)
+
+        if ask_all:
+            ask_question(engine, question)
+        else:
+            show_personas(engine)
+            persona_choice = Prompt.ask("Which persona? (1-6)", choices=["1","2","3","4","5","6"])
+            persona_map = {
+                "1": "sarah_chen",
+                "2": "marcus_thompson",
+                "3": "elena_rodriguez",
+                "4": "james_obrien",
+                "5": "priya_patel",
+                "6": "david_kim"
+            }
+            ask_question(engine, question, [persona_map[persona_choice]])
+
+    elif choice == "4":
+        # Compare two personas
+        console.print("[bold cyan]═══ COMPARE TWO PERSPECTIVES ═══[/bold cyan]\n")
+        console.print("[dim]See how two different stakeholders view the same issue[/dim]\n")
+
+        question = Prompt.ask(
+            "[cyan]Question[/cyan]",
+            default="Should we prioritize affordable housing or economic development?"
+        )
+        console.print()
+
+        console.print("[yellow]Pick first persona:[/yellow]")
+        show_personas(engine)
+        p1 = Prompt.ask("Persona 1 (1-6)", choices=["1","2","3","4","5","6"])
+
+        console.print("\n[yellow]Pick second persona:[/yellow]")
+        p2 = Prompt.ask("Persona 2 (1-6)", choices=["1","2","3","4","5","6"])
+
+        persona_map = {
+            "1": "sarah_chen",
+            "2": "marcus_thompson",
+            "3": "elena_rodriguez",
+            "4": "james_obrien",
+            "5": "priya_patel",
+            "6": "david_kim"
+        }
+
+        console.print()
+        ask_question(engine, question, [persona_map[p1], persona_map[p2]])
+
+    # Wrap up
+    console.print("\n" + "═" * 70)
+    console.print("\n[bold green]✓ Demo complete![/bold green]")
+    console.print("\n[dim]This demonstrates how the AI Personas system helps explore")
+    console.print("diverse stakeholder perspectives on urban planning issues.[/dim]\n")
+    console.print("[cyan]Next steps:[/cyan]")
+    console.print("  • Customize personas in [yellow]data/personas/[/yellow]")
+    console.print("  • Add your own contexts in [yellow]data/contexts/[/yellow]")
+    console.print("  • Use [yellow]python -m src.cli[/yellow] for full interactive mode")
+    console.print("  • Build Phase 2 for population distributions\n")
+
+
+if __name__ == "__main__":
+    try:
+        main()
+    except KeyboardInterrupt:
+        console.print("\n\n[yellow]Demo interrupted. Goodbye![/yellow]\n")
+    except Exception as e:
+        console.print(f"\n[red]Error: {e}[/red]\n")
+        import traceback
+        traceback.print_exc()

quick_demo.py

@@ -0,0 +1,49 @@
+"""
+Quick Demo - Ask the personas anything!
+
+Usage: python quick_demo.py
+"""
+
+import sys
+from pathlib import Path
+sys.path.insert(0, str(Path(__file__).parent))
+
+from src.pipeline.query_engine import QueryEngine
+
+print("\n" + "="*70)
+print("  AI Personas for Urban Planning - Quick Demo")
+print("="*70 + "\n")
+
+# Initialize
+print("Initializing...")
+engine = QueryEngine()
+engine.test_system()
+
+print("\n" + "="*70)
+print("\nAvailable Personas:")
+for i, (pid, name, role) in enumerate(engine.list_available_personas(), 1):
+    print(f"  {i}. {name} - {role}")
+
+print("\n" + "="*70)
+
+# Ask your question here!
+question = input("\nYour question: ")
+
+print(f"\nAsking all 6 personas: '{question}'\n")
+print("="*70 + "\n")
+
+responses = engine.query_multiple(
+    persona_ids=[p[0] for p in engine.list_available_personas()],
+    question=question,
+    context_id="downtown_district"
+)
+
+for i, response in enumerate(responses, 1):
+    print(f"\n{'='*70}")
+    print(f"{i}. {response.persona_name} ({response.persona_role})")
+    print('='*70)
+    print(f"\n{response.response}\n")
+
+print("\n" + "="*70)
+print(f"✓ Got {len(responses)} responses!")
+print("="*70 + "\n")