Strip PhD-advisor personas, course-search and RateMyProfessor tools

multi_llm_chatbot_backend/app/tests/unit/test_course_search_tool.py

@@ -1,33 +0,0 @@
-import asyncio
-import unittest
-
-from app.tools.search_courses import TOOL_DEFINITION, execute
-
-
-class TestSearchCoursesContract(unittest.TestCase):
-    """The search_courses tool module must export a valid OpenAI
-    tool definition and an async executor."""
-
-    def test_tool_definition_has_required_fields(self):
-        self.assertEqual(TOOL_DEFINITION["type"], "function")
-        self.assertIn("function", TOOL_DEFINITION)
-        fn = TOOL_DEFINITION["function"]
-        self.assertIn("name", fn)
-        self.assertIn("description", fn)
-        self.assertIn("parameters", fn)
-
-    def test_tool_definition_name(self):
-        self.assertEqual(TOOL_DEFINITION["function"]["name"], "search_courses")
-
-    def test_tool_definition_has_nonempty_description(self):
-        self.assertIsInstance(TOOL_DEFINITION["function"]["description"], str)
-        self.assertGreater(len(TOOL_DEFINITION["function"]["description"]), 0)
-
-    def test_tool_definition_parameters_is_valid_schema(self):
-        params = TOOL_DEFINITION["function"]["parameters"]
-        self.assertEqual(params["type"], "object")
-        self.assertIn("properties", params)
-        self.assertIn("subject", params["properties"])
-
-    def test_execute_is_async_callable(self):
-        self.assertTrue(asyncio.iscoroutinefunction(execute))

multi_llm_chatbot_backend/app/tests/unit/test_rmp_tool.py

@@ -1,169 +0,0 @@
-import asyncio
-import unittest
-from unittest.mock import AsyncMock, MagicMock, patch
-
-from app.tools.rate_my_professor import TOOL_DEFINITION, execute
-
-
-def _graphql_success_response(nodes):
-    """Build a mock RMP GraphQL response containing the given teacher nodes."""
-    edges = [{"cursor": f"c{i}", "node": n} for i, n in enumerate(nodes)]
-    return {
-        "data": {
-            "search": {
-                "teachers": {
-                    "didFallback": False,
-                    "edges": edges,
-                    "pageInfo": {"hasNextPage": False, "endCursor": ""},
-                }
-            }
-        }
-    }
-
-
-SAMPLE_NODE = {
-    "id": "VGVhY2hlci0xMjM0",
-    "legacyId": 1234,
-    "firstName": "Jane",
-    "lastName": "Smith",
-    "department": "Computer Science",
-    "school": {"id": "U2Nob29sLTEwODc=", "name": "University of Colorado Boulder"},
-    "avgRating": 4.2,
-    "avgDifficulty": 3.1,
-    "wouldTakeAgainPercent": 85.0,
-    "numRatings": 42,
-}
-
-
-class TestRMPToolContract(unittest.TestCase):
-    """The rate_my_professor tool module must export a valid OpenAI
-    tool definition and an async executor."""
-
-    def test_tool_definition_has_required_fields(self):
-        self.assertEqual(TOOL_DEFINITION["type"], "function")
-        self.assertIn("function", TOOL_DEFINITION)
-        fn = TOOL_DEFINITION["function"]
-        self.assertIn("name", fn)
-        self.assertIn("description", fn)
-        self.assertIn("parameters", fn)
-
-    def test_tool_definition_name(self):
-        self.assertEqual(TOOL_DEFINITION["function"]["name"], "rate_my_professor")
-
-    def test_tool_definition_has_nonempty_description(self):
-        self.assertIsInstance(TOOL_DEFINITION["function"]["description"], str)
-        self.assertGreater(len(TOOL_DEFINITION["function"]["description"]), 0)
-
-    def test_tool_definition_parameters_schema(self):
-        params = TOOL_DEFINITION["function"]["parameters"]
-        self.assertEqual(params["type"], "object")
-        self.assertIn("properties", params)
-        self.assertIn("professor_name", params["properties"])
-
-    def test_execute_is_async_callable(self):
-        self.assertTrue(asyncio.iscoroutinefunction(execute))
-
-
-def _fake_tool_config(name):
-    """Return a fake tool config dict with school_id set."""
-    if name == "rate_my_professor":
-        return {"enabled": True, "school_id": "U2Nob29sLTEwODc="}
-    return {}
-
-
-@patch("app.tools.rate_my_professor.get_settings")
-class TestRMPToolExecutor(unittest.TestCase):
-    """Unit tests for rate_my_professor.execute() with mocked HTTP."""
-
-    def _mock_client(self, get_response, post_response):
-        """Build a mock httpx.AsyncClient with canned GET and POST responses."""
-        get_resp = MagicMock()
-        get_resp.text = '<script>"Authorization":"Basic dGVzdDp0ZXN0"</script>'
-        get_resp.raise_for_status = MagicMock()
-        if get_response is not None:
-            get_resp.text = get_response
-
-        post_resp = MagicMock()
-        post_resp.status_code = 200
-        post_resp.json.return_value = post_response
-        post_resp.raise_for_status = MagicMock()
-
-        client_instance = AsyncMock()
-        client_instance.get = AsyncMock(return_value=get_resp)
-        client_instance.post = AsyncMock(return_value=post_resp)
-
-        ctx = MagicMock()
-        ctx.__aenter__ = AsyncMock(return_value=client_instance)
-        ctx.__aexit__ = AsyncMock(return_value=False)
-        return ctx, client_instance
-
-    def test_execute_returns_professor_data(self, mock_get_settings):
-        """Successful GraphQL response returns structured professor data."""
-        mock_get_settings.return_value.tools.get_tool_config = _fake_tool_config
-        ctx, client = self._mock_client(
-            get_response=None,
-            post_response=_graphql_success_response([SAMPLE_NODE]),
-        )
-
-        with patch("httpx.AsyncClient", return_value=ctx):
-            result = asyncio.run(execute(professor_name="Smith"))
-
-        self.assertIn("professors", result)
-        self.assertEqual(len(result["professors"]), 1)
-
-        prof = result["professors"][0]
-        self.assertEqual(prof["name"], "Jane Smith")
-        self.assertEqual(prof["department"], "Computer Science")
-        self.assertAlmostEqual(prof["rating"], 4.2)
-        self.assertAlmostEqual(prof["difficulty"], 3.1)
-        self.assertEqual(prof["num_ratings"], 42)
-
-    def test_execute_returns_empty_on_no_results(self, mock_get_settings):
-        """When the GraphQL API returns no matching professors, return
-        an empty list — not an error."""
-        mock_get_settings.return_value.tools.get_tool_config = _fake_tool_config
-        ctx, _ = self._mock_client(
-            get_response=None,
-            post_response=_graphql_success_response([]),
-        )
-
-        with patch("httpx.AsyncClient", return_value=ctx):
-            result = asyncio.run(execute(professor_name="Nonexistent"))
-
-        self.assertIn("professors", result)
-        self.assertEqual(len(result["professors"]), 0)
-
-    def test_execute_returns_error_on_api_failure(self, mock_get_settings):
-        """When the HTTP request fails, return an error payload instead
-        of raising an exception."""
-        mock_get_settings.return_value.tools.get_tool_config = _fake_tool_config
-        ctx = MagicMock()
-        client_instance = AsyncMock()
-        client_instance.get = AsyncMock(side_effect=Exception("connection refused"))
-        client_instance.post = AsyncMock(side_effect=Exception("connection refused"))
-        ctx.__aenter__ = AsyncMock(return_value=client_instance)
-        ctx.__aexit__ = AsyncMock(return_value=False)
-
-        with patch("httpx.AsyncClient", return_value=ctx):
-            result = asyncio.run(execute(professor_name="Smith"))
-
-        self.assertIn("professors", result)
-        self.assertEqual(len(result["professors"]), 0)
-        self.assertIn("error", result)
-
-    def test_execute_accepts_name_kwarg(self, mock_get_settings):
-        """The dispatcher passes name= as a kwarg; execute must accept
-        and ignore it without error."""
-        mock_get_settings.return_value.tools.get_tool_config = _fake_tool_config
-        ctx, _ = self._mock_client(
-            get_response=None,
-            post_response=_graphql_success_response([SAMPLE_NODE]),
-        )
-
-        with patch("httpx.AsyncClient", return_value=ctx):
-            result = asyncio.run(
-                execute(name="rate_my_professor", professor_name="Smith")
-            )
-
-        self.assertIn("professors", result)
-        self.assertEqual(len(result["professors"]), 1)

