leo-claude-mktplace/mcp-servers/gitea/mcp_server/tools/wiki.py

"""
Wiki management tools for MCP server.

Provides async wrappers for wiki operations to support lessons learned:
- Page CRUD operations
- Lessons learned creation and search
- RFC number allocation
"""
import asyncio
import logging
import re
from typing import List, Dict, Optional

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)


class WikiTools:
    """Async wrappers for Gitea wiki operations"""

    def __init__(self, gitea_client):
        """
        Initialize wiki tools.

        Args:
            gitea_client: GiteaClient instance
        """
        self.gitea = gitea_client

    async def list_wiki_pages(self, repo: Optional[str] = None) -> List[Dict]:
        """List all wiki pages in repository."""
        loop = asyncio.get_event_loop()
        return await loop.run_in_executor(
            None,
            lambda: self.gitea.list_wiki_pages(repo)
        )

    async def get_wiki_page(
        self,
        page_name: str,
        repo: Optional[str] = None
    ) -> Dict:
        """Get a specific wiki page by name."""
        loop = asyncio.get_event_loop()
        return await loop.run_in_executor(
            None,
            lambda: self.gitea.get_wiki_page(page_name, repo)
        )

    async def create_wiki_page(
        self,
        title: str,
        content: str,
        repo: Optional[str] = None
    ) -> Dict:
        """Create a new wiki page."""
        loop = asyncio.get_event_loop()
        return await loop.run_in_executor(
            None,
            lambda: self.gitea.create_wiki_page(title, content, repo)
        )

    async def update_wiki_page(
        self,
        page_name: str,
        content: str,
        repo: Optional[str] = None
    ) -> Dict:
        """Update an existing wiki page."""
        loop = asyncio.get_event_loop()
        return await loop.run_in_executor(
            None,
            lambda: self.gitea.update_wiki_page(page_name, content, repo)
        )

    async def delete_wiki_page(
        self,
        page_name: str,
        repo: Optional[str] = None
    ) -> bool:
        """Delete a wiki page."""
        loop = asyncio.get_event_loop()
        return await loop.run_in_executor(
            None,
            lambda: self.gitea.delete_wiki_page(page_name, repo)
        )

    async def search_wiki_pages(
        self,
        query: str,
        repo: Optional[str] = None
    ) -> List[Dict]:
        """Search wiki pages by title."""
        loop = asyncio.get_event_loop()
        return await loop.run_in_executor(
            None,
            lambda: self.gitea.search_wiki_pages(query, repo)
        )

    async def create_lesson(
        self,
        title: str,
        content: str,
        tags: List[str],
        category: str = "sprints",
        repo: Optional[str] = None
    ) -> Dict:
        """
        Create a lessons learned entry in the wiki.

        Args:
            title: Lesson title (e.g., "Sprint 16 - Prevent Infinite Loops")
            content: Lesson content in markdown
            tags: List of tags for categorization
            category: Category (sprints, patterns, architecture, etc.)
            repo: Repository in owner/repo format

        Returns:
            Created wiki page
        """
        loop = asyncio.get_event_loop()
        return await loop.run_in_executor(
            None,
            lambda: self.gitea.create_lesson(title, content, tags, category, repo)
        )

    async def search_lessons(
        self,
        query: Optional[str] = None,
        tags: Optional[List[str]] = None,
        limit: int = 20,
        repo: Optional[str] = None
    ) -> List[Dict]:
        """
        Search lessons learned from previous sprints.

        Args:
            query: Search query (optional)
            tags: Tags to filter by (optional)
            limit: Maximum results (default 20)
            repo: Repository in owner/repo format

        Returns:
            List of matching lessons
        """
        loop = asyncio.get_event_loop()
        results = await loop.run_in_executor(
            None,
            lambda: self.gitea.search_lessons(query, tags, repo)
        )
        return results[:limit]

    async def allocate_rfc_number(self, repo: Optional[str] = None) -> Dict:
        """
        Allocate the next available RFC number.

        Scans existing wiki pages for RFC-NNNN pattern and returns
        the next sequential number.

        Args:
            repo: Repository in owner/repo format

        Returns:
            Dict with 'next_number' (int) and 'formatted' (str like 'RFC-0001')
        """
        pages = await self.list_wiki_pages(repo)

        # Extract RFC numbers from page titles
        rfc_numbers = []
        rfc_pattern = re.compile(r'^RFC-(\d{4})')

        for page in pages:
            title = page.get('title', '')
            match = rfc_pattern.match(title)
            if match:
                rfc_numbers.append(int(match.group(1)))

        # Calculate next number
        if rfc_numbers:
            next_num = max(rfc_numbers) + 1
        else:
            next_num = 1

        return {
            'next_number': next_num,
            'formatted': f'RFC-{next_num:04d}'
        }