Skip to content

Codebase intelligence for AI and humans: code health scores, auto-generated docs, git analytics, dead code detection, and architectural decisions via MCP.

3.7 KB
Raw Blame
"""Unit tests for repowise MCP server tools.

Tests all 9 MCP tools using an in-memory SQLite database with pre-populated
test data, mirroring the conftest pattern from the REST API tests.
"""

from __future__ import annotations

import json

import pytest


@pytest.mark.asyncio
async def test_get_overview_prefers_curated_entry_points(setup_mcp, session):
    from repowise.core.persistence.models import KnowledgeGraphProjectMeta
    from repowise.server.mcp_server import get_overview

    # The fixture flags src/auth/service.py via the raw is_entry_point flag (a
    # high-pagerank sink). With a curated orientation list present, get_overview
    # must serve that instead of the flagged sink.
    session.add(
        KnowledgeGraphProjectMeta(
            repository_id="repo1",
            entry_points_json=json.dumps(["src/cli/main.py"]),
            entry_candidates_json=json.dumps(["src/cli/main.py"]),
        )
    )
    await session.commit()

    result = await get_overview()
    assert result["entry_points"] == ["src/cli/main.py"]


@pytest.mark.asyncio
async def test_get_overview(setup_mcp):
    from repowise.server.mcp_server import get_overview

    result = await get_overview()
    assert result["title"] == "Test Repo Overview"
    assert "comprehensive test" in result["content_md"]
    assert "architecture_diagram_mermaid" not in result  # removed: not useful for agents
    assert len(result["key_modules"]) == 2
    assert any(m["name"] == "Auth Module" for m in result["key_modules"])
    assert "src/auth/service.py" in result["entry_points"]


@pytest.mark.asyncio
async def test_get_overview_with_repo_path(setup_mcp, tmp_path):
    from repowise.server.mcp_server import get_overview

    result = await get_overview(repo=str(tmp_path))
    assert result["title"] == "Test Repo Overview"


@pytest.mark.asyncio
async def test_get_overview_repo_not_found(setup_mcp):
    from repowise.server.mcp_server import get_overview

    with pytest.raises(LookupError, match="not found"):
        await get_overview(repo="/nonexistent")


_GATED_KEYS = {
    "outline": "outline",
    "tour": "guided_tour",
    "decisions": "key_decisions",
    "graph": "community_summary",
    "ownership": "knowledge_map",
}


@pytest.mark.asyncio
async def test_default_overview_omits_every_gated_block(setup_mcp):
    from repowise.server.mcp_server import get_overview

    result = await get_overview()
    for key in (*_GATED_KEYS.values(), "reading_order", "outline_hint"):
        assert key not in result, f"{key} should be opt-in"
    assert "include=[" in result["more"]


@pytest.mark.asyncio
async def test_orientation_blocks_carry_no_prose(setup_mcp):
    from repowise.server.mcp_server import get_overview

    result = await get_overview()
    assert result["key_modules"]
    assert all("description" not in m for m in result["key_modules"])
    for layer in result.get("architecture", {}).get("layers", []):
        assert "description" not in layer


@pytest.mark.asyncio
@pytest.mark.parametrize(
    ("flag", "key"),
    [("tour", "reading_order"), ("graph", "community_summary"), ("ownership", "knowledge_map")],
)
async def test_include_flag_restores_its_block(setup_mcp, flag, key):
    from repowise.server.mcp_server import get_overview

    assert key in await get_overview(include=[flag])


@pytest.mark.asyncio
async def test_an_unknown_include_value_is_named_not_silently_dropped(setup_mcp):
    from repowise.server.mcp_server import get_overview

    result = await get_overview(include=["tour", "outlines"])
    assert "reading_order" in result
    [entry] = result["ignored_arguments"]
    assert entry["argument"] == "include" and entry["values"] == ["outlines"]
    assert "outline" in entry["valid"]
    assert "ignored_arguments" not in await get_overview(include=["tour"])