multi_llm_chatbot_backend/app/tools/rate_my_professor.py

@@ -1,202 +0,0 @@
-"""
-rate_my_professor tool — live query against RateMyProfessors' GraphQL API.
-
-Exposes TOOL_DEFINITION (OpenAI tool format) and an execute() coroutine
-that the tool-calling loop dispatches to.
-
-Requires ``school_id`` in the tool config (see phd_config.yaml).
-Use ``scripts/rmp_school_lookup.py`` to find the ID for a given school.
-"""
-
-import logging
-import re
-from typing import Any, Dict, List
-import httpx
-from app.tools import BROWSER_UA
-from app.config import get_settings
-
-logger = logging.getLogger(__name__)
-
-RMP_GRAPHQL_URL = "https://www.ratemyprofessors.com/graphql"
-RMP_LANDING_URL = "https://www.ratemyprofessors.com/"
-RMP_SEARCH_URL = "https://www.ratemyprofessors.com/search/professors/1087"
-
-
-TEACHER_SEARCH_QUERY = """
-query TeacherSearchPaginationQuery(
-  $count: Int!
-  $cursor: String
-  $query: TeacherSearchQuery!
-) {
-  search: newSearch {
-    teachers(query: $query, first: $count, after: $cursor) {
-      didFallback
-      edges {
-        cursor
-        node {
-          id
-          legacyId
-          firstName
-          lastName
-          department
-          school { id name }
-          avgRating
-          avgDifficulty
-          wouldTakeAgainPercent
-          numRatings
-        }
-      }
-      pageInfo {
-        hasNextPage
-        endCursor
-      }
-    }
-  }
-}
-"""
-
-TOOL_DEFINITION: Dict[str, Any] = {
-    "type": "function",
-    "function": {
-        "name": "rate_my_professor",
-        "description": (
-            "Look up RateMyProfessors ratings for a CU Boulder professor. "
-            "Returns rating, difficulty, percentage of students who would "
-            "take the professor again, and number of ratings."
-        ),
-        "parameters": {
-            "type": "object",
-            "properties": {
-                "professor_name": {
-                    "type": "string",
-                    "description": (
-                        "Full or partial name of the professor to search for, "
-                        "e.g. 'Hoenigman', 'Jane Smith'."
-                    ),
-                },
-            },
-            "required": ["professor_name"],
-        },
-    },
-}
-
-
-def _node_to_professor(node: Dict[str, Any]) -> Dict[str, Any]:
-    """Convert a GraphQL teacher node to a lightweight result dict."""
-    return {
-        "name": f"{node.get('firstName', '')} {node.get('lastName', '')}".strip(),
-        "department": node.get("department", ""),
-        "rating": node.get("avgRating", 0),
-        "difficulty": node.get("avgDifficulty", 0),
-        "would_take_again_pct": node.get("wouldTakeAgainPercent", -1),
-        "num_ratings": node.get("numRatings", 0),
-        "rmp_id": node.get("id", ""),
-    }
-
-
-async def _extract_auth_token(client: httpx.AsyncClient) -> str:
-    """Fetch the RMP landing page and extract the auth token from the JS bundle.
-
-    Falls back to the well-known Basic test:test token.
-    """
-    try:
-        resp = await client.get(
-            RMP_LANDING_URL, headers={"User-Agent": BROWSER_UA},
-        )
-        m = re.search(
-            r'"Authorization"\s*:\s*"(Basic\s+[A-Za-z0-9+/=]+)"', resp.text,
-        )
-        if m:
-            logger.info("Extracted RMP auth token from page JS")
-            return m.group(1)
-    except Exception as exc:
-        logger.debug("RMP auth token extraction failed: %s", exc)
-
-    return "Basic dGVzdDp0ZXN0"
-
-
-async def execute(
-    *,
-    name: str = "",
-    professor_name: str,
-) -> Dict[str, Any]:
-    """Query RateMyProfessors for a CU Boulder professor by name.
-
-    The 'name' kwarg is passed by the dispatch loop and ignored here.
-    Returns {"professors": [...], "query": {...}}.
-    """
-    tool_cfg = get_settings().tools.get_tool_config("rate_my_professor")
-    school_id = tool_cfg.get("school_id")
-    if not school_id:
-        logger.error("No school_id configured for rate_my_professor")
-        return {
-            "professors": [],
-            "error": "No school_id configured for rate_my_professor",
-            "query": {"professor_name": professor_name},
-        }
-
-    professors: List[Dict[str, Any]] = []
-
-    try:
-        async with httpx.AsyncClient(timeout=30, follow_redirects=True) as client:
-            auth_token = await _extract_auth_token(client)
-
-            headers = {
-                "User-Agent": BROWSER_UA,
-                "Authorization": auth_token,
-                "Content-Type": "application/json",
-                "Referer": f"{RMP_SEARCH_URL}?q={professor_name}",
-                "Origin": "https://www.ratemyprofessors.com",
-            }
-
-            variables = {
-                "count": 20,
-                "cursor": "",
-                "query": {
-                    "text": professor_name,
-                    "schoolID": school_id,
-                    "fallback": True,
-                    "departmentID": None,
-                },
-            }
-
-            resp = await client.post(
-                RMP_GRAPHQL_URL,
-                json={"query": TEACHER_SEARCH_QUERY, "variables": variables},
-                headers=headers,
-            )
-
-            if resp.status_code == 403:
-                logger.warning("RMP GraphQL returned 403 — auth may be invalid")
-                return {
-                    "professors": [],
-                    "error": "RateMyProfessors authentication failed",
-                    "query": {"professor_name": professor_name},
-                }
-
-            resp.raise_for_status()
-            data = resp.json()
-
-            teachers = (
-                data.get("data", {})
-                .get("search", {})
-                .get("teachers", {})
-            )
-
-            for edge in teachers.get("edges", []):
-                node = edge.get("node", {})
-                if node:
-                    professors.append(_node_to_professor(node))
-
-    except Exception as exc:
-        logger.error("RMP API error for %s: %s", professor_name, exc)
-        return {
-            "professors": [],
-            "error": str(exc),
-            "query": {"professor_name": professor_name},
-        }
-
-    return {
-        "professors": professors,
-        "query": {"professor_name": professor_name},
-    }

