from .models.common import parse_docs_path
from .models.registry import DocsRegistry


def read_docs_markdown_path(registry: DocsRegistry, path: str) -> dict[str, str]:
    docs_path = parse_docs_path(path)
    if docs_path.parts[0] == "skills":
        raise KeyError(f"unknown docs path: {docs_path.as_posix()}")
    if docs_path not in registry.docs_markdown_by_path:
        raise KeyError(f"unknown docs path: {docs_path.as_posix()}")
    return {
        "uri": f"resource://docs/{docs_path.as_posix()}",
        "format": "markdown",
        "source_path": f"docs/{docs_path.as_posix()}",
        "content": registry.docs_markdown_by_path[docs_path],
    }