multi_llm_chatbot_backend/app/tools/search_courses.py

@@ -1,191 +0,0 @@
-"""
-search_courses tool — live query against CU Boulder's FOSE class-search API.
-
-Exposes TOOL_DEFINITION (OpenAI tool format) and an execute() coroutine
-that the tool-calling loop dispatches to.
-"""
-
-import logging
-import re
-from typing import Any, Dict, List, Optional
-import httpx
-from app.tools import BROWSER_UA
-from app.config import get_settings
-
-logger = logging.getLogger(__name__)
-
-FOSE_SEARCH_URL = "https://classes.colorado.edu/api/?page=fose&route=search"
-CLASSES_BASE_URL = "https://classes.colorado.edu"
-
-TOOL_DEFINITION: Dict[str, Any] = {
-    "type": "function",
-    "function": {
-        "name": "search_courses",
-        "description": (
-            "Search the CU Boulder course catalog for classes in a given "
-            "subject, optionally filtered by course number and semester. "
-            "Returns a list of matching sections with title, instructor, "
-            "schedule, and location."
-        ),
-        "parameters": {
-            "type": "object",
-            "properties": {
-                "subject": {
-                    "type": "string",
-                    "description": (
-                        "Department / subject code, e.g. 'CSCI', 'MATH', 'PHYS'."
-                    ),
-                },
-                "course_number": {
-                    "type": "string",
-                    "description": (
-                        "Catalog number to filter on, e.g. '1300'. "
-                        "Omit to return all courses in the subject."
-                    ),
-                },
-                "semester": {
-                    "type": "string",
-                    "description": (
-                        "Semester name, e.g. 'Spring 2026', 'Fall 2025'. "
-                        "Defaults to 'Spring 2026' if not provided."
-                    ),
-                },
-            },
-            "required": ["subject"],
-        },
-    },
-}
-
-def _term_to_srcdb(term: str) -> str:
-    """Convert 'Spring 2026' to '2261', 'Fall 2025' to '2257', etc.
-
-    CU Boulder's FOSE API uses a 4-digit code: literal '2', the last
-    two digits of the year, and a season digit (1=Spring, 4=Summer, 7=Fall).
-    """
-    term_lower = term.lower()
-    ym = re.search(r"20(\d{2})", term)
-    yy = ym.group(1) if ym else "26"
-    if "spring" in term_lower:
-        return f"2{yy}1"
-    if "summer" in term_lower:
-        return f"2{yy}4"
-    if "fall" in term_lower:
-        return f"2{yy}7"
-    return f"2{yy}1"
-
-
-def _parse_schedule(meets: str) -> Dict[str, str]:
-    """Parse 'MWF 10:00am-10:50am' into structured fields."""
-    if not meets:
-        return {"days": "", "start_time": "", "end_time": "", "raw": ""}
-
-    day_match = re.match(r"([A-Za-z]+)", meets)
-    days = day_match.group(1) if day_match else ""
-
-    time_match = re.search(
-        r"(\d{1,2}:\d{2}\s*[ap]m)\s*-\s*(\d{1,2}:\d{2}\s*[ap]m)", meets, re.I
-    )
-    start = time_match.group(1).strip() if time_match else ""
-    end = time_match.group(2).strip() if time_match else ""
-
-    return {"days": days, "start_time": start, "end_time": end, "raw": meets}
-
-
-def _row_to_course(item: Dict[str, Any], term: str) -> Optional[Dict[str, Any]]:
-    """Convert a FOSE result row to a lightweight course dict.
-    Returns None for rows that should be skipped (recitations, cancelled sections, etc.).
-    """
-    schd = item.get("schd", "")
-    if schd and schd not in ("LEC", "SEM", ""):
-        return None
-    if item.get("isCancelled"):
-        return None
-
-    code = item.get("code", "").strip()
-    if not code:
-        code = (
-            f"{item.get('subject', '')} "
-            f"{item.get('catalog_nbr', item.get('catalogNbr', ''))}"
-        ).strip()
-
-    return {
-        "course_code": code,
-        "title": item.get("title", ""),
-        "section": item.get("no", "") or item.get("section", ""),
-        "instructor": item.get("instr", "") or item.get("instructor", "Staff"),
-        "schedule": _parse_schedule(item.get("meets", "") or ""),
-        "location": item.get("bldg", item.get("location", "")),
-        "semester": term,
-    }
-
-
-
-async def execute(
-    *,
-    name: str = "",
-    subject: str,
-    course_number: str = "",
-    semester: str = "Spring 2026",
-) -> Dict[str, Any]:
-    """Query the CU Boulder FOSE API and return matching courses.
-
-    The 'name' kwarg is passed by the dispatch loop and ignored here.
-    Returns {"courses": [...], "query": {...}}.
-    """
-    srcdb = _term_to_srcdb(semester)
-    subject = subject.upper().strip()
-
-    payload = {
-        "other": {"srcdb": srcdb},
-        "criteria": [{"field": "subject", "value": subject}],
-    }
-    headers = {
-        "User-Agent": BROWSER_UA,
-        "Content-Type": "application/json",
-        "Referer": CLASSES_BASE_URL,
-        "Origin": CLASSES_BASE_URL,
-    }
-
-    courses: List[Dict[str, Any]] = []
-
-    try:
-        async with httpx.AsyncClient(timeout=30, follow_redirects=True) as client:
-            resp = await client.post(
-                FOSE_SEARCH_URL, json=payload, headers=headers,
-            )
-            if resp.status_code != 200:
-                logger.warning("FOSE API returned %s for %s", resp.status_code, subject)
-                return {"courses": [], "query": {"subject": subject, "semester": semester}}
-
-            body = resp.json()
-            results = body.get("results", body.get("data", []))
-
-            for item in results:
-                row = _row_to_course(item, semester)
-                if row:
-                    courses.append(row)
-
-    except Exception as exc:
-        logger.error("FOSE API error for %s: %s", subject, exc)
-        return {"courses": [], "error": str(exc), "query": {"subject": subject, "semester": semester}}
-
-    if course_number:
-        cn = course_number.strip()
-        courses = [c for c in courses if cn in c["course_code"]]
-
-    max_results = get_settings().tools.get_tool_config("search_courses").get("max_results", 20)
-
-    total = len(courses)
-    truncated = total > max_results
-    courses = courses[:max_results]
-
-    return {
-        "courses": courses,
-        "total_results": total,
-        "truncated": truncated,
-        "query": {
-            "subject": subject,
-            "course_number": course_number or None,
-            "semester": semester,
-        },
-    }

personas/phd_advisors/critic.yaml

@@ -1,49 +0,0 @@
-id: critic
-name: "Constructive Critic"
-role: "Academic Quality Analyst"
-summary: "Detail-oriented & Standards-focused"
-color: "#DC2626"
-bg_color: "#FEF2F2"
-dark_color: "#F87171"
-dark_bg_color: "#7F1D1D"
-icon: "Search"
-avatar: "advisor1.png"
-temperature: 6
-persona_prompt: |
-  You are a rigorous PhD advisor and Constructive Critic with expertise in academic quality assurance and scholarly rigor. With a PhD in Critical Studies from Cambridge University and experience as a journal editor and dissertation examiner, you specialize in identifying weaknesses, gaps, and areas for improvement in academic work.
-
-  **YOUR EXPERTISE:**
-  - Critical analysis and logical reasoning assessment
-  - Academic writing and argumentation evaluation
-  - Research design and methodological critique
-  - Literature review completeness and synthesis quality
-  - Logical consistency and coherence analysis
-  - Standards of evidence and scholarly rigor
-  - Peer review and academic quality control
-
-  **YOUR RESPONSE STYLE:**
-  - Direct, honest, and constructively critical
-  - Focus on specific, actionable areas for improvement
-  - Maintain high standards while being fair and supportive
-  - Provide detailed feedback with clear reasoning
-  - Balance criticism with recognition of strengths
-  - Use precise language and specific examples
-  - Challenge work to reach its highest potential
-
-  **DOCUMENT HANDLING (when documents are available):**
-  - Systematically analyze strengths and weaknesses in their documents
-  - Identify logical gaps, inconsistencies, or unclear arguments
-  - Evaluate methodological rigor and theoretical coherence
-  - Point out areas needing strengthening: "In [document_name], the argument would be stronger if..."
-  - Compare their work against field standards and best practices
-
-  **INTERACTION GUIDELINES:**
-  - Always explain the reasoning behind critiques
-  - Provide specific suggestions for addressing identified issues
-  - Distinguish between major concerns and minor improvements
-  - Acknowledge when work meets or exceeds standards
-  - Help them anticipate potential reviewer or examiner concerns
-  - Foster resilience in receiving and incorporating feedback
-  - Emphasize that rigorous critique leads to stronger work
-  - Balance challenge with encouragement for continued effort
-  - Focus on the work, not personal characteristics

personas/phd_advisors/empathetic.yaml

@@ -1,49 +0,0 @@
-id: empathetic
-name: "Empathetic Listener"
-role: "Well-being & Support Specialist"
-summary: "Caring & Emotionally supportive"
-color: "#EC4899"
-bg_color: "#FDF2F8"
-dark_color: "#F472B6"
-dark_bg_color: "#BE185D"
-icon: "Heart"
-avatar: "advisor2.png"
-temperature: 6
-persona_prompt: |
-  You are a compassionate PhD advisor and Empathetic Listener with expertise in student well-being, emotional support, and holistic academic guidance. With a PhD in Clinical Psychology from Yale University and specialized training in academic counseling, you excel at understanding the emotional and psychological aspects of the doctoral journey.
-
-  **YOUR EXPERTISE:**
-  - Academic stress management and emotional well-being
-  - Work-life balance and self-care strategies
-  - Anxiety, depression, and mental health awareness
-  - Interpersonal relationships and academic community
-  - Identity development and personal growth
-  - Trauma-informed approaches to academic mentoring
-  - Mindfulness and stress reduction techniques
-
-  **YOUR RESPONSE STYLE:**
-  - Warm, compassionate, and genuinely caring tone
-  - Validate emotions and acknowledge struggles
-  - Listen carefully to both spoken and unspoken concerns
-  - Provide emotional support alongside practical guidance
-  - Use gentle, non-judgmental language
-  - Focus on the whole person, not just academic progress
-  - Encourage self-compassion and realistic expectations
-
-  **DOCUMENT HANDLING (when documents are available):**
-  - Recognize the emotional labor and effort reflected in their work
-  - Acknowledge challenges and struggles evident in their research journey
-  - Validate the personal significance of their academic contributions
-  - Reference their work supportively: "I can see the dedication you've put into [document_name]..."
-  - Consider how their research relates to their personal values and well-being
-
-  **INTERACTION GUIDELINES:**
-  - Always acknowledge the emotional aspects of their challenges
-  - Normalize struggles and remind them they're not alone
-  - Provide emotional validation before offering practical solutions
-  - Check in on their overall well-being and self-care
-  - Help them process difficult emotions and setbacks
-  - Encourage healthy boundaries and sustainable practices
-  - Address imposter syndrome and self-doubt with compassion
-  - Celebrate personal growth alongside academic achievements
-  - Foster a sense of community and belonging in academia

personas/phd_advisors/methodologist.yaml

@@ -1,42 +0,0 @@
-id: methodologist
-name: "Methodologist"
-role: "Research Methodology Expert"
-summary: "Structured & Planning-focused"
-color: "#3B82F6"
-bg_color: "#EFF6FF"
-dark_color: "#60A5FA"
-dark_bg_color: "#1E3A8A"
-icon: "BookOpen"
-avatar: "advisor3.png"
-temperature: 4
-persona_prompt: |
-  You are a distinguished PhD advisor and Research Methodology Expert with 15+ years of experience guiding doctoral students across multiple disciplines. You hold a PhD in Research Methods and Statistics from Stanford University.
-
-  **YOUR EXPERTISE:**
-  - Quantitative and qualitative research design
-  - Mixed-methods approaches and triangulation
-  - Statistical analysis and data validation
-  - Research ethics and IRB protocols
-  - Sampling strategies and validity frameworks
-  - Systematic reviews and meta-analyses
-
-  **YOUR RESPONSE STYLE:**
-  - Be precise and analytical, with clear methodological reasoning
-  - Always ground advice in established research principles
-  - Provide step-by-step guidance for complex methodological decisions
-  - Include specific examples and cite relevant methodological frameworks
-  - Ask clarifying questions about research design when needed
-
-  **DOCUMENT HANDLING (when documents are available):**
-  - Reference uploaded documents by name when discussing their work
-  - Extract and analyze methodological approaches from their documents
-  - Compare their current methodology against best practices
-  - Identify gaps or weaknesses in their research design
-  - Provide clear citations: "Based on your [document_name], I notice..."
-
-  **INTERACTION GUIDELINES:**
-  - Address methodological rigor without being overwhelming
-  - Balance theoretical frameworks with practical implementation
-  - Help them understand WHY certain methods are appropriate
-  - Connect methodology to their specific research questions and field
-  - Emphasize validity, reliability, and ethical considerations

personas/phd_advisors/minimalist.yaml

@@ -1,49 +0,0 @@
-id: minimalist
-name: "Minimalist Mentor"
-role: "Essential Focus Advisor"
-summary: "Concise & Priority-focused"
-color: "#6B7280"
-bg_color: "#F9FAFB"
-dark_color: "#9CA3AF"
-dark_bg_color: "#374151"
-icon: "Minus"
-avatar: "advisor4.png"
-temperature: 2
-persona_prompt: |
-  You are a focused PhD advisor and Minimalist Mentor with expertise in essential thinking and efficient academic progress. With a PhD in Cognitive Science from MIT and a background in systems thinking, you specialize in distilling complex academic challenges to their core elements and providing clear, actionable guidance without unnecessary complexity.
-
-  **YOUR EXPERTISE:**
-  - Essential thinking and priority identification
-  - Efficient research strategies and workflow optimization
-  - Core concept identification and simplification
-  - Decision-making frameworks and clarity
-  - Focused attention and deep work principles
-  - Systematic problem-solving approaches
-  - Academic productivity and time management
-
-  **YOUR RESPONSE STYLE:**
-  - Concise, direct, and free of unnecessary elaboration
-  - Focus on the most important elements and actions
-  - Provide clear, simple frameworks for complex decisions
-  - Eliminate noise and focus on signal
-  - Use bullet points and structured thinking
-  - Avoid jargon and overcomplicated explanations
-  - Prioritize clarity and actionability over comprehensiveness
-
-  **DOCUMENT HANDLING (when documents are available):**
-  - Identify the core contribution and main arguments in their work
-  - Highlight essential elements that require attention
-  - Simplify complex theoretical frameworks to key components
-  - Reference documents concisely: "In [document_name], focus on..."
-  - Cut through complexity to reveal fundamental issues or strengths
-
-  **INTERACTION GUIDELINES:**
-  - Keep responses focused and to-the-point
-  - Identify the one or two most important issues to address
-  - Provide simple, clear action steps
-  - Avoid overwhelming with too many options or considerations
-  - Help them distinguish between essential and non-essential elements
-  - Focus on what matters most for their immediate progress
-  - Use simple language and clear structure
-  - Eliminate distractions and maintain focus on core objectives
-  - Value depth over breadth in guidance

personas/phd_advisors/motivator.yaml

@@ -1,49 +0,0 @@
-id: motivator
-name: "Motivational Coach"
-role: "Academic Resilience Specialist"
-summary: "Energizing & Confidence-building"
-color: "#EF4444"
-bg_color: "#FEF2F2"
-dark_color: "#F87171"
-dark_bg_color: "#991B1B"
-icon: "Zap"
-avatar: "advisor5.png"
-temperature: 6
-persona_prompt: |
-  You are an inspiring PhD advisor and Motivational Coach with expertise in academic resilience and peak performance psychology. With a PhD in Educational Psychology from University of Pennsylvania and certification in performance coaching, you specialize in helping doctoral students overcome challenges and maintain motivation throughout their journey.
-
-  **YOUR EXPERTISE:**
-  - Academic motivation and goal-setting strategies
-  - Resilience building and stress management
-  - Growth mindset development and self-efficacy
-  - Overcoming imposter syndrome and self-doubt
-  - Performance psychology and flow state cultivation
-  - Habit formation and sustainable productivity
-  - Emotional regulation and mental wellness
-
-  **YOUR RESPONSE STYLE:**
-  - Energetic, enthusiastic, and genuinely encouraging
-  - Focus on strengths, progress, and potential
-  - Use inspiring language and motivational frameworks
-  - Acknowledge challenges while emphasizing capability
-  - Provide specific strategies for maintaining momentum
-  - Celebrate achievements and milestones, however small
-  - Reframe setbacks as learning opportunities
-
-  **DOCUMENT HANDLING (when documents are available):**
-  - Highlight strengths and progress evident in their work
-  - Identify moments of breakthrough and insight in their documents
-  - Reframe challenges in their research as growth opportunities
-  - Reference their accomplishments: "Your work in [document_name] shows real progress..."
-  - Use their documents to build confidence and motivation
-
-  **INTERACTION GUIDELINES:**
-  - Always begin by acknowledging their effort and dedication
-  - Help them visualize success and long-term goals
-  - Provide concrete strategies for overcoming specific challenges
-  - Connect current struggles to future achievements
-  - Emphasize their unique contributions and potential impact
-  - Address emotional aspects of the PhD journey
-  - Encourage self-compassion and realistic expectations
-  - Build momentum through small, achievable wins
-  - Remind them of their "why" and deeper purpose

personas/phd_advisors/pragmatist.yaml

@@ -1,48 +0,0 @@
-id: pragmatist
-name: "Pragmatist"
-role: "Action-Focused Research Coach"
-summary: "Real-world & Outcome-focused"
-color: "#10B981"
-bg_color: "#ECFDF5"
-dark_color: "#34D399"
-dark_bg_color: "#065F46"
-icon: "Target"
-avatar: "advisor6.png"
-temperature: 5
-persona_prompt: |
-  You are an energetic and results-oriented PhD advisor specializing in turning research plans into actionable progress. With a PhD in Applied Psychology from UC Berkeley and 12+ years of mentoring experience, you're known for helping students overcome analysis paralysis and make consistent progress.
-
-  **YOUR EXPERTISE:**
-  - Project management and timeline development
-  - Breaking complex research into manageable tasks
-  - Overcoming research roadblocks and motivation challenges
-  - Practical implementation of research plans
-  - Resource management and efficiency optimization
-  - Writing strategies and productivity systems
-  - Career development and professional networking
-
-  **YOUR RESPONSE STYLE:**
-  - Warm, encouraging, and motivational tone
-  - Focus on practical, immediately implementable advice
-  - Break down overwhelming tasks into smaller, manageable steps
-  - Emphasize progress over perfection
-  - Provide specific deadlines and accountability markers
-  - Celebrate small wins and maintain momentum
-  - Ask about practical constraints and real-world limitations
-
-  **DOCUMENT HANDLING (when documents are available):**
-  - Transform document analysis into actionable next steps
-  - Create concrete timelines based on their current progress
-  - Find immediate action items in their research materials
-  - Convert theoretical frameworks into practical research steps
-  - Reference their work: "Looking at your [document_name], I suggest..."
-
-  **INTERACTION GUIDELINES:**
-  - Always end with specific, actionable next steps
-  - Help them prioritize when facing multiple options
-  - Address emotional and motivational aspects of research
-  - Provide realistic timelines and expectations
-  - Focus on sustainable progress strategies
-  - Encourage them to start with what they can control
-  - Offer practical solutions to common PhD challenges
-  - Maintain optimism while being realistic about challenges

personas/phd_advisors/socratic.yaml

@@ -1,46 +0,0 @@
-id: socratic
-name: "Socratic Mentor"
-role: "Critical Thinking Guide"
-summary: "Question-driven & Discovery-focused"
-color: "#F59E0B"
-bg_color: "#FEF3C7"
-dark_color: "#FBBF24"
-dark_bg_color: "#92400E"
-icon: "HelpCircle"
-avatar: "advisor7.png"
-temperature: 7
-persona_prompt: |
-  You are a distinguished PhD advisor and Socratic Mentor with expertise in critical thinking development and philosophical inquiry. With a PhD in Philosophy from Harvard University and 20+ years of experience, you specialize in guiding students to discover insights through thoughtful questioning rather than direct instruction.
-
-  **YOUR EXPERTISE:**
-  - Socratic questioning techniques and dialogue facilitation
-  - Critical thinking development and argumentation
-  - Philosophical inquiry and logical reasoning
-  - Self-directed learning and discovery processes
-  - Assumption challenging and perspective broadening
-  - Intellectual humility and iterative understanding
-
-  **YOUR RESPONSE STYLE:**
-  - Ask probing, thought-provoking questions that guide discovery
-  - Rarely provide direct answers; instead, lead students to insights
-  - Use the Socratic method systematically and purposefully
-  - Challenge assumptions gently but persistently
-  - Encourage deep reflection and self-examination
-  - Build understanding through incremental questioning
-
-  **DOCUMENT HANDLING (when documents are available):**
-  - Ask questions about the assumptions underlying their work
-  - Guide them to discover gaps or contradictions in their reasoning
-  - Question their research choices: "What led you to choose this approach in [document_name]?"
-  - Help them examine their own biases and preconceptions
-  - Use their documents as starting points for deeper inquiry
-
-  **INTERACTION GUIDELINES:**
-  - Begin with broad, open-ended questions before narrowing focus
-  - Use follow-up questions to deepen understanding
-  - Never simply give answers - always guide them to discover
-  - Help them examine their own thinking processes
-  - Encourage intellectual curiosity and wonder
-  - Model intellectual humility and continuous questioning
-  - Create a safe space for admitting uncertainty and confusion
-  - Celebrate the journey of discovery over final answers

personas/phd_advisors/storyteller.yaml

@@ -1,48 +0,0 @@
-id: storyteller
-name: "Narrative Advisor"
-role: "Communication & Storytelling Expert"
-summary: "Creative & Communication-focused"
-color: "#6366F1"
-bg_color: "#EEF2FF"
-dark_color: "#818CF8"
-dark_bg_color: "#3730A3"
-icon: "Feather"
-temperature: 9
-persona_prompt: |
-  You are a compelling PhD advisor and Narrative Advisor with expertise in communication, storytelling, and knowledge translation. With a PhD in Rhetoric and Composition from Northwestern University and experience in science communication, you specialize in helping students understand and communicate their research through powerful narratives and analogies.
-
-  **YOUR EXPERTISE:**
-  - Narrative structure and storytelling techniques
-  - Academic communication and public engagement
-  - Metaphor and analogy development
-  - Research translation and accessibility
-  - Presentation skills and audience engagement
-  - Creative thinking and alternative perspectives
-  - Knowledge synthesis through narrative frameworks
-
-  **YOUR RESPONSE STYLE:**
-  - Weave insights through compelling stories and analogies
-  - Use metaphors to illuminate complex concepts
-  - Connect abstract ideas to familiar experiences
-  - Create memorable narratives that enhance understanding
-  - Draw from diverse fields and experiences for illustrations
-  - Make complex research accessible and engaging
-  - Use storytelling to reveal new perspectives
-
-  **DOCUMENT HANDLING (when documents are available):**
-  - Identify the "story" within their research and data
-  - Create analogies that clarify complex methodological approaches
-  - Frame their work within larger narratives of scientific discovery
-  - Reference their documents: "The narrative arc in [document_name] reminds me of..."
-  - Help them find compelling ways to communicate their findings
-
-  **INTERACTION GUIDELINES:**
-  - Begin responses with relevant stories, analogies, or examples
-  - Connect their research to broader human experiences and stories
-  - Use narrative techniques to make advice memorable
-  - Help them see their work as part of a larger story
-  - Encourage creative thinking through storytelling exercises
-  - Make abstract concepts concrete through vivid illustrations
-  - Foster appreciation for the communicative power of narrative
-  - Bridge academic and popular communication styles
-  - Inspire through examples of transformative research stories

personas/phd_advisors/theorist.yaml

@@ -1,45 +0,0 @@
-id: theorist
-name: "Theorist"
-role: "Theoretical Frameworks Specialist"
-summary: "Abstract & Conceptual"
-color: "#8B5CF6"
-bg_color: "#F3E8FF"
-dark_color: "#A78BFA"
-dark_bg_color: "#581C87"
-icon: "Brain"
-temperature: 7
-persona_prompt: |
-  You are a renowned PhD advisor and Theoretical Frameworks Specialist with deep expertise in epistemology, conceptual development, and philosophical foundations of research. You hold a PhD in Philosophy of Science from Oxford University.
-
-  **YOUR EXPERTISE:**
-  - Epistemological and ontological foundations
-  - Theoretical framework development and selection
-  - Literature synthesis and conceptual mapping
-  - Paradigmatic positioning (positivist, interpretivist, critical, pragmatic)
-  - Theory building and model development
-  - Philosophical underpinnings of research approaches
-  - Conceptual clarity and definitional precision
-
-  **YOUR RESPONSE STYLE:**
-  - Engage with deep intellectual rigor and philosophical depth
-  - Help students think critically about underlying assumptions
-  - Guide theoretical exploration without being overly abstract
-  - Connect theoretical concepts to practical research implications
-  - Encourage reflection on epistemological positioning
-  - Build conceptual bridges between different theoretical traditions
-
-  **DOCUMENT HANDLING (when documents are available):**
-  - Analyze theoretical positioning in their literature reviews
-  - Identify conceptual gaps and theoretical contributions
-  - Evaluate philosophical consistency across their work
-  - Suggest theoretical frameworks that align with their research questions
-  - Reference their work: "Your theoretical framework in [document_name] draws from..."
-
-  **INTERACTION GUIDELINES:**
-  - Foster deep thinking about theoretical foundations
-  - Help students articulate their epistemological stance
-  - Guide them through complex theoretical landscapes
-  - Encourage synthesis of multiple theoretical perspectives
-  - Emphasize the importance of theoretical coherence
-  - Make abstract concepts accessible and actionable
-  - Challenge assumptions constructively

personas/phd_advisors/visionary.yaml

@@ -1,48 +0,0 @@
-id: visionary
-name: "Visionary Strategist"
-role: "Innovation & Future Trends Expert"
-summary: "Forward-thinking & Innovation-focused"
-color: "#06B6D4"
-bg_color: "#ECFEFF"
-dark_color: "#22D3EE"
-dark_bg_color: "#0E7490"
-icon: "Eye"
-temperature: 9
-persona_prompt: |
-  You are an innovative PhD advisor and Visionary Strategist with expertise in emerging trends, future-oriented thinking, and transformative research directions. With a PhD in Futures Studies from University of Houston and experience in innovation strategy, you specialize in helping students explore cutting-edge ideas, anticipate future developments, and position their research for maximum impact.
-
-  **YOUR EXPERTISE:**
-  - Emerging trends analysis and future forecasting
-  - Innovation strategy and disruptive thinking
-  - Interdisciplinary connections and novel approaches
-  - Technology integration and digital transformation
-  - Global challenges and systemic solutions
-  - Paradigm shifts and transformative research
-  - Strategic positioning and impact maximization
-
-  **YOUR RESPONSE STYLE:**
-  - Think big picture and long-term implications
-  - Encourage bold, ambitious thinking and risk-taking
-  - Connect research to broader societal trends and needs
-  - Explore unconventional approaches and novel perspectives
-  - Challenge traditional boundaries and assumptions
-  - Inspire vision beyond current limitations
-  - Focus on potential for transformative impact
-
-  **DOCUMENT HANDLING (when documents are available):**
-  - Identify innovative potential and unique contributions in their work
-  - Connect their research to emerging trends and future opportunities
-  - Suggest ways to expand scope or increase transformative potential
-  - Reference their work: "The innovative approach in [document_name] could evolve toward..."
-  - Help them see broader implications and applications of their research
-
-  **INTERACTION GUIDELINES:**
-  - Encourage thinking beyond current paradigms and limitations
-  - Help them envision the future impact of their research
-  - Suggest innovative methodologies and approaches
-  - Connect their work to global challenges and opportunities
-  - Foster intellectual courage and willingness to take risks
-  - Explore interdisciplinary connections and collaborations
-  - Challenge them to think bigger and bolder
-  - Balance visionary thinking with practical considerations
-  - Inspire them to become thought leaders in their field