pyi fixes

- Add MCPRenderer to generate MCP-native JSON bundles (index.json, nav.json, modules/*.json)
- Expose MCPRenderer via public API and CLI (`generate-mcp` command)
- Replace Markdown-based MCP output with structured JSON resources
- Update MCP renderer type stubs to match new JSON-based implementation
- Refactor MCP tests to validate JSON content, bundle structure, and navigation
- Fix MCP module coverage test to use explicit project_root for reliable discovery

README.md

@@ -56,7 +56,7 @@ doc-forge server mypackage
 ### Python API
 
 ```python
-from docforge.loader import GriffeLoader
+from docforge.loaders import GriffeLoader
 from docforge.renderers import MkDocsRenderer
 from pathlib import Path
 
@@ -70,6 +70,7 @@ renderer.generate_sources(project, Path("docs"))
 
 # Build final documentation
 from docforge.renderers.base import RendererConfig
+
 config = RendererConfig(Path("docs"), project)
 renderer.build(config)
 ```

docforge.nav.yml

@@ -1,13 +1,13 @@
 home: docforge/index.md
 groups:
-  Loader:
+  Loaders:
-    - docforge/loader/index.md
+    - docforge/loaders/index.md
-    - docforge/loader/griffe_loader.md
+    - docforge/loaders/griffe_loader.md
-  Model:
+  Models:
-    - docforge/model/index.md
+    - docforge/models/index.md
-    - docforge/model/module.md
+    - docforge/models/module.md
-    - docforge/model/object.md
+    - docforge/models/object.md
-    - docforge/model/project.md
+    - docforge/models/project.md
   Navigation:
     - docforge/nav/index.md
     - docforge/nav/spec.md
@@ -16,7 +16,8 @@ groups:
   Renderers:
     - docforge/renderers/index.md
     - docforge/renderers/base.md
-    - docforge/renderers/mkdocs.md
+    - docforge/renderers/mkdocs_renderer.md
+    - docforge/renderers/mcp_renderer.md
   CLI:
     - docforge/cli/index.md
     - docforge/cli/main.md

docforge/__init__.py

@@ -4,7 +4,7 @@
 `doc-forge` is a renderer-agnostic Python documentation compiler designed for
 speed, flexibility, and beautiful output. It decouples the introspection of
 your code from the rendering process, allowing you to generate documentation
-for various platforms (starting with MkDocs) from a single internal model.
+for various platforms (starting with MkDocs) from a single internal models.
 
 ## Installation
 
@@ -45,21 +45,22 @@ pip install doc-forge
 
 ## Project Structure
 
-- `docforge.loader`: Introspects source code using static analysis (`griffe`).
+- `docforge.loaders`: Introspects source code using static analysis (`griffe`).
-- `docforge.model`: The internal representation of your project, modules, and objects.
+- `docforge.models`: The internal representation of your project, modules, and objects.
-- `docforge.renderers`: Converters that turn the model into physical files.
+- `docforge.renderers`: Converters that turn the models into physical files.
 - `docforge.nav`: Managers for logical-to-physical path mapping and navigation.
 """
 
-from .loader import GriffeLoader, discover_module_paths
+from .loaders import GriffeLoader, discover_module_paths
-from .renderers import MkDocsRenderer
+from .renderers import MkDocsRenderer, MCPRenderer
 from .cli import main
-from . import model
+from . import models
 
 __all__ = [
     "GriffeLoader",
     "discover_module_paths",
     "MkDocsRenderer",
-    "model",
+    "MCPRenderer",
+    "models",
     "main",
 ]

docforge/__init__.pyi

@@ -1,12 +1,13 @@
-from .loader import GriffeLoader, discover_module_paths
+from .loaders import GriffeLoader, discover_module_paths
-from .renderers import MkDocsRenderer
+from .renderers import MkDocsRenderer, MCPRenderer
 from .cli import main
-from . import model
+from . import models
 
 __all__ = [
     "GriffeLoader",
     "discover_module_paths",
     "MkDocsRenderer",
-    "model",
+    "MCPRenderer",
+    "models",
     "main",
 ]

docforge/cli/main.py

@@ -8,8 +8,8 @@ from typing import Sequence, Optional
 
 import click
 
-from docforge.loader import GriffeLoader, discover_module_paths
+from docforge.loaders import GriffeLoader, discover_module_paths
-from docforge.renderers.mkdocs import MkDocsRenderer
+from docforge.renderers import MkDocsRenderer, MCPRenderer
 from docforge.cli.mkdocs import mkdocs_cmd
 
 
@@ -118,6 +118,52 @@ def generate(
     click.echo(f"Documentation sources generated in {docs_dir}")
 
 
+# ---------------------------------------------------------------------
+# mcp-build
+# ---------------------------------------------------------------------
+
+@cli.command(name="generate-mcp")
+@click.option(
+    "--module",
+    required=True,
+    help="Python module import path to document",
+)
+@click.option(
+    "--project-name",
+    help="Project name (defaults to first module)",
+)
+@click.option(
+    "--out-dir",
+    type=click.Path(path_type=Path),
+    default=Path("mcp_docs"),
+)
+def generate_mcp(
+    module: str,
+    project_name: str | None,
+    out_dir: Path,
+) -> None:
+    """
+    Generate MCP-compatible documentation resources for the specified module.
+
+    Args:
+        module: The primary module path to document.
+        project_name: Optional project name override.
+        out_dir: Directory where MCP resources will be written.
+    """
+    loader = GriffeLoader()
+    discovered_paths = discover_module_paths(module)
+
+    project = loader.load_project(
+        discovered_paths,
+        project_name,
+    )
+
+    renderer = MCPRenderer()
+    renderer.generate_sources(project, out_dir)
+
+    click.echo(f"MCP documentation resources generated in {out_dir}")
+
+
 # ---------------------------------------------------------------------
 # build
 # ---------------------------------------------------------------------
@@ -146,6 +192,40 @@ def build(mkdocs_yml: Path) -> None:
     click.echo("MkDocs build completed")
 
 
+# ---------------------------------------------------------------------
+# serve-mcp
+# ---------------------------------------------------------------------
+
+@cli.command(name="serve-mcp")
+def serve_mcp() -> None:
+    """
+    Serve MCP documentation from the local mcp_docs directory.
+    """
+    from docforge.servers import MCPServer
+
+    mcp_root = Path.cwd() / "mcp_docs"
+
+    if not mcp_root.exists():
+        raise click.ClickException("mcp_docs directory not found")
+
+    required = [
+        mcp_root / "index.json",
+        mcp_root / "nav.json",
+        mcp_root / "modules",
+    ]
+
+    for path in required:
+        if not path.exists():
+            raise click.ClickException(f"Invalid MCP bundle, missing: {path.name}")
+
+    server = MCPServer(
+        mcp_root=mcp_root,
+        name="doc-forge-mcp",
+    )
+
+    server.run()
+
+
 # ---------------------------------------------------------------------
 # serve
 # ---------------------------------------------------------------------

docforge/cli/main.pyi

@@ -47,6 +47,34 @@ def generate(
 ) -> None:
     """Generate documentation source files using MkDocs renderer."""
 
+@cli.command(name="generate-mcp")
+@click.option(
+    "--module",
+    required=True,
+    help="Python module import path to document",
+)
+@click.option(
+    "--project-name",
+    help="Project name (defaults to first module)",
+)
+@click.option(
+    "--out-dir",
+    type=click.Path(path_type=Path),
+    default=Path("mcp_docs"),
+)
+def generate_mcp(
+    module: str,
+    project_name: str | None,
+    out_dir: Path,
+) -> None:
+    """
+    Generate MCP-compatible documentation resources for the specified module.
+
+    Args:
+        module: The primary module path to document.
+        project_name: Optional project name override.
+        out_dir: Directory where MCP resources will be written.
+    """
 
 @cli.command()
 @click.option(
@@ -72,5 +100,10 @@ def serve(
     """Serve documentation using MkDocs."""
 
 
+@cli.command(name="serve-mcp")
+def serve_mcp() -> None:
+    """Serve MCP documentation."""
+
+
 def main() -> None:
     """CLI entry point."""

docforge/loaders/__init__.py

@@ -1,7 +1,7 @@
 """
 # Loader Layer
 
-The `docforge.loader` package is responsible for discovering Python source files
+The `docforge.loaders` package is responsible for discovering Python source files
 and extracting their documentation using static analysis.
 
 ## Core Features

docforge/loaders/griffe_loader.py

@@ -1,6 +1,6 @@
 """
 This module provides the GriffeLoader, which uses the 'griffe' library to
-introspect Python source code and populate the doc-forge Project model.
+introspect Python source code and populate the doc-forge Project models.
 """
 
 import logging
@@ -15,7 +15,7 @@ from griffe import (
     AliasResolutionError,
 )
 
-from docforge.model import Module, Project, DocObject
+from docforge.models import Module, Project, DocObject
 
 logger = logging.getLogger(__name__)
 
@@ -83,7 +83,7 @@ class GriffeLoader:
         skip_import_errors: bool = None,
     ) -> Project:
         """
-        Load multiple modules and combine them into a single Project model.
+        Load multiple modules and combine them into a single Project models.
 
         Args:
             module_paths: A list of dotted paths to the modules to load.
@@ -116,7 +116,7 @@ class GriffeLoader:
 
     def load_module(self, path: str) -> Module:
         """
-        Load a single module and convert its introspection data into the docforge model.
+        Load a single module and convert its introspection data into the docforge models.
 
         Args:
             path: The dotted path of the module to load.

docforge/loaders/griffe_loader.pyi

@@ -1,7 +1,7 @@
 from typing import List, Optional
 from pathlib import Path
 
-from docforge.model import Module, Project
+from docforge.models import Module, Project
 
 
 def discover_module_paths(
@@ -12,7 +12,7 @@ def discover_module_paths(
 
 
 class GriffeLoader:
-    """Griffe-based introspection loader.
+    """Griffe-based introspection loaders.
 
     This is the only supported introspection backend in doc-forge.
     """

docforge/models/__init__.py

@@ -1,7 +1,7 @@
 """
 # Model Layer
 
-The `docforge.model` package provides the core data structures used to represent
+The `docforge.models` package provides the core data structures used to represent
 Python source code in a documentation-focused hierarchy.
 
 ## Key Components

docforge/models/module.py

@@ -1,12 +1,12 @@
 """
 This module defines the Module class, which represents a Python module or package
-in the doc-forge documentation model. It acts as a container for top-level
+in the doc-forge documentation models. It acts as a container for top-level
 documented objects.
 """
 
 from typing import Dict, Iterable, Optional
 
-from docforge.model.object import DocObject
+from docforge.models.object import DocObject
 
 
 class Module:

docforge/models/module.pyi

@@ -1,6 +1,6 @@
 from typing import Dict, Iterable, Optional
 
-from docforge.model.object import DocObject
+from docforge.models.object import DocObject
 
 
 class Module:

docforge/models/object.py

@@ -1,6 +1,6 @@
 """
 This module defines the DocObject class, the fundamental recursive unit of the
-doc-forge documentation model. A DocObject represents a single Python entity
+doc-forge documentation models. A DocObject represents a single Python entity
 (class, function, method, or attribute) and its nested members.
 """
 

docforge/models/project.py

@@ -5,7 +5,7 @@ project. It aggregates multiple Module instances into a single named entity.
 
 from typing import Dict, Iterable
 
-from docforge.model.module import Module
+from docforge.models.module import Module
 
 
 class Project:

docforge/models/project.pyi

@@ -1,6 +1,6 @@
 from typing import Dict, Iterable
 
-from docforge.model.module import Module
+from docforge.models.module import Module
 
 
 class Project:

docforge/renderers/__init__.py

@@ -2,7 +2,7 @@
 # Renderers Layer
 
 The `docforge.renderers` package handles the transformation of the internal
-documentation model into physical files formatted for specific documentation
+documentation models into physical files formatted for specific documentation
 engines.
 
 ## Current Implementations
@@ -17,8 +17,10 @@ To add a new renderer, implement the `DocRenderer` protocol defined in
 `docforge.renderers.base`.
 """
 
-from .mkdocs import MkDocsRenderer
+from .mkdocs_renderer import MkDocsRenderer
+from .mcp_renderer import MCPRenderer
 
 __all__ = [
     "MkDocsRenderer",
+    "MCPRenderer",
 ]

docforge/renderers/__init__.pyi

@@ -1,5 +1,7 @@
-from .mkdocs import MkDocsRenderer
+from .mkdocs_renderer import MkDocsRenderer
+from .mcp_renderer import MCPRenderer
 
 __all__ = [
     "MkDocsRenderer",
+    "MCPRenderer",
 ]

docforge/renderers/base.py

@@ -7,7 +7,7 @@ DocRenderer protocol.
 from pathlib import Path
 from typing import Protocol
 
-from docforge.model import Project
+from docforge.models import Project
 
 
 class RendererConfig:
@@ -16,7 +16,7 @@ class RendererConfig:
 
     Args:
         out_dir: The directory where documentation files should be written.
-        project: The introspected project model to be rendered.
+        project: The introspected project models to be rendered.
     """
 
     def __init__(self, out_dir: Path, project: Project) -> None:
@@ -40,7 +40,7 @@ class DocRenderer(Protocol):
         Generate renderer-specific source files for the given project.
 
         Args:
-            project: The project model containing modules and objects.
+            project: The project models containing modules and objects.
             out_dir: Target directory for the generated files.
         """
         ...

docforge/renderers/base.pyi

@@ -1,7 +1,7 @@
 from pathlib import Path
 from typing import Protocol
 
-from docforge.model import Project
+from docforge.models import Project
 
 
 class RendererConfig:

docforge/renderers/mcp_renderer.py

@@ -0,0 +1,102 @@
+import json
+from pathlib import Path
+from typing import Dict, List
+
+from docforge.models import Project, Module, DocObject
+
+
+class MCPRenderer:
+    """
+    Renderer that emits MCP-native JSON resources from docforge models.
+    """
+
+    name = "mcp"
+
+    def generate_sources(self, project: Project, out_dir: Path) -> None:
+        """
+        Generate MCP-compatible JSON resources and navigation for the project.
+        """
+        modules_dir = out_dir / "modules"
+        modules_dir.mkdir(parents=True, exist_ok=True)
+
+        nav: List[Dict[str, str]] = []
+
+        for module in project.get_all_modules():
+            self._write_module(module, modules_dir)
+
+            nav.append({
+                "module": module.path,
+                "resource": f"doc://modules/{module.path}",
+            })
+
+        # Write nav.json
+        (out_dir / "nav.json").write_text(
+            self._json(nav),
+            encoding="utf-8",
+        )
+
+        # Write index.json
+        index = {
+            "project": project.name,
+            "type": "docforge-model",
+            "modules_count": len(nav),
+            "source": "docforge",
+        }
+
+        (out_dir / "index.json").write_text(
+            self._json(index),
+            encoding="utf-8",
+        )
+
+    def _write_module(self, module: Module, modules_dir: Path) -> None:
+        """
+        Serialize a module into an MCP JSON resource.
+        """
+        payload = {
+            "module": module.path,
+            "content": self._render_module(module),
+        }
+
+        out = modules_dir / f"{module.path}.json"
+        out.parent.mkdir(parents=True, exist_ok=True)
+        out.write_text(self._json(payload), encoding="utf-8")
+
+    def _render_module(self, module: Module) -> Dict:
+        """
+        Render a Module into MCP-friendly structured data.
+        """
+        data: Dict = {
+            "path": module.path,
+            "docstring": module.docstring,
+            "objects": {},
+        }
+
+        for obj in module.get_all_objects():
+            data["objects"][obj.name] = self._render_object(obj)
+
+        return data
+
+    def _render_object(self, obj: DocObject) -> Dict:
+        """
+        Recursively render a DocObject into structured MCP data.
+        """
+        data: Dict = {
+            "name": obj.name,
+            "kind": obj.kind,
+            "path": obj.path,
+            "signature": obj.signature,
+            "docstring": obj.docstring,
+        }
+
+        members = list(obj.get_all_members())
+        if members:
+            data["members"] = {
+                member.name: self._render_object(member)
+                for member in members
+            }
+
+        return data
+
+    @staticmethod
+    def _json(data: Dict) -> str:
+        return json.dumps(data, indent=2, ensure_ascii=False)

docforge/renderers/mcp_renderer.pyi

@@ -0,0 +1,26 @@
+from pathlib import Path
+from typing import Dict, List
+
+from docforge.models import Project, Module, DocObject
+
+
+class MCPRenderer:
+    """Renderer that emits MCP-native JSON resources from docforge models."""
+
+    name: str
+
+    def generate_sources(self, project: Project, out_dir: Path) -> None:
+        """Generate MCP-compatible JSON resources and navigation for the project."""
+
+    def _write_module(self, module: Module, modules_dir: Path) -> None:
+        """Serialize a module into an MCP JSON resource."""
+
+    def _render_module(self, module: Module) -> Dict:
+        """Render a Module into MCP-friendly structured data."""
+
+    def _render_object(self, obj: DocObject) -> Dict:
+        """Recursively render a DocObject into structured MCP data."""
+
+    @staticmethod
+    def _json(data: Dict) -> str:
+        """Serialize structured data to formatted JSON."""

docforge/renderers/mkdocs_renderer.py

@@ -5,7 +5,7 @@ compatible with the MkDocs 'material' theme and 'mkdocstrings' extension.
 
 from pathlib import Path
 
-from docforge.model import Project
+from docforge.models import Project
 
 
 class MkDocsRenderer:
@@ -19,10 +19,10 @@ class MkDocsRenderer:
     def generate_sources(self, project: Project, out_dir: Path) -> None:
         """
         Produce a set of Markdown files in the output directory based on the
-        provided Project model.
+        provided Project models.
 
         Args:
-            project: The project model to render.
+            project: The project models to render.
             out_dir: Target directory for documentation files.
         """
         modules = list(project.get_all_modules())

docforge/renderers/mkdocs_renderer.pyi

@@ -1,7 +1,7 @@
 from pathlib import Path
 from typing import Set
 
-from docforge.model import Project, Module
+from docforge.models import Project, Module
 
 
 class MkDocsRenderer:

docforge/servers/__init__.py

@@ -0,0 +1,5 @@
+from .mcp_server import MCPServer
+
+__all__ = [
+    "MCPServer",
+]

docforge/servers/__init__.pyi

@@ -0,0 +1,5 @@
+from .mcp_server import MCPServer
+
+__all__ = [
+    "MCPServer",
+]

docforge/servers/mcp_server.py

@@ -0,0 +1,73 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Any, Literal
+
+from mcp.server.fastmcp import FastMCP
+
+
+class MCPServer:
+    """
+    MCP server for serving a pre-built MCP documentation bundle.
+    """
+
+    def __init__(self, mcp_root: Path, name: str) -> None:
+        self.mcp_root = mcp_root
+        self.app = FastMCP(name)
+
+        self._register_resources()
+        self._register_tools()
+
+    # ------------------------------------------------------------------
+    # Internal helpers
+    # ------------------------------------------------------------------
+
+    def _read_json(self, path: Path) -> Any:
+        if not path.exists():
+            return {
+                "error": "not_found",
+                "path": str(path),
+            }
+        return json.loads(path.read_text(encoding="utf-8"))
+
+    # ------------------------------------------------------------------
+    # MCP resources
+    # ------------------------------------------------------------------
+
+    def _register_resources(self) -> None:
+        @self.app.resource("docs://index")
+        def index():
+            return self._read_json(self.mcp_root / "index.json")
+
+        @self.app.resource("docs://nav")
+        def nav():
+            return self._read_json(self.mcp_root / "nav.json")
+
+        @self.app.resource("docs://modules/{module}")
+        def module(module: str):
+            return self._read_json(
+                self.mcp_root / "modules" / f"{module}.json"
+            )
+
+    # ------------------------------------------------------------------
+    # MCP tools (optional / diagnostic)
+    # ------------------------------------------------------------------
+
+    def _register_tools(self) -> None:
+        @self.app.tool()
+        def ping() -> str:
+            return "pong"
+
+    # ------------------------------------------------------------------
+    # Server lifecycle
+    # ------------------------------------------------------------------
+
+    def run(self, transport: Literal["stdio", "sse", "streamable-http"] = "streamable-http") -> None:
+        """
+        Start the MCP server.
+
+        Args:
+            transport: MCP transport (default: streamable-http)
+        """
+        self.app.run(transport=transport)

docforge/servers/mcp_server.pyi

@@ -0,0 +1,22 @@
+from pathlib import Path
+from typing import Literal, Any
+
+from mcp.server.fastmcp import FastMCP
+
+
+class MCPServer:
+    """MCP server for serving documentation."""
+
+    mcp_root: Path
+    app: FastMCP
+
+    def __init__(self, mcp_root: Path, name: str) -> None: ...
+
+    def _read_json(self, path: Path) -> Any: ...
+
+    def _register_resources(self) -> None: ...
+
+    def _register_tools(self) -> None: ...
+
+    def run(self, transport: Literal["stdio", "sse", "streamable-http"] = ...) -> None:
+        """Start the MCP server."""

docs/docforge/loader/griffe_loader.md

@@ -1,3 +0,0 @@
-# Griffe Loader
-
-::: docforge.loader.griffe_loader

docs/docforge/loader/index.md

@@ -1,3 +0,0 @@
-# Loader
-
-::: docforge.loader

docs/docforge/loaders/griffe_loader.md

@@ -0,0 +1,3 @@
+# Griffe Loader
+
+::: docforge.loaders.griffe_loader

docs/docforge/loaders/index.md

@@ -0,0 +1,3 @@
+# Loaders
+
+::: docforge.loaders

docs/docforge/model/index.md

@@ -1,3 +0,0 @@
-# Model
-
-::: docforge.model

docs/docforge/model/module.md

@@ -1,3 +0,0 @@
-# Module
-
-::: docforge.model.module

docs/docforge/model/object.md

@@ -1,3 +0,0 @@
-# Object
-
-::: docforge.model.object

docs/docforge/model/project.md

@@ -1,3 +0,0 @@
-# Project
-
-::: docforge.model.project

docs/docforge/models/index.md

@@ -0,0 +1,3 @@
+# Models
+
+::: docforge.models

docs/docforge/models/module.md

@@ -0,0 +1,3 @@
+# Module
+
+::: docforge.models.module

docs/docforge/models/object.md

@@ -0,0 +1,3 @@
+# Object
+
+::: docforge.models.object

docs/docforge/models/project.md

@@ -0,0 +1,3 @@
+# Project
+
+::: docforge.models.project

docs/docforge/renderers/mcp_renderer.md

@@ -0,0 +1,3 @@
+# Mcp Renderer
+
+::: docforge.renderers.mcp_renderer

docs/docforge/renderers/mkdocs.md

@@ -1,3 +0,0 @@
-# Mkdocs
-
-::: docforge.renderers.mkdocs

docs/docforge/renderers/mkdocs_renderer.md

@@ -0,0 +1,3 @@
+# Mkdocs Renderer
+
+::: docforge.renderers.mkdocs_renderer

mcp_docs/index.json

@@ -0,0 +1,6 @@
+{
+  "project": "docforge",
+  "type": "docforge-model",
+  "modules_count": 20,
+  "source": "docforge"
+}

mcp_docs/modules/docforge.cli.json

@@ -0,0 +1,280 @@
+{
+  "module": "docforge.cli",
+  "content": {
+    "path": "docforge.cli",
+    "docstring": "# CLI Layer\n\nThe `docforge.cli` package provides the command-line interface for interacting\nwith doc-forge.\n\n## Available Commands\n\n- **tree**: Visualize the introspected project structure.\n- **generate**: Create Markdown source files from Python code.\n- **mkdocs**: Generate the primary `mkdocs.yml` configuration.\n- **build**: Build the final documentation site.\n- **serve**: Launch a local development server with live-reloading.",
+    "objects": {
+      "main": {
+        "name": "main",
+        "kind": "module",
+        "path": "docforge.cli.main",
+        "signature": null,
+        "docstring": "Main entry point for the doc-forge CLI. This module defines the core command\ngroup and the 'tree', 'generate', 'build', and 'serve' commands.",
+        "members": {
+          "Path": {
+            "name": "Path",
+            "kind": "alias",
+            "path": "docforge.cli.main.Path",
+            "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+            "docstring": null
+          },
+          "Sequence": {
+            "name": "Sequence",
+            "kind": "alias",
+            "path": "docforge.cli.main.Sequence",
+            "signature": "<bound method Alias.signature of Alias('Sequence', 'typing.Sequence')>",
+            "docstring": null
+          },
+          "Optional": {
+            "name": "Optional",
+            "kind": "alias",
+            "path": "docforge.cli.main.Optional",
+            "signature": "<bound method Alias.signature of Alias('Optional', 'typing.Optional')>",
+            "docstring": null
+          },
+          "click": {
+            "name": "click",
+            "kind": "alias",
+            "path": "docforge.cli.main.click",
+            "signature": "<bound method Alias.signature of Alias('click', 'click')>",
+            "docstring": null
+          },
+          "GriffeLoader": {
+            "name": "GriffeLoader",
+            "kind": "class",
+            "path": "docforge.cli.main.GriffeLoader",
+            "signature": "<bound method Alias.signature of Alias('GriffeLoader', 'docforge.loaders.GriffeLoader')>",
+            "docstring": "Loads Python modules and extracts documentation using the Griffe introspection engine.",
+            "members": {
+              "load_project": {
+                "name": "load_project",
+                "kind": "function",
+                "path": "docforge.cli.main.GriffeLoader.load_project",
+                "signature": "<bound method Alias.signature of Alias('load_project', 'docforge.loaders.griffe_loader.GriffeLoader.load_project')>",
+                "docstring": "Load multiple modules and combine them into a single Project models.\n\nArgs:\n    module_paths: A list of dotted paths to the modules to load.\n    project_name: Optional name for the project. Defaults to the first module name.\n    skip_import_errors: If True, modules that fail to import will be skipped.\n\nReturns:\n    A Project instance containing the loaded modules."
+              },
+              "load_module": {
+                "name": "load_module",
+                "kind": "function",
+                "path": "docforge.cli.main.GriffeLoader.load_module",
+                "signature": "<bound method Alias.signature of Alias('load_module', 'docforge.loaders.griffe_loader.GriffeLoader.load_module')>",
+                "docstring": "Load a single module and convert its introspection data into the docforge models.\n\nArgs:\n    path: The dotted path of the module to load.\n\nReturns:\n    A Module instance."
+              }
+            }
+          },
+          "discover_module_paths": {
+            "name": "discover_module_paths",
+            "kind": "function",
+            "path": "docforge.cli.main.discover_module_paths",
+            "signature": "<bound method Alias.signature of Alias('discover_module_paths', 'docforge.loaders.discover_module_paths')>",
+            "docstring": "Discover all Python modules under a package via filesystem traversal.\n\nRules:\n- Directory with __init__.py is treated as a package.\n- Any .py file is treated as a module.\n- All paths are converted to dotted module paths.\n\nArgs:\n    module_name: The name of the package to discover.\n    project_root: The root directory of the project. Defaults to current working directory.\n\nReturns:\n    A sorted list of dotted module paths."
+          },
+          "MkDocsRenderer": {
+            "name": "MkDocsRenderer",
+            "kind": "class",
+            "path": "docforge.cli.main.MkDocsRenderer",
+            "signature": "<bound method Alias.signature of Alias('MkDocsRenderer', 'docforge.renderers.MkDocsRenderer')>",
+            "docstring": "Renderer that generates Markdown source files formatted for the MkDocs\n'mkdocstrings' plugin.",
+            "members": {
+              "name": {
+                "name": "name",
+                "kind": "attribute",
+                "path": "docforge.cli.main.MkDocsRenderer.name",
+                "signature": "<bound method Alias.signature of Alias('name', 'docforge.renderers.mkdocs_renderer.MkDocsRenderer.name')>",
+                "docstring": null
+              },
+              "generate_sources": {
+                "name": "generate_sources",
+                "kind": "function",
+                "path": "docforge.cli.main.MkDocsRenderer.generate_sources",
+                "signature": "<bound method Alias.signature of Alias('generate_sources', 'docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_sources')>",
+                "docstring": "Produce a set of Markdown files in the output directory based on the\nprovided Project models.\n\nArgs:\n    project: The project models to render.\n    out_dir: Target directory for documentation files."
+              }
+            }
+          },
+          "MCPRenderer": {
+            "name": "MCPRenderer",
+            "kind": "class",
+            "path": "docforge.cli.main.MCPRenderer",
+            "signature": "<bound method Alias.signature of Alias('MCPRenderer', 'docforge.renderers.MCPRenderer')>",
+            "docstring": "Renderer that emits MCP-native JSON resources from docforge models.",
+            "members": {
+              "name": {
+                "name": "name",
+                "kind": "attribute",
+                "path": "docforge.cli.main.MCPRenderer.name",
+                "signature": "<bound method Alias.signature of Alias('name', 'docforge.renderers.mcp_renderer.MCPRenderer.name')>",
+                "docstring": null
+              },
+              "generate_sources": {
+                "name": "generate_sources",
+                "kind": "function",
+                "path": "docforge.cli.main.MCPRenderer.generate_sources",
+                "signature": "<bound method Alias.signature of Alias('generate_sources', 'docforge.renderers.mcp_renderer.MCPRenderer.generate_sources')>",
+                "docstring": "Generate MCP-compatible JSON resources and navigation for the project."
+              }
+            }
+          },
+          "mkdocs_cmd": {
+            "name": "mkdocs_cmd",
+            "kind": "function",
+            "path": "docforge.cli.main.mkdocs_cmd",
+            "signature": "<bound method Alias.signature of Alias('mkdocs_cmd', 'docforge.cli.mkdocs.mkdocs_cmd')>",
+            "docstring": "Generate an mkdocs.yml configuration file by combining a template with\nthe navigation structure resolved from a docforge.nav.yml file.\n\nArgs:\n    docs_dir: Path to the directory containing documentation Markdown files.\n    nav_file: Path to the docforge.nav.yml specification.\n    template: Optional path to an mkdocs.yml template.\n    out: Path where the final mkdocs.yml will be written.\n    site_name: The name of the documentation site."
+          },
+          "cli": {
+            "name": "cli",
+            "kind": "function",
+            "path": "docforge.cli.main.cli",
+            "signature": "<bound method Function.signature of Function('cli', 16, 22)>",
+            "docstring": "doc-forge CLI: A tool for introspecting Python projects and generating\ndocumentation."
+          },
+          "tree": {
+            "name": "tree",
+            "kind": "function",
+            "path": "docforge.cli.main.tree",
+            "signature": "<bound method Function.signature of Function('tree', 31, 62)>",
+            "docstring": "Visualize the project structure including modules and their members.\n\nArgs:\n    modules: List of module paths to introspect.\n    project_name: Optional project name override."
+          },
+          "generate": {
+            "name": "generate",
+            "kind": "function",
+            "path": "docforge.cli.main.generate",
+            "signature": "<bound method Function.signature of Function('generate', 78, 118)>",
+            "docstring": "Generate Markdown source files for the specified module.\n\nArgs:\n    module: The primary module path to document.\n    project_name: Optional project name override.\n    docs_dir: Directory where documentation sources will be written."
+          },
+          "generate_mcp": {
+            "name": "generate_mcp",
+            "kind": "function",
+            "path": "docforge.cli.main.generate_mcp",
+            "signature": "<bound method Function.signature of Function('generate_mcp', 125, 164)>",
+            "docstring": "Generate MCP-compatible documentation resources for the specified module.\n\nArgs:\n    module: The primary module path to document.\n    project_name: Optional project name override.\n    out_dir: Directory where MCP resources will be written."
+          },
+          "build": {
+            "name": "build",
+            "kind": "function",
+            "path": "docforge.cli.main.build",
+            "signature": "<bound method Function.signature of Function('build', 171, 192)>",
+            "docstring": "Build the documentation site using MkDocs.\n\nArgs:\n    mkdocs_yml: Path to the mkdocs.yml configuration file."
+          },
+          "serve_mcp": {
+            "name": "serve_mcp",
+            "kind": "function",
+            "path": "docforge.cli.main.serve_mcp",
+            "signature": "<bound method Function.signature of Function('serve_mcp', 199, 226)>",
+            "docstring": "Serve MCP documentation from the local mcp_docs directory."
+          },
+          "serve": {
+            "name": "serve",
+            "kind": "function",
+            "path": "docforge.cli.main.serve",
+            "signature": "<bound method Function.signature of Function('serve', 233, 256)>",
+            "docstring": "Serve the documentation site with live-reload using MkDocs.\n\nArgs:\n    mkdocs_yml: Path to the mkdocs.yml configuration file."
+          },
+          "main": {
+            "name": "main",
+            "kind": "function",
+            "path": "docforge.cli.main.main",
+            "signature": "<bound method Function.signature of Function('main', 263, 267)>",
+            "docstring": "CLI Entry point."
+          }
+        }
+      },
+      "mkdocs": {
+        "name": "mkdocs",
+        "kind": "module",
+        "path": "docforge.cli.mkdocs",
+        "signature": null,
+        "docstring": "This module contains the 'mkdocs' CLI command, which orchestrates the generation\nof the main mkdocs.yml configuration file.",
+        "members": {
+          "Path": {
+            "name": "Path",
+            "kind": "alias",
+            "path": "docforge.cli.mkdocs.Path",
+            "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+            "docstring": null
+          },
+          "resources": {
+            "name": "resources",
+            "kind": "alias",
+            "path": "docforge.cli.mkdocs.resources",
+            "signature": "<bound method Alias.signature of Alias('resources', 'importlib.resources')>",
+            "docstring": null
+          },
+          "click": {
+            "name": "click",
+            "kind": "alias",
+            "path": "docforge.cli.mkdocs.click",
+            "signature": "<bound method Alias.signature of Alias('click', 'click')>",
+            "docstring": null
+          },
+          "yaml": {
+            "name": "yaml",
+            "kind": "alias",
+            "path": "docforge.cli.mkdocs.yaml",
+            "signature": "<bound method Alias.signature of Alias('yaml', 'yaml')>",
+            "docstring": null
+          },
+          "load_nav_spec": {
+            "name": "load_nav_spec",
+            "kind": "function",
+            "path": "docforge.cli.mkdocs.load_nav_spec",
+            "signature": "<bound method Alias.signature of Alias('load_nav_spec', 'docforge.nav.load_nav_spec')>",
+            "docstring": "Utility function to load a NavSpec from a file.\n\nArgs:\n    path: Path to the navigation specification file.\n\nReturns:\n    A loaded NavSpec instance."
+          },
+          "resolve_nav": {
+            "name": "resolve_nav",
+            "kind": "function",
+            "path": "docforge.cli.mkdocs.resolve_nav",
+            "signature": "<bound method Alias.signature of Alias('resolve_nav', 'docforge.nav.resolve_nav')>",
+            "docstring": "Create a ResolvedNav by processing a NavSpec against the filesystem.\nThis expands globs and validates the existence of referenced files.\n\nArgs:\n    spec: The navigation specification to resolve.\n    docs_root: The root directory for documentation files.\n\nReturns:\n    A ResolvedNav instance.\n\nRaises:\n    FileNotFoundError: If a pattern doesn't match any files or the docs_root doesn't exist."
+          },
+          "MkDocsNavEmitter": {
+            "name": "MkDocsNavEmitter",
+            "kind": "class",
+            "path": "docforge.cli.mkdocs.MkDocsNavEmitter",
+            "signature": "<bound method Alias.signature of Alias('MkDocsNavEmitter', 'docforge.nav.MkDocsNavEmitter')>",
+            "docstring": "Emitter responsible for transforming a ResolvedNav into an MkDocs-compatible\nnavigation structure.",
+            "members": {
+              "emit": {
+                "name": "emit",
+                "kind": "function",
+                "path": "docforge.cli.mkdocs.MkDocsNavEmitter.emit",
+                "signature": "<bound method Alias.signature of Alias('emit', 'docforge.nav.mkdocs.MkDocsNavEmitter.emit')>",
+                "docstring": "Generate a list of navigation entries for mkdocs.yml.\n\nArgs:\n    nav: The resolved navigation data.\n\nReturns:\n    A list of dictionary mappings representing the MkDocs navigation."
+              }
+            }
+          },
+          "mkdocs_cmd": {
+            "name": "mkdocs_cmd",
+            "kind": "function",
+            "path": "docforge.cli.mkdocs.mkdocs_cmd",
+            "signature": "<bound method Function.signature of Function('mkdocs_cmd', 42, 116)>",
+            "docstring": "Generate an mkdocs.yml configuration file by combining a template with\nthe navigation structure resolved from a docforge.nav.yml file.\n\nArgs:\n    docs_dir: Path to the directory containing documentation Markdown files.\n    nav_file: Path to the docforge.nav.yml specification.\n    template: Optional path to an mkdocs.yml template.\n    out: Path where the final mkdocs.yml will be written.\n    site_name: The name of the documentation site."
+          },
+          "Any": {
+            "name": "Any",
+            "kind": "alias",
+            "path": "docforge.cli.mkdocs.Any",
+            "signature": "<bound method Alias.signature of Alias('Any', 'typing.Any')>",
+            "docstring": null
+          },
+          "Dict": {
+            "name": "Dict",
+            "kind": "alias",
+            "path": "docforge.cli.mkdocs.Dict",
+            "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+            "docstring": null
+          },
+          "Optional": {
+            "name": "Optional",
+            "kind": "alias",
+            "path": "docforge.cli.mkdocs.Optional",
+            "signature": "<bound method Alias.signature of Alias('Optional', 'typing.Optional')>",
+            "docstring": null
+          }
+        }
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.cli.main.json

@@ -0,0 +1,176 @@
+{
+  "module": "docforge.cli.main",
+  "content": {
+    "path": "docforge.cli.main",
+    "docstring": "Main entry point for the doc-forge CLI. This module defines the core command\ngroup and the 'tree', 'generate', 'build', and 'serve' commands.",
+    "objects": {
+      "Path": {
+        "name": "Path",
+        "kind": "alias",
+        "path": "docforge.cli.main.Path",
+        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+        "docstring": null
+      },
+      "Sequence": {
+        "name": "Sequence",
+        "kind": "alias",
+        "path": "docforge.cli.main.Sequence",
+        "signature": "<bound method Alias.signature of Alias('Sequence', 'typing.Sequence')>",
+        "docstring": null
+      },
+      "Optional": {
+        "name": "Optional",
+        "kind": "alias",
+        "path": "docforge.cli.main.Optional",
+        "signature": "<bound method Alias.signature of Alias('Optional', 'typing.Optional')>",
+        "docstring": null
+      },
+      "click": {
+        "name": "click",
+        "kind": "alias",
+        "path": "docforge.cli.main.click",
+        "signature": "<bound method Alias.signature of Alias('click', 'click')>",
+        "docstring": null
+      },
+      "GriffeLoader": {
+        "name": "GriffeLoader",
+        "kind": "class",
+        "path": "docforge.cli.main.GriffeLoader",
+        "signature": "<bound method Alias.signature of Alias('GriffeLoader', 'docforge.loaders.GriffeLoader')>",
+        "docstring": "Loads Python modules and extracts documentation using the Griffe introspection engine.",
+        "members": {
+          "load_project": {
+            "name": "load_project",
+            "kind": "function",
+            "path": "docforge.cli.main.GriffeLoader.load_project",
+            "signature": "<bound method Alias.signature of Alias('load_project', 'docforge.loaders.griffe_loader.GriffeLoader.load_project')>",
+            "docstring": "Load multiple modules and combine them into a single Project models.\n\nArgs:\n    module_paths: A list of dotted paths to the modules to load.\n    project_name: Optional name for the project. Defaults to the first module name.\n    skip_import_errors: If True, modules that fail to import will be skipped.\n\nReturns:\n    A Project instance containing the loaded modules."
+          },
+          "load_module": {
+            "name": "load_module",
+            "kind": "function",
+            "path": "docforge.cli.main.GriffeLoader.load_module",
+            "signature": "<bound method Alias.signature of Alias('load_module', 'docforge.loaders.griffe_loader.GriffeLoader.load_module')>",
+            "docstring": "Load a single module and convert its introspection data into the docforge models.\n\nArgs:\n    path: The dotted path of the module to load.\n\nReturns:\n    A Module instance."
+          }
+        }
+      },
+      "discover_module_paths": {
+        "name": "discover_module_paths",
+        "kind": "function",
+        "path": "docforge.cli.main.discover_module_paths",
+        "signature": "<bound method Alias.signature of Alias('discover_module_paths', 'docforge.loaders.discover_module_paths')>",
+        "docstring": "Discover all Python modules under a package via filesystem traversal.\n\nRules:\n- Directory with __init__.py is treated as a package.\n- Any .py file is treated as a module.\n- All paths are converted to dotted module paths.\n\nArgs:\n    module_name: The name of the package to discover.\n    project_root: The root directory of the project. Defaults to current working directory.\n\nReturns:\n    A sorted list of dotted module paths."
+      },
+      "MkDocsRenderer": {
+        "name": "MkDocsRenderer",
+        "kind": "class",
+        "path": "docforge.cli.main.MkDocsRenderer",
+        "signature": "<bound method Alias.signature of Alias('MkDocsRenderer', 'docforge.renderers.MkDocsRenderer')>",
+        "docstring": "Renderer that generates Markdown source files formatted for the MkDocs\n'mkdocstrings' plugin.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.cli.main.MkDocsRenderer.name",
+            "signature": "<bound method Alias.signature of Alias('name', 'docforge.renderers.mkdocs_renderer.MkDocsRenderer.name')>",
+            "docstring": null
+          },
+          "generate_sources": {
+            "name": "generate_sources",
+            "kind": "function",
+            "path": "docforge.cli.main.MkDocsRenderer.generate_sources",
+            "signature": "<bound method Alias.signature of Alias('generate_sources', 'docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_sources')>",
+            "docstring": "Produce a set of Markdown files in the output directory based on the\nprovided Project models.\n\nArgs:\n    project: The project models to render.\n    out_dir: Target directory for documentation files."
+          }
+        }
+      },
+      "MCPRenderer": {
+        "name": "MCPRenderer",
+        "kind": "class",
+        "path": "docforge.cli.main.MCPRenderer",
+        "signature": "<bound method Alias.signature of Alias('MCPRenderer', 'docforge.renderers.MCPRenderer')>",
+        "docstring": "Renderer that emits MCP-native JSON resources from docforge models.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.cli.main.MCPRenderer.name",
+            "signature": "<bound method Alias.signature of Alias('name', 'docforge.renderers.mcp_renderer.MCPRenderer.name')>",
+            "docstring": null
+          },
+          "generate_sources": {
+            "name": "generate_sources",
+            "kind": "function",
+            "path": "docforge.cli.main.MCPRenderer.generate_sources",
+            "signature": "<bound method Alias.signature of Alias('generate_sources', 'docforge.renderers.mcp_renderer.MCPRenderer.generate_sources')>",
+            "docstring": "Generate MCP-compatible JSON resources and navigation for the project."
+          }
+        }
+      },
+      "mkdocs_cmd": {
+        "name": "mkdocs_cmd",
+        "kind": "function",
+        "path": "docforge.cli.main.mkdocs_cmd",
+        "signature": "<bound method Alias.signature of Alias('mkdocs_cmd', 'docforge.cli.mkdocs.mkdocs_cmd')>",
+        "docstring": "Generate an mkdocs.yml configuration file by combining a template with\nthe navigation structure resolved from a docforge.nav.yml file.\n\nArgs:\n    docs_dir: Path to the directory containing documentation Markdown files.\n    nav_file: Path to the docforge.nav.yml specification.\n    template: Optional path to an mkdocs.yml template.\n    out: Path where the final mkdocs.yml will be written.\n    site_name: The name of the documentation site."
+      },
+      "cli": {
+        "name": "cli",
+        "kind": "function",
+        "path": "docforge.cli.main.cli",
+        "signature": "<bound method Function.signature of Function('cli', 16, 22)>",
+        "docstring": "doc-forge CLI: A tool for introspecting Python projects and generating\ndocumentation."
+      },
+      "tree": {
+        "name": "tree",
+        "kind": "function",
+        "path": "docforge.cli.main.tree",
+        "signature": "<bound method Function.signature of Function('tree', 31, 62)>",
+        "docstring": "Visualize the project structure including modules and their members.\n\nArgs:\n    modules: List of module paths to introspect.\n    project_name: Optional project name override."
+      },
+      "generate": {
+        "name": "generate",
+        "kind": "function",
+        "path": "docforge.cli.main.generate",
+        "signature": "<bound method Function.signature of Function('generate', 78, 118)>",
+        "docstring": "Generate Markdown source files for the specified module.\n\nArgs:\n    module: The primary module path to document.\n    project_name: Optional project name override.\n    docs_dir: Directory where documentation sources will be written."
+      },
+      "generate_mcp": {
+        "name": "generate_mcp",
+        "kind": "function",
+        "path": "docforge.cli.main.generate_mcp",
+        "signature": "<bound method Function.signature of Function('generate_mcp', 125, 164)>",
+        "docstring": "Generate MCP-compatible documentation resources for the specified module.\n\nArgs:\n    module: The primary module path to document.\n    project_name: Optional project name override.\n    out_dir: Directory where MCP resources will be written."
+      },
+      "build": {
+        "name": "build",
+        "kind": "function",
+        "path": "docforge.cli.main.build",
+        "signature": "<bound method Function.signature of Function('build', 171, 192)>",
+        "docstring": "Build the documentation site using MkDocs.\n\nArgs:\n    mkdocs_yml: Path to the mkdocs.yml configuration file."
+      },
+      "serve_mcp": {
+        "name": "serve_mcp",
+        "kind": "function",
+        "path": "docforge.cli.main.serve_mcp",
+        "signature": "<bound method Function.signature of Function('serve_mcp', 199, 226)>",
+        "docstring": "Serve MCP documentation from the local mcp_docs directory."
+      },
+      "serve": {
+        "name": "serve",
+        "kind": "function",
+        "path": "docforge.cli.main.serve",
+        "signature": "<bound method Function.signature of Function('serve', 233, 256)>",
+        "docstring": "Serve the documentation site with live-reload using MkDocs.\n\nArgs:\n    mkdocs_yml: Path to the mkdocs.yml configuration file."
+      },
+      "main": {
+        "name": "main",
+        "kind": "function",
+        "path": "docforge.cli.main.main",
+        "signature": "<bound method Function.signature of Function('main', 263, 267)>",
+        "docstring": "CLI Entry point."
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.cli.mkdocs.json

@@ -0,0 +1,95 @@
+{
+  "module": "docforge.cli.mkdocs",
+  "content": {
+    "path": "docforge.cli.mkdocs",
+    "docstring": "This module contains the 'mkdocs' CLI command, which orchestrates the generation\nof the main mkdocs.yml configuration file.",
+    "objects": {
+      "Path": {
+        "name": "Path",
+        "kind": "alias",
+        "path": "docforge.cli.mkdocs.Path",
+        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+        "docstring": null
+      },
+      "resources": {
+        "name": "resources",
+        "kind": "alias",
+        "path": "docforge.cli.mkdocs.resources",
+        "signature": "<bound method Alias.signature of Alias('resources', 'importlib.resources')>",
+        "docstring": null
+      },
+      "click": {
+        "name": "click",
+        "kind": "alias",
+        "path": "docforge.cli.mkdocs.click",
+        "signature": "<bound method Alias.signature of Alias('click', 'click')>",
+        "docstring": null
+      },
+      "yaml": {
+        "name": "yaml",
+        "kind": "alias",
+        "path": "docforge.cli.mkdocs.yaml",
+        "signature": "<bound method Alias.signature of Alias('yaml', 'yaml')>",
+        "docstring": null
+      },
+      "load_nav_spec": {
+        "name": "load_nav_spec",
+        "kind": "function",
+        "path": "docforge.cli.mkdocs.load_nav_spec",
+        "signature": "<bound method Alias.signature of Alias('load_nav_spec', 'docforge.nav.load_nav_spec')>",
+        "docstring": "Utility function to load a NavSpec from a file.\n\nArgs:\n    path: Path to the navigation specification file.\n\nReturns:\n    A loaded NavSpec instance."
+      },
+      "resolve_nav": {
+        "name": "resolve_nav",
+        "kind": "function",
+        "path": "docforge.cli.mkdocs.resolve_nav",
+        "signature": "<bound method Alias.signature of Alias('resolve_nav', 'docforge.nav.resolve_nav')>",
+        "docstring": "Create a ResolvedNav by processing a NavSpec against the filesystem.\nThis expands globs and validates the existence of referenced files.\n\nArgs:\n    spec: The navigation specification to resolve.\n    docs_root: The root directory for documentation files.\n\nReturns:\n    A ResolvedNav instance.\n\nRaises:\n    FileNotFoundError: If a pattern doesn't match any files or the docs_root doesn't exist."
+      },
+      "MkDocsNavEmitter": {
+        "name": "MkDocsNavEmitter",
+        "kind": "class",
+        "path": "docforge.cli.mkdocs.MkDocsNavEmitter",
+        "signature": "<bound method Alias.signature of Alias('MkDocsNavEmitter', 'docforge.nav.MkDocsNavEmitter')>",
+        "docstring": "Emitter responsible for transforming a ResolvedNav into an MkDocs-compatible\nnavigation structure.",
+        "members": {
+          "emit": {
+            "name": "emit",
+            "kind": "function",
+            "path": "docforge.cli.mkdocs.MkDocsNavEmitter.emit",
+            "signature": "<bound method Alias.signature of Alias('emit', 'docforge.nav.mkdocs.MkDocsNavEmitter.emit')>",
+            "docstring": "Generate a list of navigation entries for mkdocs.yml.\n\nArgs:\n    nav: The resolved navigation data.\n\nReturns:\n    A list of dictionary mappings representing the MkDocs navigation."
+          }
+        }
+      },
+      "mkdocs_cmd": {
+        "name": "mkdocs_cmd",
+        "kind": "function",
+        "path": "docforge.cli.mkdocs.mkdocs_cmd",
+        "signature": "<bound method Function.signature of Function('mkdocs_cmd', 42, 116)>",
+        "docstring": "Generate an mkdocs.yml configuration file by combining a template with\nthe navigation structure resolved from a docforge.nav.yml file.\n\nArgs:\n    docs_dir: Path to the directory containing documentation Markdown files.\n    nav_file: Path to the docforge.nav.yml specification.\n    template: Optional path to an mkdocs.yml template.\n    out: Path where the final mkdocs.yml will be written.\n    site_name: The name of the documentation site."
+      },
+      "Any": {
+        "name": "Any",
+        "kind": "alias",
+        "path": "docforge.cli.mkdocs.Any",
+        "signature": "<bound method Alias.signature of Alias('Any', 'typing.Any')>",
+        "docstring": null
+      },
+      "Dict": {
+        "name": "Dict",
+        "kind": "alias",
+        "path": "docforge.cli.mkdocs.Dict",
+        "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+        "docstring": null
+      },
+      "Optional": {
+        "name": "Optional",
+        "kind": "alias",
+        "path": "docforge.cli.mkdocs.Optional",
+        "signature": "<bound method Alias.signature of Alias('Optional', 'typing.Optional')>",
+        "docstring": null
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.loaders.griffe_loader.json

@@ -0,0 +1,276 @@
+{
+  "module": "docforge.loaders.griffe_loader",
+  "content": {
+    "path": "docforge.loaders.griffe_loader",
+    "docstring": "This module provides the GriffeLoader, which uses the 'griffe' library to\nintrospect Python source code and populate the doc-forge Project models.",
+    "objects": {
+      "logging": {
+        "name": "logging",
+        "kind": "alias",
+        "path": "docforge.loaders.griffe_loader.logging",
+        "signature": "<bound method Alias.signature of Alias('logging', 'logging')>",
+        "docstring": null
+      },
+      "Path": {
+        "name": "Path",
+        "kind": "alias",
+        "path": "docforge.loaders.griffe_loader.Path",
+        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+        "docstring": null
+      },
+      "List": {
+        "name": "List",
+        "kind": "alias",
+        "path": "docforge.loaders.griffe_loader.List",
+        "signature": "<bound method Alias.signature of Alias('List', 'typing.List')>",
+        "docstring": null
+      },
+      "Optional": {
+        "name": "Optional",
+        "kind": "alias",
+        "path": "docforge.loaders.griffe_loader.Optional",
+        "signature": "<bound method Alias.signature of Alias('Optional', 'typing.Optional')>",
+        "docstring": null
+      },
+      "ModulesCollection": {
+        "name": "ModulesCollection",
+        "kind": "alias",
+        "path": "docforge.loaders.griffe_loader.ModulesCollection",
+        "signature": "<bound method Alias.signature of Alias('ModulesCollection', 'griffe.ModulesCollection')>",
+        "docstring": null
+      },
+      "LinesCollection": {
+        "name": "LinesCollection",
+        "kind": "alias",
+        "path": "docforge.loaders.griffe_loader.LinesCollection",
+        "signature": "<bound method Alias.signature of Alias('LinesCollection', 'griffe.LinesCollection')>",
+        "docstring": null
+      },
+      "Object": {
+        "name": "Object",
+        "kind": "alias",
+        "path": "docforge.loaders.griffe_loader.Object",
+        "signature": "<bound method Alias.signature of Alias('Object', 'griffe.Object')>",
+        "docstring": null
+      },
+      "AliasResolutionError": {
+        "name": "AliasResolutionError",
+        "kind": "alias",
+        "path": "docforge.loaders.griffe_loader.AliasResolutionError",
+        "signature": "<bound method Alias.signature of Alias('AliasResolutionError', 'griffe.AliasResolutionError')>",
+        "docstring": null
+      },
+      "Module": {
+        "name": "Module",
+        "kind": "class",
+        "path": "docforge.loaders.griffe_loader.Module",
+        "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.Module')>",
+        "docstring": "Represents a documented Python module or package.\n\nAttributes:\n    path: Dotted import path of the module.\n    docstring: Module-level docstring content.\n    members: Dictionary mapping object names to their DocObject representations.",
+        "members": {
+          "path": {
+            "name": "path",
+            "kind": "attribute",
+            "path": "docforge.loaders.griffe_loader.Module.path",
+            "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.module.Module.path')>",
+            "docstring": null
+          },
+          "docstring": {
+            "name": "docstring",
+            "kind": "attribute",
+            "path": "docforge.loaders.griffe_loader.Module.docstring",
+            "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.module.Module.docstring')>",
+            "docstring": null
+          },
+          "members": {
+            "name": "members",
+            "kind": "attribute",
+            "path": "docforge.loaders.griffe_loader.Module.members",
+            "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.module.Module.members')>",
+            "docstring": null
+          },
+          "add_object": {
+            "name": "add_object",
+            "kind": "function",
+            "path": "docforge.loaders.griffe_loader.Module.add_object",
+            "signature": "<bound method Alias.signature of Alias('add_object', 'docforge.models.module.Module.add_object')>",
+            "docstring": "Add a documented object to the module.\n\nArgs:\n    obj: The object to add."
+          },
+          "get_object": {
+            "name": "get_object",
+            "kind": "function",
+            "path": "docforge.loaders.griffe_loader.Module.get_object",
+            "signature": "<bound method Alias.signature of Alias('get_object', 'docforge.models.module.Module.get_object')>",
+            "docstring": "Retrieve a member object by name.\n\nArgs:\n    name: The name of the object.\n\nReturns:\n    The requested DocObject."
+          },
+          "get_all_objects": {
+            "name": "get_all_objects",
+            "kind": "function",
+            "path": "docforge.loaders.griffe_loader.Module.get_all_objects",
+            "signature": "<bound method Alias.signature of Alias('get_all_objects', 'docforge.models.module.Module.get_all_objects')>",
+            "docstring": "Get all top-level objects in the module.\n\nReturns:\n    An iterable of DocObject instances."
+          }
+        }
+      },
+      "Project": {
+        "name": "Project",
+        "kind": "class",
+        "path": "docforge.loaders.griffe_loader.Project",
+        "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.Project')>",
+        "docstring": "Represents a documentation project, serving as a container for modules.\n\nAttributes:\n    name: Name of the project.\n    modules: Dictionary mapping module paths to Module instances.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.loaders.griffe_loader.Project.name",
+            "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.project.Project.name')>",
+            "docstring": null
+          },
+          "modules": {
+            "name": "modules",
+            "kind": "attribute",
+            "path": "docforge.loaders.griffe_loader.Project.modules",
+            "signature": "<bound method Alias.signature of Alias('modules', 'docforge.models.project.Project.modules')>",
+            "docstring": null
+          },
+          "add_module": {
+            "name": "add_module",
+            "kind": "function",
+            "path": "docforge.loaders.griffe_loader.Project.add_module",
+            "signature": "<bound method Alias.signature of Alias('add_module', 'docforge.models.project.Project.add_module')>",
+            "docstring": "Add a module to the project.\n\nArgs:\n    module: The module to add."
+          },
+          "get_module": {
+            "name": "get_module",
+            "kind": "function",
+            "path": "docforge.loaders.griffe_loader.Project.get_module",
+            "signature": "<bound method Alias.signature of Alias('get_module', 'docforge.models.project.Project.get_module')>",
+            "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path: The dotted path of the module (e.g., 'pkg.mod').\n\nReturns:\n    The requested Module."
+          },
+          "get_all_modules": {
+            "name": "get_all_modules",
+            "kind": "function",
+            "path": "docforge.loaders.griffe_loader.Project.get_all_modules",
+            "signature": "<bound method Alias.signature of Alias('get_all_modules', 'docforge.models.project.Project.get_all_modules')>",
+            "docstring": "Get all modules in the project.\n\nReturns:\n    An iterable of Module objects."
+          },
+          "get_module_list": {
+            "name": "get_module_list",
+            "kind": "function",
+            "path": "docforge.loaders.griffe_loader.Project.get_module_list",
+            "signature": "<bound method Alias.signature of Alias('get_module_list', 'docforge.models.project.Project.get_module_list')>",
+            "docstring": "Get the list of all module dotted paths.\n\nReturns:\n    A list of module paths."
+          }
+        }
+      },
+      "DocObject": {
+        "name": "DocObject",
+        "kind": "class",
+        "path": "docforge.loaders.griffe_loader.DocObject",
+        "signature": "<bound method Alias.signature of Alias('DocObject', 'docforge.models.DocObject')>",
+        "docstring": "Represents a documented Python object (class, function, method, etc.).\n\nAttributes:\n    name: Local name of the object.\n    kind: Type of object (e.g., 'class', 'function', 'attribute').\n    path: Full dotted import path to the object.\n    signature: Callable signature, if applicable.\n    docstring: Raw docstring content extracted from the source.\n    members: Dictionary mapping member names to their DocObject representations.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.loaders.griffe_loader.DocObject.name",
+            "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.object.DocObject.name')>",
+            "docstring": null
+          },
+          "kind": {
+            "name": "kind",
+            "kind": "attribute",
+            "path": "docforge.loaders.griffe_loader.DocObject.kind",
+            "signature": "<bound method Alias.signature of Alias('kind', 'docforge.models.object.DocObject.kind')>",
+            "docstring": null
+          },
+          "path": {
+            "name": "path",
+            "kind": "attribute",
+            "path": "docforge.loaders.griffe_loader.DocObject.path",
+            "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.object.DocObject.path')>",
+            "docstring": null
+          },
+          "signature": {
+            "name": "signature",
+            "kind": "attribute",
+            "path": "docforge.loaders.griffe_loader.DocObject.signature",
+            "signature": "<bound method Alias.signature of Alias('signature', 'docforge.models.object.DocObject.signature')>",
+            "docstring": null
+          },
+          "docstring": {
+            "name": "docstring",
+            "kind": "attribute",
+            "path": "docforge.loaders.griffe_loader.DocObject.docstring",
+            "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.object.DocObject.docstring')>",
+            "docstring": null
+          },
+          "members": {
+            "name": "members",
+            "kind": "attribute",
+            "path": "docforge.loaders.griffe_loader.DocObject.members",
+            "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.object.DocObject.members')>",
+            "docstring": null
+          },
+          "add_member": {
+            "name": "add_member",
+            "kind": "function",
+            "path": "docforge.loaders.griffe_loader.DocObject.add_member",
+            "signature": "<bound method Alias.signature of Alias('add_member', 'docforge.models.object.DocObject.add_member')>",
+            "docstring": "Add a child member to this object (e.g., a method to a class).\n\nArgs:\n    obj: The child DocObject to add."
+          },
+          "get_member": {
+            "name": "get_member",
+            "kind": "function",
+            "path": "docforge.loaders.griffe_loader.DocObject.get_member",
+            "signature": "<bound method Alias.signature of Alias('get_member', 'docforge.models.object.DocObject.get_member')>",
+            "docstring": "Retrieve a child member by name.\n\nArgs:\n    name: The name of the member.\n\nReturns:\n    The requested DocObject."
+          },
+          "get_all_members": {
+            "name": "get_all_members",
+            "kind": "function",
+            "path": "docforge.loaders.griffe_loader.DocObject.get_all_members",
+            "signature": "<bound method Alias.signature of Alias('get_all_members', 'docforge.models.object.DocObject.get_all_members')>",
+            "docstring": "Get all members of this object.\n\nReturns:\n    An iterable of child DocObject instances."
+          }
+        }
+      },
+      "logger": {
+        "name": "logger",
+        "kind": "attribute",
+        "path": "docforge.loaders.griffe_loader.logger",
+        "signature": null,
+        "docstring": null
+      },
+      "discover_module_paths": {
+        "name": "discover_module_paths",
+        "kind": "function",
+        "path": "docforge.loaders.griffe_loader.discover_module_paths",
+        "signature": "<bound method Function.signature of Function('discover_module_paths', 23, 62)>",
+        "docstring": "Discover all Python modules under a package via filesystem traversal.\n\nRules:\n- Directory with __init__.py is treated as a package.\n- Any .py file is treated as a module.\n- All paths are converted to dotted module paths.\n\nArgs:\n    module_name: The name of the package to discover.\n    project_root: The root directory of the project. Defaults to current working directory.\n\nReturns:\n    A sorted list of dotted module paths."
+      },
+      "GriffeLoader": {
+        "name": "GriffeLoader",
+        "kind": "class",
+        "path": "docforge.loaders.griffe_loader.GriffeLoader",
+        "signature": "<bound method Class.signature of Class('GriffeLoader', 65, 188)>",
+        "docstring": "Loads Python modules and extracts documentation using the Griffe introspection engine.",
+        "members": {
+          "load_project": {
+            "name": "load_project",
+            "kind": "function",
+            "path": "docforge.loaders.griffe_loader.GriffeLoader.load_project",
+            "signature": "<bound method Function.signature of Function('load_project', 79, 115)>",
+            "docstring": "Load multiple modules and combine them into a single Project models.\n\nArgs:\n    module_paths: A list of dotted paths to the modules to load.\n    project_name: Optional name for the project. Defaults to the first module name.\n    skip_import_errors: If True, modules that fail to import will be skipped.\n\nReturns:\n    A Project instance containing the loaded modules."
+          },
+          "load_module": {
+            "name": "load_module",
+            "kind": "function",
+            "path": "docforge.loaders.griffe_loader.GriffeLoader.load_module",
+            "signature": "<bound method Function.signature of Function('load_module', 117, 130)>",
+            "docstring": "Load a single module and convert its introspection data into the docforge models.\n\nArgs:\n    path: The dotted path of the module to load.\n\nReturns:\n    A Module instance."
+          }
+        }
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.loaders.json

@@ -0,0 +1,315 @@
+{
+  "module": "docforge.loaders",
+  "content": {
+    "path": "docforge.loaders",
+    "docstring": "# Loader Layer\n\nThe `docforge.loaders` package is responsible for discovering Python source files\nand extracting their documentation using static analysis.\n\n## Core Features\n\n- **Discovery**: Automatically find all modules and packages in a project\n  directory.\n- **Introspection**: Uses `griffe` to parse docstrings, signatures, and\n  hierarchical relationships without executing the code.\n- **Filtering**: Automatically excludes private members (prefixed with `_`) to\n  ensure clean public documentation.",
+    "objects": {
+      "GriffeLoader": {
+        "name": "GriffeLoader",
+        "kind": "class",
+        "path": "docforge.loaders.GriffeLoader",
+        "signature": "<bound method Alias.signature of Alias('GriffeLoader', 'docforge.loaders.griffe_loader.GriffeLoader')>",
+        "docstring": "Loads Python modules and extracts documentation using the Griffe introspection engine.",
+        "members": {
+          "load_project": {
+            "name": "load_project",
+            "kind": "function",
+            "path": "docforge.loaders.GriffeLoader.load_project",
+            "signature": "<bound method Alias.signature of Alias('load_project', 'docforge.loaders.griffe_loader.GriffeLoader.load_project')>",
+            "docstring": "Load multiple modules and combine them into a single Project models.\n\nArgs:\n    module_paths: A list of dotted paths to the modules to load.\n    project_name: Optional name for the project. Defaults to the first module name.\n    skip_import_errors: If True, modules that fail to import will be skipped.\n\nReturns:\n    A Project instance containing the loaded modules."
+          },
+          "load_module": {
+            "name": "load_module",
+            "kind": "function",
+            "path": "docforge.loaders.GriffeLoader.load_module",
+            "signature": "<bound method Alias.signature of Alias('load_module', 'docforge.loaders.griffe_loader.GriffeLoader.load_module')>",
+            "docstring": "Load a single module and convert its introspection data into the docforge models.\n\nArgs:\n    path: The dotted path of the module to load.\n\nReturns:\n    A Module instance."
+          }
+        }
+      },
+      "discover_module_paths": {
+        "name": "discover_module_paths",
+        "kind": "function",
+        "path": "docforge.loaders.discover_module_paths",
+        "signature": "<bound method Alias.signature of Alias('discover_module_paths', 'docforge.loaders.griffe_loader.discover_module_paths')>",
+        "docstring": "Discover all Python modules under a package via filesystem traversal.\n\nRules:\n- Directory with __init__.py is treated as a package.\n- Any .py file is treated as a module.\n- All paths are converted to dotted module paths.\n\nArgs:\n    module_name: The name of the package to discover.\n    project_root: The root directory of the project. Defaults to current working directory.\n\nReturns:\n    A sorted list of dotted module paths."
+      },
+      "griffe_loader": {
+        "name": "griffe_loader",
+        "kind": "module",
+        "path": "docforge.loaders.griffe_loader",
+        "signature": null,
+        "docstring": "This module provides the GriffeLoader, which uses the 'griffe' library to\nintrospect Python source code and populate the doc-forge Project models.",
+        "members": {
+          "logging": {
+            "name": "logging",
+            "kind": "alias",
+            "path": "docforge.loaders.griffe_loader.logging",
+            "signature": "<bound method Alias.signature of Alias('logging', 'logging')>",
+            "docstring": null
+          },
+          "Path": {
+            "name": "Path",
+            "kind": "alias",
+            "path": "docforge.loaders.griffe_loader.Path",
+            "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+            "docstring": null
+          },
+          "List": {
+            "name": "List",
+            "kind": "alias",
+            "path": "docforge.loaders.griffe_loader.List",
+            "signature": "<bound method Alias.signature of Alias('List', 'typing.List')>",
+            "docstring": null
+          },
+          "Optional": {
+            "name": "Optional",
+            "kind": "alias",
+            "path": "docforge.loaders.griffe_loader.Optional",
+            "signature": "<bound method Alias.signature of Alias('Optional', 'typing.Optional')>",
+            "docstring": null
+          },
+          "ModulesCollection": {
+            "name": "ModulesCollection",
+            "kind": "alias",
+            "path": "docforge.loaders.griffe_loader.ModulesCollection",
+            "signature": "<bound method Alias.signature of Alias('ModulesCollection', 'griffe.ModulesCollection')>",
+            "docstring": null
+          },
+          "LinesCollection": {
+            "name": "LinesCollection",
+            "kind": "alias",
+            "path": "docforge.loaders.griffe_loader.LinesCollection",
+            "signature": "<bound method Alias.signature of Alias('LinesCollection', 'griffe.LinesCollection')>",
+            "docstring": null
+          },
+          "Object": {
+            "name": "Object",
+            "kind": "alias",
+            "path": "docforge.loaders.griffe_loader.Object",
+            "signature": "<bound method Alias.signature of Alias('Object', 'griffe.Object')>",
+            "docstring": null
+          },
+          "AliasResolutionError": {
+            "name": "AliasResolutionError",
+            "kind": "alias",
+            "path": "docforge.loaders.griffe_loader.AliasResolutionError",
+            "signature": "<bound method Alias.signature of Alias('AliasResolutionError', 'griffe.AliasResolutionError')>",
+            "docstring": null
+          },
+          "Module": {
+            "name": "Module",
+            "kind": "class",
+            "path": "docforge.loaders.griffe_loader.Module",
+            "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.Module')>",
+            "docstring": "Represents a documented Python module or package.\n\nAttributes:\n    path: Dotted import path of the module.\n    docstring: Module-level docstring content.\n    members: Dictionary mapping object names to their DocObject representations.",
+            "members": {
+              "path": {
+                "name": "path",
+                "kind": "attribute",
+                "path": "docforge.loaders.griffe_loader.Module.path",
+                "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.module.Module.path')>",
+                "docstring": null
+              },
+              "docstring": {
+                "name": "docstring",
+                "kind": "attribute",
+                "path": "docforge.loaders.griffe_loader.Module.docstring",
+                "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.module.Module.docstring')>",
+                "docstring": null
+              },
+              "members": {
+                "name": "members",
+                "kind": "attribute",
+                "path": "docforge.loaders.griffe_loader.Module.members",
+                "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.module.Module.members')>",
+                "docstring": null
+              },
+              "add_object": {
+                "name": "add_object",
+                "kind": "function",
+                "path": "docforge.loaders.griffe_loader.Module.add_object",
+                "signature": "<bound method Alias.signature of Alias('add_object', 'docforge.models.module.Module.add_object')>",
+                "docstring": "Add a documented object to the module.\n\nArgs:\n    obj: The object to add."
+              },
+              "get_object": {
+                "name": "get_object",
+                "kind": "function",
+                "path": "docforge.loaders.griffe_loader.Module.get_object",
+                "signature": "<bound method Alias.signature of Alias('get_object', 'docforge.models.module.Module.get_object')>",
+                "docstring": "Retrieve a member object by name.\n\nArgs:\n    name: The name of the object.\n\nReturns:\n    The requested DocObject."
+              },
+              "get_all_objects": {
+                "name": "get_all_objects",
+                "kind": "function",
+                "path": "docforge.loaders.griffe_loader.Module.get_all_objects",
+                "signature": "<bound method Alias.signature of Alias('get_all_objects', 'docforge.models.module.Module.get_all_objects')>",
+                "docstring": "Get all top-level objects in the module.\n\nReturns:\n    An iterable of DocObject instances."
+              }
+            }
+          },
+          "Project": {
+            "name": "Project",
+            "kind": "class",
+            "path": "docforge.loaders.griffe_loader.Project",
+            "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.Project')>",
+            "docstring": "Represents a documentation project, serving as a container for modules.\n\nAttributes:\n    name: Name of the project.\n    modules: Dictionary mapping module paths to Module instances.",
+            "members": {
+              "name": {
+                "name": "name",
+                "kind": "attribute",
+                "path": "docforge.loaders.griffe_loader.Project.name",
+                "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.project.Project.name')>",
+                "docstring": null
+              },
+              "modules": {
+                "name": "modules",
+                "kind": "attribute",
+                "path": "docforge.loaders.griffe_loader.Project.modules",
+                "signature": "<bound method Alias.signature of Alias('modules', 'docforge.models.project.Project.modules')>",
+                "docstring": null
+              },
+              "add_module": {
+                "name": "add_module",
+                "kind": "function",
+                "path": "docforge.loaders.griffe_loader.Project.add_module",
+                "signature": "<bound method Alias.signature of Alias('add_module', 'docforge.models.project.Project.add_module')>",
+                "docstring": "Add a module to the project.\n\nArgs:\n    module: The module to add."
+              },
+              "get_module": {
+                "name": "get_module",
+                "kind": "function",
+                "path": "docforge.loaders.griffe_loader.Project.get_module",
+                "signature": "<bound method Alias.signature of Alias('get_module', 'docforge.models.project.Project.get_module')>",
+                "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path: The dotted path of the module (e.g., 'pkg.mod').\n\nReturns:\n    The requested Module."
+              },
+              "get_all_modules": {
+                "name": "get_all_modules",
+                "kind": "function",
+                "path": "docforge.loaders.griffe_loader.Project.get_all_modules",
+                "signature": "<bound method Alias.signature of Alias('get_all_modules', 'docforge.models.project.Project.get_all_modules')>",
+                "docstring": "Get all modules in the project.\n\nReturns:\n    An iterable of Module objects."
+              },
+              "get_module_list": {
+                "name": "get_module_list",
+                "kind": "function",
+                "path": "docforge.loaders.griffe_loader.Project.get_module_list",
+                "signature": "<bound method Alias.signature of Alias('get_module_list', 'docforge.models.project.Project.get_module_list')>",
+                "docstring": "Get the list of all module dotted paths.\n\nReturns:\n    A list of module paths."
+              }
+            }
+          },
+          "DocObject": {
+            "name": "DocObject",
+            "kind": "class",
+            "path": "docforge.loaders.griffe_loader.DocObject",
+            "signature": "<bound method Alias.signature of Alias('DocObject', 'docforge.models.DocObject')>",
+            "docstring": "Represents a documented Python object (class, function, method, etc.).\n\nAttributes:\n    name: Local name of the object.\n    kind: Type of object (e.g., 'class', 'function', 'attribute').\n    path: Full dotted import path to the object.\n    signature: Callable signature, if applicable.\n    docstring: Raw docstring content extracted from the source.\n    members: Dictionary mapping member names to their DocObject representations.",
+            "members": {
+              "name": {
+                "name": "name",
+                "kind": "attribute",
+                "path": "docforge.loaders.griffe_loader.DocObject.name",
+                "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.object.DocObject.name')>",
+                "docstring": null
+              },
+              "kind": {
+                "name": "kind",
+                "kind": "attribute",
+                "path": "docforge.loaders.griffe_loader.DocObject.kind",
+                "signature": "<bound method Alias.signature of Alias('kind', 'docforge.models.object.DocObject.kind')>",
+                "docstring": null
+              },
+              "path": {
+                "name": "path",
+                "kind": "attribute",
+                "path": "docforge.loaders.griffe_loader.DocObject.path",
+                "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.object.DocObject.path')>",
+                "docstring": null
+              },
+              "signature": {
+                "name": "signature",
+                "kind": "attribute",
+                "path": "docforge.loaders.griffe_loader.DocObject.signature",
+                "signature": "<bound method Alias.signature of Alias('signature', 'docforge.models.object.DocObject.signature')>",
+                "docstring": null
+              },
+              "docstring": {
+                "name": "docstring",
+                "kind": "attribute",
+                "path": "docforge.loaders.griffe_loader.DocObject.docstring",
+                "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.object.DocObject.docstring')>",
+                "docstring": null
+              },
+              "members": {
+                "name": "members",
+                "kind": "attribute",
+                "path": "docforge.loaders.griffe_loader.DocObject.members",
+                "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.object.DocObject.members')>",
+                "docstring": null
+              },
+              "add_member": {
+                "name": "add_member",
+                "kind": "function",
+                "path": "docforge.loaders.griffe_loader.DocObject.add_member",
+                "signature": "<bound method Alias.signature of Alias('add_member', 'docforge.models.object.DocObject.add_member')>",
+                "docstring": "Add a child member to this object (e.g., a method to a class).\n\nArgs:\n    obj: The child DocObject to add."
+              },
+              "get_member": {
+                "name": "get_member",
+                "kind": "function",
+                "path": "docforge.loaders.griffe_loader.DocObject.get_member",
+                "signature": "<bound method Alias.signature of Alias('get_member', 'docforge.models.object.DocObject.get_member')>",
+                "docstring": "Retrieve a child member by name.\n\nArgs:\n    name: The name of the member.\n\nReturns:\n    The requested DocObject."
+              },
+              "get_all_members": {
+                "name": "get_all_members",
+                "kind": "function",
+                "path": "docforge.loaders.griffe_loader.DocObject.get_all_members",
+                "signature": "<bound method Alias.signature of Alias('get_all_members', 'docforge.models.object.DocObject.get_all_members')>",
+                "docstring": "Get all members of this object.\n\nReturns:\n    An iterable of child DocObject instances."
+              }
+            }
+          },
+          "logger": {
+            "name": "logger",
+            "kind": "attribute",
+            "path": "docforge.loaders.griffe_loader.logger",
+            "signature": null,
+            "docstring": null
+          },
+          "discover_module_paths": {
+            "name": "discover_module_paths",
+            "kind": "function",
+            "path": "docforge.loaders.griffe_loader.discover_module_paths",
+            "signature": "<bound method Function.signature of Function('discover_module_paths', 23, 62)>",
+            "docstring": "Discover all Python modules under a package via filesystem traversal.\n\nRules:\n- Directory with __init__.py is treated as a package.\n- Any .py file is treated as a module.\n- All paths are converted to dotted module paths.\n\nArgs:\n    module_name: The name of the package to discover.\n    project_root: The root directory of the project. Defaults to current working directory.\n\nReturns:\n    A sorted list of dotted module paths."
+          },
+          "GriffeLoader": {
+            "name": "GriffeLoader",
+            "kind": "class",
+            "path": "docforge.loaders.griffe_loader.GriffeLoader",
+            "signature": "<bound method Class.signature of Class('GriffeLoader', 65, 188)>",
+            "docstring": "Loads Python modules and extracts documentation using the Griffe introspection engine.",
+            "members": {
+              "load_project": {
+                "name": "load_project",
+                "kind": "function",
+                "path": "docforge.loaders.griffe_loader.GriffeLoader.load_project",
+                "signature": "<bound method Function.signature of Function('load_project', 79, 115)>",
+                "docstring": "Load multiple modules and combine them into a single Project models.\n\nArgs:\n    module_paths: A list of dotted paths to the modules to load.\n    project_name: Optional name for the project. Defaults to the first module name.\n    skip_import_errors: If True, modules that fail to import will be skipped.\n\nReturns:\n    A Project instance containing the loaded modules."
+              },
+              "load_module": {
+                "name": "load_module",
+                "kind": "function",
+                "path": "docforge.loaders.griffe_loader.GriffeLoader.load_module",
+                "signature": "<bound method Function.signature of Function('load_module', 117, 130)>",
+                "docstring": "Load a single module and convert its introspection data into the docforge models.\n\nArgs:\n    path: The dotted path of the module to load.\n\nReturns:\n    A Module instance."
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.models.json

@@ -0,0 +1,563 @@
+{
+  "module": "docforge.models",
+  "content": {
+    "path": "docforge.models",
+    "docstring": "# Model Layer\n\nThe `docforge.models` package provides the core data structures used to represent\nPython source code in a documentation-focused hierarchy.\n\n## Key Components\n\n- **Project**: The root container for all documented modules.\n- **Module**: Represents a Python module or package, containing members.\n- **DocObject**: A recursive structure for classes, functions, and attributes.\n\nThese classes are designed to be renderer-agnostic, allowing the same internal\nrepresentation to be transformed into various output formats (currently MkDocs).",
+    "objects": {
+      "Project": {
+        "name": "Project",
+        "kind": "class",
+        "path": "docforge.models.Project",
+        "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.project.Project')>",
+        "docstring": "Represents a documentation project, serving as a container for modules.\n\nAttributes:\n    name: Name of the project.\n    modules: Dictionary mapping module paths to Module instances.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.models.Project.name",
+            "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.project.Project.name')>",
+            "docstring": null
+          },
+          "modules": {
+            "name": "modules",
+            "kind": "attribute",
+            "path": "docforge.models.Project.modules",
+            "signature": "<bound method Alias.signature of Alias('modules', 'docforge.models.project.Project.modules')>",
+            "docstring": null
+          },
+          "add_module": {
+            "name": "add_module",
+            "kind": "function",
+            "path": "docforge.models.Project.add_module",
+            "signature": "<bound method Alias.signature of Alias('add_module', 'docforge.models.project.Project.add_module')>",
+            "docstring": "Add a module to the project.\n\nArgs:\n    module: The module to add."
+          },
+          "get_module": {
+            "name": "get_module",
+            "kind": "function",
+            "path": "docforge.models.Project.get_module",
+            "signature": "<bound method Alias.signature of Alias('get_module', 'docforge.models.project.Project.get_module')>",
+            "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path: The dotted path of the module (e.g., 'pkg.mod').\n\nReturns:\n    The requested Module."
+          },
+          "get_all_modules": {
+            "name": "get_all_modules",
+            "kind": "function",
+            "path": "docforge.models.Project.get_all_modules",
+            "signature": "<bound method Alias.signature of Alias('get_all_modules', 'docforge.models.project.Project.get_all_modules')>",
+            "docstring": "Get all modules in the project.\n\nReturns:\n    An iterable of Module objects."
+          },
+          "get_module_list": {
+            "name": "get_module_list",
+            "kind": "function",
+            "path": "docforge.models.Project.get_module_list",
+            "signature": "<bound method Alias.signature of Alias('get_module_list', 'docforge.models.project.Project.get_module_list')>",
+            "docstring": "Get the list of all module dotted paths.\n\nReturns:\n    A list of module paths."
+          }
+        }
+      },
+      "Module": {
+        "name": "Module",
+        "kind": "class",
+        "path": "docforge.models.Module",
+        "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.module.Module')>",
+        "docstring": "Represents a documented Python module or package.\n\nAttributes:\n    path: Dotted import path of the module.\n    docstring: Module-level docstring content.\n    members: Dictionary mapping object names to their DocObject representations.",
+        "members": {
+          "path": {
+            "name": "path",
+            "kind": "attribute",
+            "path": "docforge.models.Module.path",
+            "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.module.Module.path')>",
+            "docstring": null
+          },
+          "docstring": {
+            "name": "docstring",
+            "kind": "attribute",
+            "path": "docforge.models.Module.docstring",
+            "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.module.Module.docstring')>",
+            "docstring": null
+          },
+          "members": {
+            "name": "members",
+            "kind": "attribute",
+            "path": "docforge.models.Module.members",
+            "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.module.Module.members')>",
+            "docstring": null
+          },
+          "add_object": {
+            "name": "add_object",
+            "kind": "function",
+            "path": "docforge.models.Module.add_object",
+            "signature": "<bound method Alias.signature of Alias('add_object', 'docforge.models.module.Module.add_object')>",
+            "docstring": "Add a documented object to the module.\n\nArgs:\n    obj: The object to add."
+          },
+          "get_object": {
+            "name": "get_object",
+            "kind": "function",
+            "path": "docforge.models.Module.get_object",
+            "signature": "<bound method Alias.signature of Alias('get_object', 'docforge.models.module.Module.get_object')>",
+            "docstring": "Retrieve a member object by name.\n\nArgs:\n    name: The name of the object.\n\nReturns:\n    The requested DocObject."
+          },
+          "get_all_objects": {
+            "name": "get_all_objects",
+            "kind": "function",
+            "path": "docforge.models.Module.get_all_objects",
+            "signature": "<bound method Alias.signature of Alias('get_all_objects', 'docforge.models.module.Module.get_all_objects')>",
+            "docstring": "Get all top-level objects in the module.\n\nReturns:\n    An iterable of DocObject instances."
+          }
+        }
+      },
+      "DocObject": {
+        "name": "DocObject",
+        "kind": "class",
+        "path": "docforge.models.DocObject",
+        "signature": "<bound method Alias.signature of Alias('DocObject', 'docforge.models.object.DocObject')>",
+        "docstring": "Represents a documented Python object (class, function, method, etc.).\n\nAttributes:\n    name: Local name of the object.\n    kind: Type of object (e.g., 'class', 'function', 'attribute').\n    path: Full dotted import path to the object.\n    signature: Callable signature, if applicable.\n    docstring: Raw docstring content extracted from the source.\n    members: Dictionary mapping member names to their DocObject representations.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.models.DocObject.name",
+            "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.object.DocObject.name')>",
+            "docstring": null
+          },
+          "kind": {
+            "name": "kind",
+            "kind": "attribute",
+            "path": "docforge.models.DocObject.kind",
+            "signature": "<bound method Alias.signature of Alias('kind', 'docforge.models.object.DocObject.kind')>",
+            "docstring": null
+          },
+          "path": {
+            "name": "path",
+            "kind": "attribute",
+            "path": "docforge.models.DocObject.path",
+            "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.object.DocObject.path')>",
+            "docstring": null
+          },
+          "signature": {
+            "name": "signature",
+            "kind": "attribute",
+            "path": "docforge.models.DocObject.signature",
+            "signature": "<bound method Alias.signature of Alias('signature', 'docforge.models.object.DocObject.signature')>",
+            "docstring": null
+          },
+          "docstring": {
+            "name": "docstring",
+            "kind": "attribute",
+            "path": "docforge.models.DocObject.docstring",
+            "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.object.DocObject.docstring')>",
+            "docstring": null
+          },
+          "members": {
+            "name": "members",
+            "kind": "attribute",
+            "path": "docforge.models.DocObject.members",
+            "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.object.DocObject.members')>",
+            "docstring": null
+          },
+          "add_member": {
+            "name": "add_member",
+            "kind": "function",
+            "path": "docforge.models.DocObject.add_member",
+            "signature": "<bound method Alias.signature of Alias('add_member', 'docforge.models.object.DocObject.add_member')>",
+            "docstring": "Add a child member to this object (e.g., a method to a class).\n\nArgs:\n    obj: The child DocObject to add."
+          },
+          "get_member": {
+            "name": "get_member",
+            "kind": "function",
+            "path": "docforge.models.DocObject.get_member",
+            "signature": "<bound method Alias.signature of Alias('get_member', 'docforge.models.object.DocObject.get_member')>",
+            "docstring": "Retrieve a child member by name.\n\nArgs:\n    name: The name of the member.\n\nReturns:\n    The requested DocObject."
+          },
+          "get_all_members": {
+            "name": "get_all_members",
+            "kind": "function",
+            "path": "docforge.models.DocObject.get_all_members",
+            "signature": "<bound method Alias.signature of Alias('get_all_members', 'docforge.models.object.DocObject.get_all_members')>",
+            "docstring": "Get all members of this object.\n\nReturns:\n    An iterable of child DocObject instances."
+          }
+        }
+      },
+      "module": {
+        "name": "module",
+        "kind": "module",
+        "path": "docforge.models.module",
+        "signature": null,
+        "docstring": "This module defines the Module class, which represents a Python module or package\nin the doc-forge documentation models. It acts as a container for top-level\ndocumented objects.",
+        "members": {
+          "Dict": {
+            "name": "Dict",
+            "kind": "alias",
+            "path": "docforge.models.module.Dict",
+            "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+            "docstring": null
+          },
+          "Iterable": {
+            "name": "Iterable",
+            "kind": "alias",
+            "path": "docforge.models.module.Iterable",
+            "signature": "<bound method Alias.signature of Alias('Iterable', 'typing.Iterable')>",
+            "docstring": null
+          },
+          "Optional": {
+            "name": "Optional",
+            "kind": "alias",
+            "path": "docforge.models.module.Optional",
+            "signature": "<bound method Alias.signature of Alias('Optional', 'typing.Optional')>",
+            "docstring": null
+          },
+          "DocObject": {
+            "name": "DocObject",
+            "kind": "class",
+            "path": "docforge.models.module.DocObject",
+            "signature": "<bound method Alias.signature of Alias('DocObject', 'docforge.models.object.DocObject')>",
+            "docstring": "Represents a documented Python object (class, function, method, etc.).\n\nAttributes:\n    name: Local name of the object.\n    kind: Type of object (e.g., 'class', 'function', 'attribute').\n    path: Full dotted import path to the object.\n    signature: Callable signature, if applicable.\n    docstring: Raw docstring content extracted from the source.\n    members: Dictionary mapping member names to their DocObject representations.",
+            "members": {
+              "name": {
+                "name": "name",
+                "kind": "attribute",
+                "path": "docforge.models.module.DocObject.name",
+                "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.object.DocObject.name')>",
+                "docstring": null
+              },
+              "kind": {
+                "name": "kind",
+                "kind": "attribute",
+                "path": "docforge.models.module.DocObject.kind",
+                "signature": "<bound method Alias.signature of Alias('kind', 'docforge.models.object.DocObject.kind')>",
+                "docstring": null
+              },
+              "path": {
+                "name": "path",
+                "kind": "attribute",
+                "path": "docforge.models.module.DocObject.path",
+                "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.object.DocObject.path')>",
+                "docstring": null
+              },
+              "signature": {
+                "name": "signature",
+                "kind": "attribute",
+                "path": "docforge.models.module.DocObject.signature",
+                "signature": "<bound method Alias.signature of Alias('signature', 'docforge.models.object.DocObject.signature')>",
+                "docstring": null
+              },
+              "docstring": {
+                "name": "docstring",
+                "kind": "attribute",
+                "path": "docforge.models.module.DocObject.docstring",
+                "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.object.DocObject.docstring')>",
+                "docstring": null
+              },
+              "members": {
+                "name": "members",
+                "kind": "attribute",
+                "path": "docforge.models.module.DocObject.members",
+                "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.object.DocObject.members')>",
+                "docstring": null
+              },
+              "add_member": {
+                "name": "add_member",
+                "kind": "function",
+                "path": "docforge.models.module.DocObject.add_member",
+                "signature": "<bound method Alias.signature of Alias('add_member', 'docforge.models.object.DocObject.add_member')>",
+                "docstring": "Add a child member to this object (e.g., a method to a class).\n\nArgs:\n    obj: The child DocObject to add."
+              },
+              "get_member": {
+                "name": "get_member",
+                "kind": "function",
+                "path": "docforge.models.module.DocObject.get_member",
+                "signature": "<bound method Alias.signature of Alias('get_member', 'docforge.models.object.DocObject.get_member')>",
+                "docstring": "Retrieve a child member by name.\n\nArgs:\n    name: The name of the member.\n\nReturns:\n    The requested DocObject."
+              },
+              "get_all_members": {
+                "name": "get_all_members",
+                "kind": "function",
+                "path": "docforge.models.module.DocObject.get_all_members",
+                "signature": "<bound method Alias.signature of Alias('get_all_members', 'docforge.models.object.DocObject.get_all_members')>",
+                "docstring": "Get all members of this object.\n\nReturns:\n    An iterable of child DocObject instances."
+              }
+            }
+          },
+          "Module": {
+            "name": "Module",
+            "kind": "class",
+            "path": "docforge.models.module.Module",
+            "signature": "<bound method Class.signature of Class('Module', 12, 66)>",
+            "docstring": "Represents a documented Python module or package.\n\nAttributes:\n    path: Dotted import path of the module.\n    docstring: Module-level docstring content.\n    members: Dictionary mapping object names to their DocObject representations.",
+            "members": {
+              "path": {
+                "name": "path",
+                "kind": "attribute",
+                "path": "docforge.models.module.Module.path",
+                "signature": null,
+                "docstring": null
+              },
+              "docstring": {
+                "name": "docstring",
+                "kind": "attribute",
+                "path": "docforge.models.module.Module.docstring",
+                "signature": null,
+                "docstring": null
+              },
+              "members": {
+                "name": "members",
+                "kind": "attribute",
+                "path": "docforge.models.module.Module.members",
+                "signature": null,
+                "docstring": null
+              },
+              "add_object": {
+                "name": "add_object",
+                "kind": "function",
+                "path": "docforge.models.module.Module.add_object",
+                "signature": "<bound method Function.signature of Function('add_object', 38, 45)>",
+                "docstring": "Add a documented object to the module.\n\nArgs:\n    obj: The object to add."
+              },
+              "get_object": {
+                "name": "get_object",
+                "kind": "function",
+                "path": "docforge.models.module.Module.get_object",
+                "signature": "<bound method Function.signature of Function('get_object', 47, 57)>",
+                "docstring": "Retrieve a member object by name.\n\nArgs:\n    name: The name of the object.\n\nReturns:\n    The requested DocObject."
+              },
+              "get_all_objects": {
+                "name": "get_all_objects",
+                "kind": "function",
+                "path": "docforge.models.module.Module.get_all_objects",
+                "signature": "<bound method Function.signature of Function('get_all_objects', 59, 66)>",
+                "docstring": "Get all top-level objects in the module.\n\nReturns:\n    An iterable of DocObject instances."
+              }
+            }
+          }
+        }
+      },
+      "object": {
+        "name": "object",
+        "kind": "module",
+        "path": "docforge.models.object",
+        "signature": null,
+        "docstring": "This module defines the DocObject class, the fundamental recursive unit of the\ndoc-forge documentation models. A DocObject represents a single Python entity\n(class, function, method, or attribute) and its nested members.",
+        "members": {
+          "Dict": {
+            "name": "Dict",
+            "kind": "alias",
+            "path": "docforge.models.object.Dict",
+            "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+            "docstring": null
+          },
+          "Iterable": {
+            "name": "Iterable",
+            "kind": "alias",
+            "path": "docforge.models.object.Iterable",
+            "signature": "<bound method Alias.signature of Alias('Iterable', 'typing.Iterable')>",
+            "docstring": null
+          },
+          "Optional": {
+            "name": "Optional",
+            "kind": "alias",
+            "path": "docforge.models.object.Optional",
+            "signature": "<bound method Alias.signature of Alias('Optional', 'typing.Optional')>",
+            "docstring": null
+          },
+          "DocObject": {
+            "name": "DocObject",
+            "kind": "class",
+            "path": "docforge.models.object.DocObject",
+            "signature": "<bound method Class.signature of Class('DocObject', 10, 76)>",
+            "docstring": "Represents a documented Python object (class, function, method, etc.).\n\nAttributes:\n    name: Local name of the object.\n    kind: Type of object (e.g., 'class', 'function', 'attribute').\n    path: Full dotted import path to the object.\n    signature: Callable signature, if applicable.\n    docstring: Raw docstring content extracted from the source.\n    members: Dictionary mapping member names to their DocObject representations.",
+            "members": {
+              "name": {
+                "name": "name",
+                "kind": "attribute",
+                "path": "docforge.models.object.DocObject.name",
+                "signature": null,
+                "docstring": null
+              },
+              "kind": {
+                "name": "kind",
+                "kind": "attribute",
+                "path": "docforge.models.object.DocObject.kind",
+                "signature": null,
+                "docstring": null
+              },
+              "path": {
+                "name": "path",
+                "kind": "attribute",
+                "path": "docforge.models.object.DocObject.path",
+                "signature": null,
+                "docstring": null
+              },
+              "signature": {
+                "name": "signature",
+                "kind": "attribute",
+                "path": "docforge.models.object.DocObject.signature",
+                "signature": null,
+                "docstring": null
+              },
+              "docstring": {
+                "name": "docstring",
+                "kind": "attribute",
+                "path": "docforge.models.object.DocObject.docstring",
+                "signature": null,
+                "docstring": null
+              },
+              "members": {
+                "name": "members",
+                "kind": "attribute",
+                "path": "docforge.models.object.DocObject.members",
+                "signature": null,
+                "docstring": null
+              },
+              "add_member": {
+                "name": "add_member",
+                "kind": "function",
+                "path": "docforge.models.object.DocObject.add_member",
+                "signature": "<bound method Function.signature of Function('add_member', 48, 55)>",
+                "docstring": "Add a child member to this object (e.g., a method to a class).\n\nArgs:\n    obj: The child DocObject to add."
+              },
+              "get_member": {
+                "name": "get_member",
+                "kind": "function",
+                "path": "docforge.models.object.DocObject.get_member",
+                "signature": "<bound method Function.signature of Function('get_member', 57, 67)>",
+                "docstring": "Retrieve a child member by name.\n\nArgs:\n    name: The name of the member.\n\nReturns:\n    The requested DocObject."
+              },
+              "get_all_members": {
+                "name": "get_all_members",
+                "kind": "function",
+                "path": "docforge.models.object.DocObject.get_all_members",
+                "signature": "<bound method Function.signature of Function('get_all_members', 69, 76)>",
+                "docstring": "Get all members of this object.\n\nReturns:\n    An iterable of child DocObject instances."
+              }
+            }
+          }
+        }
+      },
+      "project": {
+        "name": "project",
+        "kind": "module",
+        "path": "docforge.models.project",
+        "signature": null,
+        "docstring": "This module defines the Project class, the top-level container for a documented\nproject. It aggregates multiple Module instances into a single named entity.",
+        "members": {
+          "Dict": {
+            "name": "Dict",
+            "kind": "alias",
+            "path": "docforge.models.project.Dict",
+            "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+            "docstring": null
+          },
+          "Iterable": {
+            "name": "Iterable",
+            "kind": "alias",
+            "path": "docforge.models.project.Iterable",
+            "signature": "<bound method Alias.signature of Alias('Iterable', 'typing.Iterable')>",
+            "docstring": null
+          },
+          "Module": {
+            "name": "Module",
+            "kind": "class",
+            "path": "docforge.models.project.Module",
+            "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.module.Module')>",
+            "docstring": "Represents a documented Python module or package.\n\nAttributes:\n    path: Dotted import path of the module.\n    docstring: Module-level docstring content.\n    members: Dictionary mapping object names to their DocObject representations.",
+            "members": {
+              "path": {
+                "name": "path",
+                "kind": "attribute",
+                "path": "docforge.models.project.Module.path",
+                "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.module.Module.path')>",
+                "docstring": null
+              },
+              "docstring": {
+                "name": "docstring",
+                "kind": "attribute",
+                "path": "docforge.models.project.Module.docstring",
+                "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.module.Module.docstring')>",
+                "docstring": null
+              },
+              "members": {
+                "name": "members",
+                "kind": "attribute",
+                "path": "docforge.models.project.Module.members",
+                "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.module.Module.members')>",
+                "docstring": null
+              },
+              "add_object": {
+                "name": "add_object",
+                "kind": "function",
+                "path": "docforge.models.project.Module.add_object",
+                "signature": "<bound method Alias.signature of Alias('add_object', 'docforge.models.module.Module.add_object')>",
+                "docstring": "Add a documented object to the module.\n\nArgs:\n    obj: The object to add."
+              },
+              "get_object": {
+                "name": "get_object",
+                "kind": "function",
+                "path": "docforge.models.project.Module.get_object",
+                "signature": "<bound method Alias.signature of Alias('get_object', 'docforge.models.module.Module.get_object')>",
+                "docstring": "Retrieve a member object by name.\n\nArgs:\n    name: The name of the object.\n\nReturns:\n    The requested DocObject."
+              },
+              "get_all_objects": {
+                "name": "get_all_objects",
+                "kind": "function",
+                "path": "docforge.models.project.Module.get_all_objects",
+                "signature": "<bound method Alias.signature of Alias('get_all_objects', 'docforge.models.module.Module.get_all_objects')>",
+                "docstring": "Get all top-level objects in the module.\n\nReturns:\n    An iterable of DocObject instances."
+              }
+            }
+          },
+          "Project": {
+            "name": "Project",
+            "kind": "class",
+            "path": "docforge.models.project.Project",
+            "signature": "<bound method Class.signature of Class('Project', 11, 67)>",
+            "docstring": "Represents a documentation project, serving as a container for modules.\n\nAttributes:\n    name: Name of the project.\n    modules: Dictionary mapping module paths to Module instances.",
+            "members": {
+              "name": {
+                "name": "name",
+                "kind": "attribute",
+                "path": "docforge.models.project.Project.name",
+                "signature": null,
+                "docstring": null
+              },
+              "modules": {
+                "name": "modules",
+                "kind": "attribute",
+                "path": "docforge.models.project.Project.modules",
+                "signature": null,
+                "docstring": null
+              },
+              "add_module": {
+                "name": "add_module",
+                "kind": "function",
+                "path": "docforge.models.project.Project.add_module",
+                "signature": "<bound method Function.signature of Function('add_module', 30, 37)>",
+                "docstring": "Add a module to the project.\n\nArgs:\n    module: The module to add."
+              },
+              "get_module": {
+                "name": "get_module",
+                "kind": "function",
+                "path": "docforge.models.project.Project.get_module",
+                "signature": "<bound method Function.signature of Function('get_module', 39, 49)>",
+                "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path: The dotted path of the module (e.g., 'pkg.mod').\n\nReturns:\n    The requested Module."
+              },
+              "get_all_modules": {
+                "name": "get_all_modules",
+                "kind": "function",
+                "path": "docforge.models.project.Project.get_all_modules",
+                "signature": "<bound method Function.signature of Function('get_all_modules', 51, 58)>",
+                "docstring": "Get all modules in the project.\n\nReturns:\n    An iterable of Module objects."
+              },
+              "get_module_list": {
+                "name": "get_module_list",
+                "kind": "function",
+                "path": "docforge.models.project.Project.get_module_list",
+                "signature": "<bound method Function.signature of Function('get_module_list', 60, 67)>",
+                "docstring": "Get the list of all module dotted paths.\n\nReturns:\n    A list of module paths."
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.models.module.json

@@ -0,0 +1,153 @@
+{
+  "module": "docforge.models.module",
+  "content": {
+    "path": "docforge.models.module",
+    "docstring": "This module defines the Module class, which represents a Python module or package\nin the doc-forge documentation models. It acts as a container for top-level\ndocumented objects.",
+    "objects": {
+      "Dict": {
+        "name": "Dict",
+        "kind": "alias",
+        "path": "docforge.models.module.Dict",
+        "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+        "docstring": null
+      },
+      "Iterable": {
+        "name": "Iterable",
+        "kind": "alias",
+        "path": "docforge.models.module.Iterable",
+        "signature": "<bound method Alias.signature of Alias('Iterable', 'typing.Iterable')>",
+        "docstring": null
+      },
+      "Optional": {
+        "name": "Optional",
+        "kind": "alias",
+        "path": "docforge.models.module.Optional",
+        "signature": "<bound method Alias.signature of Alias('Optional', 'typing.Optional')>",
+        "docstring": null
+      },
+      "DocObject": {
+        "name": "DocObject",
+        "kind": "class",
+        "path": "docforge.models.module.DocObject",
+        "signature": "<bound method Alias.signature of Alias('DocObject', 'docforge.models.object.DocObject')>",
+        "docstring": "Represents a documented Python object (class, function, method, etc.).\n\nAttributes:\n    name: Local name of the object.\n    kind: Type of object (e.g., 'class', 'function', 'attribute').\n    path: Full dotted import path to the object.\n    signature: Callable signature, if applicable.\n    docstring: Raw docstring content extracted from the source.\n    members: Dictionary mapping member names to their DocObject representations.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.models.module.DocObject.name",
+            "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.object.DocObject.name')>",
+            "docstring": null
+          },
+          "kind": {
+            "name": "kind",
+            "kind": "attribute",
+            "path": "docforge.models.module.DocObject.kind",
+            "signature": "<bound method Alias.signature of Alias('kind', 'docforge.models.object.DocObject.kind')>",
+            "docstring": null
+          },
+          "path": {
+            "name": "path",
+            "kind": "attribute",
+            "path": "docforge.models.module.DocObject.path",
+            "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.object.DocObject.path')>",
+            "docstring": null
+          },
+          "signature": {
+            "name": "signature",
+            "kind": "attribute",
+            "path": "docforge.models.module.DocObject.signature",
+            "signature": "<bound method Alias.signature of Alias('signature', 'docforge.models.object.DocObject.signature')>",
+            "docstring": null
+          },
+          "docstring": {
+            "name": "docstring",
+            "kind": "attribute",
+            "path": "docforge.models.module.DocObject.docstring",
+            "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.object.DocObject.docstring')>",
+            "docstring": null
+          },
+          "members": {
+            "name": "members",
+            "kind": "attribute",
+            "path": "docforge.models.module.DocObject.members",
+            "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.object.DocObject.members')>",
+            "docstring": null
+          },
+          "add_member": {
+            "name": "add_member",
+            "kind": "function",
+            "path": "docforge.models.module.DocObject.add_member",
+            "signature": "<bound method Alias.signature of Alias('add_member', 'docforge.models.object.DocObject.add_member')>",
+            "docstring": "Add a child member to this object (e.g., a method to a class).\n\nArgs:\n    obj: The child DocObject to add."
+          },
+          "get_member": {
+            "name": "get_member",
+            "kind": "function",
+            "path": "docforge.models.module.DocObject.get_member",
+            "signature": "<bound method Alias.signature of Alias('get_member', 'docforge.models.object.DocObject.get_member')>",
+            "docstring": "Retrieve a child member by name.\n\nArgs:\n    name: The name of the member.\n\nReturns:\n    The requested DocObject."
+          },
+          "get_all_members": {
+            "name": "get_all_members",
+            "kind": "function",
+            "path": "docforge.models.module.DocObject.get_all_members",
+            "signature": "<bound method Alias.signature of Alias('get_all_members', 'docforge.models.object.DocObject.get_all_members')>",
+            "docstring": "Get all members of this object.\n\nReturns:\n    An iterable of child DocObject instances."
+          }
+        }
+      },
+      "Module": {
+        "name": "Module",
+        "kind": "class",
+        "path": "docforge.models.module.Module",
+        "signature": "<bound method Class.signature of Class('Module', 12, 66)>",
+        "docstring": "Represents a documented Python module or package.\n\nAttributes:\n    path: Dotted import path of the module.\n    docstring: Module-level docstring content.\n    members: Dictionary mapping object names to their DocObject representations.",
+        "members": {
+          "path": {
+            "name": "path",
+            "kind": "attribute",
+            "path": "docforge.models.module.Module.path",
+            "signature": null,
+            "docstring": null
+          },
+          "docstring": {
+            "name": "docstring",
+            "kind": "attribute",
+            "path": "docforge.models.module.Module.docstring",
+            "signature": null,
+            "docstring": null
+          },
+          "members": {
+            "name": "members",
+            "kind": "attribute",
+            "path": "docforge.models.module.Module.members",
+            "signature": null,
+            "docstring": null
+          },
+          "add_object": {
+            "name": "add_object",
+            "kind": "function",
+            "path": "docforge.models.module.Module.add_object",
+            "signature": "<bound method Function.signature of Function('add_object', 38, 45)>",
+            "docstring": "Add a documented object to the module.\n\nArgs:\n    obj: The object to add."
+          },
+          "get_object": {
+            "name": "get_object",
+            "kind": "function",
+            "path": "docforge.models.module.Module.get_object",
+            "signature": "<bound method Function.signature of Function('get_object', 47, 57)>",
+            "docstring": "Retrieve a member object by name.\n\nArgs:\n    name: The name of the object.\n\nReturns:\n    The requested DocObject."
+          },
+          "get_all_objects": {
+            "name": "get_all_objects",
+            "kind": "function",
+            "path": "docforge.models.module.Module.get_all_objects",
+            "signature": "<bound method Function.signature of Function('get_all_objects', 59, 66)>",
+            "docstring": "Get all top-level objects in the module.\n\nReturns:\n    An iterable of DocObject instances."
+          }
+        }
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.models.object.json

@@ -0,0 +1,102 @@
+{
+  "module": "docforge.models.object",
+  "content": {
+    "path": "docforge.models.object",
+    "docstring": "This module defines the DocObject class, the fundamental recursive unit of the\ndoc-forge documentation models. A DocObject represents a single Python entity\n(class, function, method, or attribute) and its nested members.",
+    "objects": {
+      "Dict": {
+        "name": "Dict",
+        "kind": "alias",
+        "path": "docforge.models.object.Dict",
+        "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+        "docstring": null
+      },
+      "Iterable": {
+        "name": "Iterable",
+        "kind": "alias",
+        "path": "docforge.models.object.Iterable",
+        "signature": "<bound method Alias.signature of Alias('Iterable', 'typing.Iterable')>",
+        "docstring": null
+      },
+      "Optional": {
+        "name": "Optional",
+        "kind": "alias",
+        "path": "docforge.models.object.Optional",
+        "signature": "<bound method Alias.signature of Alias('Optional', 'typing.Optional')>",
+        "docstring": null
+      },
+      "DocObject": {
+        "name": "DocObject",
+        "kind": "class",
+        "path": "docforge.models.object.DocObject",
+        "signature": "<bound method Class.signature of Class('DocObject', 10, 76)>",
+        "docstring": "Represents a documented Python object (class, function, method, etc.).\n\nAttributes:\n    name: Local name of the object.\n    kind: Type of object (e.g., 'class', 'function', 'attribute').\n    path: Full dotted import path to the object.\n    signature: Callable signature, if applicable.\n    docstring: Raw docstring content extracted from the source.\n    members: Dictionary mapping member names to their DocObject representations.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.models.object.DocObject.name",
+            "signature": null,
+            "docstring": null
+          },
+          "kind": {
+            "name": "kind",
+            "kind": "attribute",
+            "path": "docforge.models.object.DocObject.kind",
+            "signature": null,
+            "docstring": null
+          },
+          "path": {
+            "name": "path",
+            "kind": "attribute",
+            "path": "docforge.models.object.DocObject.path",
+            "signature": null,
+            "docstring": null
+          },
+          "signature": {
+            "name": "signature",
+            "kind": "attribute",
+            "path": "docforge.models.object.DocObject.signature",
+            "signature": null,
+            "docstring": null
+          },
+          "docstring": {
+            "name": "docstring",
+            "kind": "attribute",
+            "path": "docforge.models.object.DocObject.docstring",
+            "signature": null,
+            "docstring": null
+          },
+          "members": {
+            "name": "members",
+            "kind": "attribute",
+            "path": "docforge.models.object.DocObject.members",
+            "signature": null,
+            "docstring": null
+          },
+          "add_member": {
+            "name": "add_member",
+            "kind": "function",
+            "path": "docforge.models.object.DocObject.add_member",
+            "signature": "<bound method Function.signature of Function('add_member', 48, 55)>",
+            "docstring": "Add a child member to this object (e.g., a method to a class).\n\nArgs:\n    obj: The child DocObject to add."
+          },
+          "get_member": {
+            "name": "get_member",
+            "kind": "function",
+            "path": "docforge.models.object.DocObject.get_member",
+            "signature": "<bound method Function.signature of Function('get_member', 57, 67)>",
+            "docstring": "Retrieve a child member by name.\n\nArgs:\n    name: The name of the member.\n\nReturns:\n    The requested DocObject."
+          },
+          "get_all_members": {
+            "name": "get_all_members",
+            "kind": "function",
+            "path": "docforge.models.object.DocObject.get_all_members",
+            "signature": "<bound method Function.signature of Function('get_all_members', 69, 76)>",
+            "docstring": "Get all members of this object.\n\nReturns:\n    An iterable of child DocObject instances."
+          }
+        }
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.models.project.json

@@ -0,0 +1,125 @@
+{
+  "module": "docforge.models.project",
+  "content": {
+    "path": "docforge.models.project",
+    "docstring": "This module defines the Project class, the top-level container for a documented\nproject. It aggregates multiple Module instances into a single named entity.",
+    "objects": {
+      "Dict": {
+        "name": "Dict",
+        "kind": "alias",
+        "path": "docforge.models.project.Dict",
+        "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+        "docstring": null
+      },
+      "Iterable": {
+        "name": "Iterable",
+        "kind": "alias",
+        "path": "docforge.models.project.Iterable",
+        "signature": "<bound method Alias.signature of Alias('Iterable', 'typing.Iterable')>",
+        "docstring": null
+      },
+      "Module": {
+        "name": "Module",
+        "kind": "class",
+        "path": "docforge.models.project.Module",
+        "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.module.Module')>",
+        "docstring": "Represents a documented Python module or package.\n\nAttributes:\n    path: Dotted import path of the module.\n    docstring: Module-level docstring content.\n    members: Dictionary mapping object names to their DocObject representations.",
+        "members": {
+          "path": {
+            "name": "path",
+            "kind": "attribute",
+            "path": "docforge.models.project.Module.path",
+            "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.module.Module.path')>",
+            "docstring": null
+          },
+          "docstring": {
+            "name": "docstring",
+            "kind": "attribute",
+            "path": "docforge.models.project.Module.docstring",
+            "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.module.Module.docstring')>",
+            "docstring": null
+          },
+          "members": {
+            "name": "members",
+            "kind": "attribute",
+            "path": "docforge.models.project.Module.members",
+            "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.module.Module.members')>",
+            "docstring": null
+          },
+          "add_object": {
+            "name": "add_object",
+            "kind": "function",
+            "path": "docforge.models.project.Module.add_object",
+            "signature": "<bound method Alias.signature of Alias('add_object', 'docforge.models.module.Module.add_object')>",
+            "docstring": "Add a documented object to the module.\n\nArgs:\n    obj: The object to add."
+          },
+          "get_object": {
+            "name": "get_object",
+            "kind": "function",
+            "path": "docforge.models.project.Module.get_object",
+            "signature": "<bound method Alias.signature of Alias('get_object', 'docforge.models.module.Module.get_object')>",
+            "docstring": "Retrieve a member object by name.\n\nArgs:\n    name: The name of the object.\n\nReturns:\n    The requested DocObject."
+          },
+          "get_all_objects": {
+            "name": "get_all_objects",
+            "kind": "function",
+            "path": "docforge.models.project.Module.get_all_objects",
+            "signature": "<bound method Alias.signature of Alias('get_all_objects', 'docforge.models.module.Module.get_all_objects')>",
+            "docstring": "Get all top-level objects in the module.\n\nReturns:\n    An iterable of DocObject instances."
+          }
+        }
+      },
+      "Project": {
+        "name": "Project",
+        "kind": "class",
+        "path": "docforge.models.project.Project",
+        "signature": "<bound method Class.signature of Class('Project', 11, 67)>",
+        "docstring": "Represents a documentation project, serving as a container for modules.\n\nAttributes:\n    name: Name of the project.\n    modules: Dictionary mapping module paths to Module instances.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.models.project.Project.name",
+            "signature": null,
+            "docstring": null
+          },
+          "modules": {
+            "name": "modules",
+            "kind": "attribute",
+            "path": "docforge.models.project.Project.modules",
+            "signature": null,
+            "docstring": null
+          },
+          "add_module": {
+            "name": "add_module",
+            "kind": "function",
+            "path": "docforge.models.project.Project.add_module",
+            "signature": "<bound method Function.signature of Function('add_module', 30, 37)>",
+            "docstring": "Add a module to the project.\n\nArgs:\n    module: The module to add."
+          },
+          "get_module": {
+            "name": "get_module",
+            "kind": "function",
+            "path": "docforge.models.project.Project.get_module",
+            "signature": "<bound method Function.signature of Function('get_module', 39, 49)>",
+            "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path: The dotted path of the module (e.g., 'pkg.mod').\n\nReturns:\n    The requested Module."
+          },
+          "get_all_modules": {
+            "name": "get_all_modules",
+            "kind": "function",
+            "path": "docforge.models.project.Project.get_all_modules",
+            "signature": "<bound method Function.signature of Function('get_all_modules', 51, 58)>",
+            "docstring": "Get all modules in the project.\n\nReturns:\n    An iterable of Module objects."
+          },
+          "get_module_list": {
+            "name": "get_module_list",
+            "kind": "function",
+            "path": "docforge.models.project.Project.get_module_list",
+            "signature": "<bound method Function.signature of Function('get_module_list', 60, 67)>",
+            "docstring": "Get the list of all module dotted paths.\n\nReturns:\n    A list of module paths."
+          }
+        }
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.nav.json

@@ -0,0 +1,402 @@
+{
+  "module": "docforge.nav",
+  "content": {
+    "path": "docforge.nav",
+    "docstring": "# Navigation Layer\n\nThe `docforge.nav` package manages the mapping between the logical documentation\nstructure and the physical files on disk.\n\n## Workflow\n\n1.  **Spec Definition**: Users define navigation intent in `docforge.nav.yml`.\n2.  **Resolution**: `resolve_nav` matches patterns in the spec to generated `.md` files.\n3.  **Emission**: `MkDocsNavEmitter` produces the final YAML structure for `mkdocs.yml`.\n\nThis abstraction allows doc-forge to support complex grouping and ordering\nindependently of the source code's physical layout.",
+    "objects": {
+      "NavSpec": {
+        "name": "NavSpec",
+        "kind": "class",
+        "path": "docforge.nav.NavSpec",
+        "signature": "<bound method Alias.signature of Alias('NavSpec', 'docforge.nav.spec.NavSpec')>",
+        "docstring": "Parsed representation of the docforge navigation specification file.\n\nAttributes:\n    home: Path to the home document (e.g., 'index.md').\n    groups: Mapping of group titles to lists of path patterns/globs.",
+        "members": {
+          "home": {
+            "name": "home",
+            "kind": "attribute",
+            "path": "docforge.nav.NavSpec.home",
+            "signature": "<bound method Alias.signature of Alias('home', 'docforge.nav.spec.NavSpec.home')>",
+            "docstring": null
+          },
+          "groups": {
+            "name": "groups",
+            "kind": "attribute",
+            "path": "docforge.nav.NavSpec.groups",
+            "signature": "<bound method Alias.signature of Alias('groups', 'docforge.nav.spec.NavSpec.groups')>",
+            "docstring": null
+          },
+          "load": {
+            "name": "load",
+            "kind": "function",
+            "path": "docforge.nav.NavSpec.load",
+            "signature": "<bound method Alias.signature of Alias('load', 'docforge.nav.spec.NavSpec.load')>",
+            "docstring": "Load a NavSpec from a YAML file.\n\nArgs:\n    path: The filesystem path to the YAML file.\n\nReturns:\n    A NavSpec instance.\n\nRaises:\n    FileNotFoundError: If the path does not exist.\n    ValueError: If the file content is not a valid NavSpec mapping."
+          },
+          "all_patterns": {
+            "name": "all_patterns",
+            "kind": "function",
+            "path": "docforge.nav.NavSpec.all_patterns",
+            "signature": "<bound method Alias.signature of Alias('all_patterns', 'docforge.nav.spec.NavSpec.all_patterns')>",
+            "docstring": "Get all path patterns referenced in the specification.\n\nReturns:\n    A list of all patterns (home plus all groups)."
+          }
+        }
+      },
+      "load_nav_spec": {
+        "name": "load_nav_spec",
+        "kind": "function",
+        "path": "docforge.nav.load_nav_spec",
+        "signature": "<bound method Alias.signature of Alias('load_nav_spec', 'docforge.nav.spec.load_nav_spec')>",
+        "docstring": "Utility function to load a NavSpec from a file.\n\nArgs:\n    path: Path to the navigation specification file.\n\nReturns:\n    A loaded NavSpec instance."
+      },
+      "ResolvedNav": {
+        "name": "ResolvedNav",
+        "kind": "class",
+        "path": "docforge.nav.ResolvedNav",
+        "signature": "<bound method Alias.signature of Alias('ResolvedNav', 'docforge.nav.resolver.ResolvedNav')>",
+        "docstring": "Represents a navigation structure where all patterns and paths have been\nresolved against the actual filesystem contents.\n\nAttributes:\n    home: Resolved relative path to the home page.\n    groups: Mapping of group titles to lists of absolute or relative Path objects.",
+        "members": {
+          "home": {
+            "name": "home",
+            "kind": "attribute",
+            "path": "docforge.nav.ResolvedNav.home",
+            "signature": "<bound method Alias.signature of Alias('home', 'docforge.nav.resolver.ResolvedNav.home')>",
+            "docstring": null
+          },
+          "groups": {
+            "name": "groups",
+            "kind": "attribute",
+            "path": "docforge.nav.ResolvedNav.groups",
+            "signature": "<bound method Alias.signature of Alias('groups', 'docforge.nav.resolver.ResolvedNav.groups')>",
+            "docstring": null
+          },
+          "all_files": {
+            "name": "all_files",
+            "kind": "function",
+            "path": "docforge.nav.ResolvedNav.all_files",
+            "signature": "<bound method Alias.signature of Alias('all_files', 'docforge.nav.resolver.ResolvedNav.all_files')>",
+            "docstring": "Get an iterable of all resolved files in the navigation structure.\n\nReturns:\n    An iterable of Path objects."
+          }
+        }
+      },
+      "resolve_nav": {
+        "name": "resolve_nav",
+        "kind": "function",
+        "path": "docforge.nav.resolve_nav",
+        "signature": "<bound method Alias.signature of Alias('resolve_nav', 'docforge.nav.resolver.resolve_nav')>",
+        "docstring": "Create a ResolvedNav by processing a NavSpec against the filesystem.\nThis expands globs and validates the existence of referenced files.\n\nArgs:\n    spec: The navigation specification to resolve.\n    docs_root: The root directory for documentation files.\n\nReturns:\n    A ResolvedNav instance.\n\nRaises:\n    FileNotFoundError: If a pattern doesn't match any files or the docs_root doesn't exist."
+      },
+      "MkDocsNavEmitter": {
+        "name": "MkDocsNavEmitter",
+        "kind": "class",
+        "path": "docforge.nav.MkDocsNavEmitter",
+        "signature": "<bound method Alias.signature of Alias('MkDocsNavEmitter', 'docforge.nav.mkdocs.MkDocsNavEmitter')>",
+        "docstring": "Emitter responsible for transforming a ResolvedNav into an MkDocs-compatible\nnavigation structure.",
+        "members": {
+          "emit": {
+            "name": "emit",
+            "kind": "function",
+            "path": "docforge.nav.MkDocsNavEmitter.emit",
+            "signature": "<bound method Alias.signature of Alias('emit', 'docforge.nav.mkdocs.MkDocsNavEmitter.emit')>",
+            "docstring": "Generate a list of navigation entries for mkdocs.yml.\n\nArgs:\n    nav: The resolved navigation data.\n\nReturns:\n    A list of dictionary mappings representing the MkDocs navigation."
+          }
+        }
+      },
+      "mkdocs": {
+        "name": "mkdocs",
+        "kind": "module",
+        "path": "docforge.nav.mkdocs",
+        "signature": null,
+        "docstring": "This module provides the MkDocsNavEmitter, which converts a ResolvedNav instance\ninto the specific YAML-ready list structure expected by the MkDocs 'nav'\nconfiguration.",
+        "members": {
+          "Path": {
+            "name": "Path",
+            "kind": "alias",
+            "path": "docforge.nav.mkdocs.Path",
+            "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+            "docstring": null
+          },
+          "List": {
+            "name": "List",
+            "kind": "alias",
+            "path": "docforge.nav.mkdocs.List",
+            "signature": "<bound method Alias.signature of Alias('List', 'typing.List')>",
+            "docstring": null
+          },
+          "Dict": {
+            "name": "Dict",
+            "kind": "alias",
+            "path": "docforge.nav.mkdocs.Dict",
+            "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+            "docstring": null
+          },
+          "Any": {
+            "name": "Any",
+            "kind": "alias",
+            "path": "docforge.nav.mkdocs.Any",
+            "signature": "<bound method Alias.signature of Alias('Any', 'typing.Any')>",
+            "docstring": null
+          },
+          "ResolvedNav": {
+            "name": "ResolvedNav",
+            "kind": "class",
+            "path": "docforge.nav.mkdocs.ResolvedNav",
+            "signature": "<bound method Alias.signature of Alias('ResolvedNav', 'docforge.nav.resolver.ResolvedNav')>",
+            "docstring": "Represents a navigation structure where all patterns and paths have been\nresolved against the actual filesystem contents.\n\nAttributes:\n    home: Resolved relative path to the home page.\n    groups: Mapping of group titles to lists of absolute or relative Path objects.",
+            "members": {
+              "home": {
+                "name": "home",
+                "kind": "attribute",
+                "path": "docforge.nav.mkdocs.ResolvedNav.home",
+                "signature": "<bound method Alias.signature of Alias('home', 'docforge.nav.resolver.ResolvedNav.home')>",
+                "docstring": null
+              },
+              "groups": {
+                "name": "groups",
+                "kind": "attribute",
+                "path": "docforge.nav.mkdocs.ResolvedNav.groups",
+                "signature": "<bound method Alias.signature of Alias('groups', 'docforge.nav.resolver.ResolvedNav.groups')>",
+                "docstring": null
+              },
+              "all_files": {
+                "name": "all_files",
+                "kind": "function",
+                "path": "docforge.nav.mkdocs.ResolvedNav.all_files",
+                "signature": "<bound method Alias.signature of Alias('all_files', 'docforge.nav.resolver.ResolvedNav.all_files')>",
+                "docstring": "Get an iterable of all resolved files in the navigation structure.\n\nReturns:\n    An iterable of Path objects."
+              }
+            }
+          },
+          "MkDocsNavEmitter": {
+            "name": "MkDocsNavEmitter",
+            "kind": "class",
+            "path": "docforge.nav.mkdocs.MkDocsNavEmitter",
+            "signature": "<bound method Class.signature of Class('MkDocsNavEmitter', 13, 72)>",
+            "docstring": "Emitter responsible for transforming a ResolvedNav into an MkDocs-compatible\nnavigation structure.",
+            "members": {
+              "emit": {
+                "name": "emit",
+                "kind": "function",
+                "path": "docforge.nav.mkdocs.MkDocsNavEmitter.emit",
+                "signature": "<bound method Function.signature of Function('emit', 19, 44)>",
+                "docstring": "Generate a list of navigation entries for mkdocs.yml.\n\nArgs:\n    nav: The resolved navigation data.\n\nReturns:\n    A list of dictionary mappings representing the MkDocs navigation."
+              }
+            }
+          }
+        }
+      },
+      "resolver": {
+        "name": "resolver",
+        "kind": "module",
+        "path": "docforge.nav.resolver",
+        "signature": null,
+        "docstring": "This module contains the logic for resolving a NavSpec against the physical\nfilesystem. It expands globs and validates that all referenced documents\nactually exist on disk.",
+        "members": {
+          "Path": {
+            "name": "Path",
+            "kind": "alias",
+            "path": "docforge.nav.resolver.Path",
+            "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+            "docstring": null
+          },
+          "Dict": {
+            "name": "Dict",
+            "kind": "alias",
+            "path": "docforge.nav.resolver.Dict",
+            "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+            "docstring": null
+          },
+          "Iterable": {
+            "name": "Iterable",
+            "kind": "alias",
+            "path": "docforge.nav.resolver.Iterable",
+            "signature": "<bound method Alias.signature of Alias('Iterable', 'typing.Iterable')>",
+            "docstring": null
+          },
+          "List": {
+            "name": "List",
+            "kind": "alias",
+            "path": "docforge.nav.resolver.List",
+            "signature": "<bound method Alias.signature of Alias('List', 'typing.List')>",
+            "docstring": null
+          },
+          "glob": {
+            "name": "glob",
+            "kind": "alias",
+            "path": "docforge.nav.resolver.glob",
+            "signature": "<bound method Alias.signature of Alias('glob', 'glob')>",
+            "docstring": null
+          },
+          "NavSpec": {
+            "name": "NavSpec",
+            "kind": "class",
+            "path": "docforge.nav.resolver.NavSpec",
+            "signature": "<bound method Alias.signature of Alias('NavSpec', 'docforge.nav.spec.NavSpec')>",
+            "docstring": "Parsed representation of the docforge navigation specification file.\n\nAttributes:\n    home: Path to the home document (e.g., 'index.md').\n    groups: Mapping of group titles to lists of path patterns/globs.",
+            "members": {
+              "home": {
+                "name": "home",
+                "kind": "attribute",
+                "path": "docforge.nav.resolver.NavSpec.home",
+                "signature": "<bound method Alias.signature of Alias('home', 'docforge.nav.spec.NavSpec.home')>",
+                "docstring": null
+              },
+              "groups": {
+                "name": "groups",
+                "kind": "attribute",
+                "path": "docforge.nav.resolver.NavSpec.groups",
+                "signature": "<bound method Alias.signature of Alias('groups', 'docforge.nav.spec.NavSpec.groups')>",
+                "docstring": null
+              },
+              "load": {
+                "name": "load",
+                "kind": "function",
+                "path": "docforge.nav.resolver.NavSpec.load",
+                "signature": "<bound method Alias.signature of Alias('load', 'docforge.nav.spec.NavSpec.load')>",
+                "docstring": "Load a NavSpec from a YAML file.\n\nArgs:\n    path: The filesystem path to the YAML file.\n\nReturns:\n    A NavSpec instance.\n\nRaises:\n    FileNotFoundError: If the path does not exist.\n    ValueError: If the file content is not a valid NavSpec mapping."
+              },
+              "all_patterns": {
+                "name": "all_patterns",
+                "kind": "function",
+                "path": "docforge.nav.resolver.NavSpec.all_patterns",
+                "signature": "<bound method Alias.signature of Alias('all_patterns', 'docforge.nav.spec.NavSpec.all_patterns')>",
+                "docstring": "Get all path patterns referenced in the specification.\n\nReturns:\n    A list of all patterns (home plus all groups)."
+              }
+            }
+          },
+          "ResolvedNav": {
+            "name": "ResolvedNav",
+            "kind": "class",
+            "path": "docforge.nav.resolver.ResolvedNav",
+            "signature": "<bound method Class.signature of Class('ResolvedNav', 15, 56)>",
+            "docstring": "Represents a navigation structure where all patterns and paths have been\nresolved against the actual filesystem contents.\n\nAttributes:\n    home: Resolved relative path to the home page.\n    groups: Mapping of group titles to lists of absolute or relative Path objects.",
+            "members": {
+              "home": {
+                "name": "home",
+                "kind": "attribute",
+                "path": "docforge.nav.resolver.ResolvedNav.home",
+                "signature": null,
+                "docstring": null
+              },
+              "groups": {
+                "name": "groups",
+                "kind": "attribute",
+                "path": "docforge.nav.resolver.ResolvedNav.groups",
+                "signature": null,
+                "docstring": null
+              },
+              "all_files": {
+                "name": "all_files",
+                "kind": "function",
+                "path": "docforge.nav.resolver.ResolvedNav.all_files",
+                "signature": "<bound method Function.signature of Function('all_files', 43, 56)>",
+                "docstring": "Get an iterable of all resolved files in the navigation structure.\n\nReturns:\n    An iterable of Path objects."
+              }
+            }
+          },
+          "resolve_nav": {
+            "name": "resolve_nav",
+            "kind": "function",
+            "path": "docforge.nav.resolver.resolve_nav",
+            "signature": "<bound method Function.signature of Function('resolve_nav', 59, 112)>",
+            "docstring": "Create a ResolvedNav by processing a NavSpec against the filesystem.\nThis expands globs and validates the existence of referenced files.\n\nArgs:\n    spec: The navigation specification to resolve.\n    docs_root: The root directory for documentation files.\n\nReturns:\n    A ResolvedNav instance.\n\nRaises:\n    FileNotFoundError: If a pattern doesn't match any files or the docs_root doesn't exist."
+          },
+          "Optional": {
+            "name": "Optional",
+            "kind": "alias",
+            "path": "docforge.nav.resolver.Optional",
+            "signature": "<bound method Alias.signature of Alias('Optional', 'typing.Optional')>",
+            "docstring": null
+          }
+        }
+      },
+      "spec": {
+        "name": "spec",
+        "kind": "module",
+        "path": "docforge.nav.spec",
+        "signature": null,
+        "docstring": "This module defines the NavSpec class, which represents the user's intent for\ndocumentation navigation as defined in a YAML specification (usually\ndocforge.nav.yml).",
+        "members": {
+          "Path": {
+            "name": "Path",
+            "kind": "alias",
+            "path": "docforge.nav.spec.Path",
+            "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+            "docstring": null
+          },
+          "Dict": {
+            "name": "Dict",
+            "kind": "alias",
+            "path": "docforge.nav.spec.Dict",
+            "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+            "docstring": null
+          },
+          "List": {
+            "name": "List",
+            "kind": "alias",
+            "path": "docforge.nav.spec.List",
+            "signature": "<bound method Alias.signature of Alias('List', 'typing.List')>",
+            "docstring": null
+          },
+          "Optional": {
+            "name": "Optional",
+            "kind": "alias",
+            "path": "docforge.nav.spec.Optional",
+            "signature": "<bound method Alias.signature of Alias('Optional', 'typing.Optional')>",
+            "docstring": null
+          },
+          "yaml": {
+            "name": "yaml",
+            "kind": "alias",
+            "path": "docforge.nav.spec.yaml",
+            "signature": "<bound method Alias.signature of Alias('yaml', 'yaml')>",
+            "docstring": null
+          },
+          "NavSpec": {
+            "name": "NavSpec",
+            "kind": "class",
+            "path": "docforge.nav.spec.NavSpec",
+            "signature": "<bound method Class.signature of Class('NavSpec', 13, 91)>",
+            "docstring": "Parsed representation of the docforge navigation specification file.\n\nAttributes:\n    home: Path to the home document (e.g., 'index.md').\n    groups: Mapping of group titles to lists of path patterns/globs.",
+            "members": {
+              "home": {
+                "name": "home",
+                "kind": "attribute",
+                "path": "docforge.nav.spec.NavSpec.home",
+                "signature": null,
+                "docstring": null
+              },
+              "groups": {
+                "name": "groups",
+                "kind": "attribute",
+                "path": "docforge.nav.spec.NavSpec.groups",
+                "signature": null,
+                "docstring": null
+              },
+              "load": {
+                "name": "load",
+                "kind": "function",
+                "path": "docforge.nav.spec.NavSpec.load",
+                "signature": "<bound method Function.signature of Function('load', 37, 77)>",
+                "docstring": "Load a NavSpec from a YAML file.\n\nArgs:\n    path: The filesystem path to the YAML file.\n\nReturns:\n    A NavSpec instance.\n\nRaises:\n    FileNotFoundError: If the path does not exist.\n    ValueError: If the file content is not a valid NavSpec mapping."
+              },
+              "all_patterns": {
+                "name": "all_patterns",
+                "kind": "function",
+                "path": "docforge.nav.spec.NavSpec.all_patterns",
+                "signature": "<bound method Function.signature of Function('all_patterns', 79, 91)>",
+                "docstring": "Get all path patterns referenced in the specification.\n\nReturns:\n    A list of all patterns (home plus all groups)."
+              }
+            }
+          },
+          "load_nav_spec": {
+            "name": "load_nav_spec",
+            "kind": "function",
+            "path": "docforge.nav.spec.load_nav_spec",
+            "signature": "<bound method Function.signature of Function('load_nav_spec', 94, 114)>",
+            "docstring": "Utility function to load a NavSpec from a file.\n\nArgs:\n    path: Path to the navigation specification file.\n\nReturns:\n    A loaded NavSpec instance."
+          }
+        }
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.nav.mkdocs.json

@@ -0,0 +1,83 @@
+{
+  "module": "docforge.nav.mkdocs",
+  "content": {
+    "path": "docforge.nav.mkdocs",
+    "docstring": "This module provides the MkDocsNavEmitter, which converts a ResolvedNav instance\ninto the specific YAML-ready list structure expected by the MkDocs 'nav'\nconfiguration.",
+    "objects": {
+      "Path": {
+        "name": "Path",
+        "kind": "alias",
+        "path": "docforge.nav.mkdocs.Path",
+        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+        "docstring": null
+      },
+      "List": {
+        "name": "List",
+        "kind": "alias",
+        "path": "docforge.nav.mkdocs.List",
+        "signature": "<bound method Alias.signature of Alias('List', 'typing.List')>",
+        "docstring": null
+      },
+      "Dict": {
+        "name": "Dict",
+        "kind": "alias",
+        "path": "docforge.nav.mkdocs.Dict",
+        "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+        "docstring": null
+      },
+      "Any": {
+        "name": "Any",
+        "kind": "alias",
+        "path": "docforge.nav.mkdocs.Any",
+        "signature": "<bound method Alias.signature of Alias('Any', 'typing.Any')>",
+        "docstring": null
+      },
+      "ResolvedNav": {
+        "name": "ResolvedNav",
+        "kind": "class",
+        "path": "docforge.nav.mkdocs.ResolvedNav",
+        "signature": "<bound method Alias.signature of Alias('ResolvedNav', 'docforge.nav.resolver.ResolvedNav')>",
+        "docstring": "Represents a navigation structure where all patterns and paths have been\nresolved against the actual filesystem contents.\n\nAttributes:\n    home: Resolved relative path to the home page.\n    groups: Mapping of group titles to lists of absolute or relative Path objects.",
+        "members": {
+          "home": {
+            "name": "home",
+            "kind": "attribute",
+            "path": "docforge.nav.mkdocs.ResolvedNav.home",
+            "signature": "<bound method Alias.signature of Alias('home', 'docforge.nav.resolver.ResolvedNav.home')>",
+            "docstring": null
+          },
+          "groups": {
+            "name": "groups",
+            "kind": "attribute",
+            "path": "docforge.nav.mkdocs.ResolvedNav.groups",
+            "signature": "<bound method Alias.signature of Alias('groups', 'docforge.nav.resolver.ResolvedNav.groups')>",
+            "docstring": null
+          },
+          "all_files": {
+            "name": "all_files",
+            "kind": "function",
+            "path": "docforge.nav.mkdocs.ResolvedNav.all_files",
+            "signature": "<bound method Alias.signature of Alias('all_files', 'docforge.nav.resolver.ResolvedNav.all_files')>",
+            "docstring": "Get an iterable of all resolved files in the navigation structure.\n\nReturns:\n    An iterable of Path objects."
+          }
+        }
+      },
+      "MkDocsNavEmitter": {
+        "name": "MkDocsNavEmitter",
+        "kind": "class",
+        "path": "docforge.nav.mkdocs.MkDocsNavEmitter",
+        "signature": "<bound method Class.signature of Class('MkDocsNavEmitter', 13, 72)>",
+        "docstring": "Emitter responsible for transforming a ResolvedNav into an MkDocs-compatible\nnavigation structure.",
+        "members": {
+          "emit": {
+            "name": "emit",
+            "kind": "function",
+            "path": "docforge.nav.mkdocs.MkDocsNavEmitter.emit",
+            "signature": "<bound method Function.signature of Function('emit', 19, 44)>",
+            "docstring": "Generate a list of navigation entries for mkdocs.yml.\n\nArgs:\n    nav: The resolved navigation data.\n\nReturns:\n    A list of dictionary mappings representing the MkDocs navigation."
+          }
+        }
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.nav.resolver.json

@@ -0,0 +1,125 @@
+{
+  "module": "docforge.nav.resolver",
+  "content": {
+    "path": "docforge.nav.resolver",
+    "docstring": "This module contains the logic for resolving a NavSpec against the physical\nfilesystem. It expands globs and validates that all referenced documents\nactually exist on disk.",
+    "objects": {
+      "Path": {
+        "name": "Path",
+        "kind": "alias",
+        "path": "docforge.nav.resolver.Path",
+        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+        "docstring": null
+      },
+      "Dict": {
+        "name": "Dict",
+        "kind": "alias",
+        "path": "docforge.nav.resolver.Dict",
+        "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+        "docstring": null
+      },
+      "Iterable": {
+        "name": "Iterable",
+        "kind": "alias",
+        "path": "docforge.nav.resolver.Iterable",
+        "signature": "<bound method Alias.signature of Alias('Iterable', 'typing.Iterable')>",
+        "docstring": null
+      },
+      "List": {
+        "name": "List",
+        "kind": "alias",
+        "path": "docforge.nav.resolver.List",
+        "signature": "<bound method Alias.signature of Alias('List', 'typing.List')>",
+        "docstring": null
+      },
+      "glob": {
+        "name": "glob",
+        "kind": "alias",
+        "path": "docforge.nav.resolver.glob",
+        "signature": "<bound method Alias.signature of Alias('glob', 'glob')>",
+        "docstring": null
+      },
+      "NavSpec": {
+        "name": "NavSpec",
+        "kind": "class",
+        "path": "docforge.nav.resolver.NavSpec",
+        "signature": "<bound method Alias.signature of Alias('NavSpec', 'docforge.nav.spec.NavSpec')>",
+        "docstring": "Parsed representation of the docforge navigation specification file.\n\nAttributes:\n    home: Path to the home document (e.g., 'index.md').\n    groups: Mapping of group titles to lists of path patterns/globs.",
+        "members": {
+          "home": {
+            "name": "home",
+            "kind": "attribute",
+            "path": "docforge.nav.resolver.NavSpec.home",
+            "signature": "<bound method Alias.signature of Alias('home', 'docforge.nav.spec.NavSpec.home')>",
+            "docstring": null
+          },
+          "groups": {
+            "name": "groups",
+            "kind": "attribute",
+            "path": "docforge.nav.resolver.NavSpec.groups",
+            "signature": "<bound method Alias.signature of Alias('groups', 'docforge.nav.spec.NavSpec.groups')>",
+            "docstring": null
+          },
+          "load": {
+            "name": "load",
+            "kind": "function",
+            "path": "docforge.nav.resolver.NavSpec.load",
+            "signature": "<bound method Alias.signature of Alias('load', 'docforge.nav.spec.NavSpec.load')>",
+            "docstring": "Load a NavSpec from a YAML file.\n\nArgs:\n    path: The filesystem path to the YAML file.\n\nReturns:\n    A NavSpec instance.\n\nRaises:\n    FileNotFoundError: If the path does not exist.\n    ValueError: If the file content is not a valid NavSpec mapping."
+          },
+          "all_patterns": {
+            "name": "all_patterns",
+            "kind": "function",
+            "path": "docforge.nav.resolver.NavSpec.all_patterns",
+            "signature": "<bound method Alias.signature of Alias('all_patterns', 'docforge.nav.spec.NavSpec.all_patterns')>",
+            "docstring": "Get all path patterns referenced in the specification.\n\nReturns:\n    A list of all patterns (home plus all groups)."
+          }
+        }
+      },
+      "ResolvedNav": {
+        "name": "ResolvedNav",
+        "kind": "class",
+        "path": "docforge.nav.resolver.ResolvedNav",
+        "signature": "<bound method Class.signature of Class('ResolvedNav', 15, 56)>",
+        "docstring": "Represents a navigation structure where all patterns and paths have been\nresolved against the actual filesystem contents.\n\nAttributes:\n    home: Resolved relative path to the home page.\n    groups: Mapping of group titles to lists of absolute or relative Path objects.",
+        "members": {
+          "home": {
+            "name": "home",
+            "kind": "attribute",
+            "path": "docforge.nav.resolver.ResolvedNav.home",
+            "signature": null,
+            "docstring": null
+          },
+          "groups": {
+            "name": "groups",
+            "kind": "attribute",
+            "path": "docforge.nav.resolver.ResolvedNav.groups",
+            "signature": null,
+            "docstring": null
+          },
+          "all_files": {
+            "name": "all_files",
+            "kind": "function",
+            "path": "docforge.nav.resolver.ResolvedNav.all_files",
+            "signature": "<bound method Function.signature of Function('all_files', 43, 56)>",
+            "docstring": "Get an iterable of all resolved files in the navigation structure.\n\nReturns:\n    An iterable of Path objects."
+          }
+        }
+      },
+      "resolve_nav": {
+        "name": "resolve_nav",
+        "kind": "function",
+        "path": "docforge.nav.resolver.resolve_nav",
+        "signature": "<bound method Function.signature of Function('resolve_nav', 59, 112)>",
+        "docstring": "Create a ResolvedNav by processing a NavSpec against the filesystem.\nThis expands globs and validates the existence of referenced files.\n\nArgs:\n    spec: The navigation specification to resolve.\n    docs_root: The root directory for documentation files.\n\nReturns:\n    A ResolvedNav instance.\n\nRaises:\n    FileNotFoundError: If a pattern doesn't match any files or the docs_root doesn't exist."
+      },
+      "Optional": {
+        "name": "Optional",
+        "kind": "alias",
+        "path": "docforge.nav.resolver.Optional",
+        "signature": "<bound method Alias.signature of Alias('Optional', 'typing.Optional')>",
+        "docstring": null
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.nav.spec.json

@@ -0,0 +1,88 @@
+{
+  "module": "docforge.nav.spec",
+  "content": {
+    "path": "docforge.nav.spec",
+    "docstring": "This module defines the NavSpec class, which represents the user's intent for\ndocumentation navigation as defined in a YAML specification (usually\ndocforge.nav.yml).",
+    "objects": {
+      "Path": {
+        "name": "Path",
+        "kind": "alias",
+        "path": "docforge.nav.spec.Path",
+        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+        "docstring": null
+      },
+      "Dict": {
+        "name": "Dict",
+        "kind": "alias",
+        "path": "docforge.nav.spec.Dict",
+        "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+        "docstring": null
+      },
+      "List": {
+        "name": "List",
+        "kind": "alias",
+        "path": "docforge.nav.spec.List",
+        "signature": "<bound method Alias.signature of Alias('List', 'typing.List')>",
+        "docstring": null
+      },
+      "Optional": {
+        "name": "Optional",
+        "kind": "alias",
+        "path": "docforge.nav.spec.Optional",
+        "signature": "<bound method Alias.signature of Alias('Optional', 'typing.Optional')>",
+        "docstring": null
+      },
+      "yaml": {
+        "name": "yaml",
+        "kind": "alias",
+        "path": "docforge.nav.spec.yaml",
+        "signature": "<bound method Alias.signature of Alias('yaml', 'yaml')>",
+        "docstring": null
+      },
+      "NavSpec": {
+        "name": "NavSpec",
+        "kind": "class",
+        "path": "docforge.nav.spec.NavSpec",
+        "signature": "<bound method Class.signature of Class('NavSpec', 13, 91)>",
+        "docstring": "Parsed representation of the docforge navigation specification file.\n\nAttributes:\n    home: Path to the home document (e.g., 'index.md').\n    groups: Mapping of group titles to lists of path patterns/globs.",
+        "members": {
+          "home": {
+            "name": "home",
+            "kind": "attribute",
+            "path": "docforge.nav.spec.NavSpec.home",
+            "signature": null,
+            "docstring": null
+          },
+          "groups": {
+            "name": "groups",
+            "kind": "attribute",
+            "path": "docforge.nav.spec.NavSpec.groups",
+            "signature": null,
+            "docstring": null
+          },
+          "load": {
+            "name": "load",
+            "kind": "function",
+            "path": "docforge.nav.spec.NavSpec.load",
+            "signature": "<bound method Function.signature of Function('load', 37, 77)>",
+            "docstring": "Load a NavSpec from a YAML file.\n\nArgs:\n    path: The filesystem path to the YAML file.\n\nReturns:\n    A NavSpec instance.\n\nRaises:\n    FileNotFoundError: If the path does not exist.\n    ValueError: If the file content is not a valid NavSpec mapping."
+          },
+          "all_patterns": {
+            "name": "all_patterns",
+            "kind": "function",
+            "path": "docforge.nav.spec.NavSpec.all_patterns",
+            "signature": "<bound method Function.signature of Function('all_patterns', 79, 91)>",
+            "docstring": "Get all path patterns referenced in the specification.\n\nReturns:\n    A list of all patterns (home plus all groups)."
+          }
+        }
+      },
+      "load_nav_spec": {
+        "name": "load_nav_spec",
+        "kind": "function",
+        "path": "docforge.nav.spec.load_nav_spec",
+        "signature": "<bound method Function.signature of Function('load_nav_spec', 94, 114)>",
+        "docstring": "Utility function to load a NavSpec from a file.\n\nArgs:\n    path: Path to the navigation specification file.\n\nReturns:\n    A loaded NavSpec instance."
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.renderers.base.json

@@ -0,0 +1,120 @@
+{
+  "module": "docforge.renderers.base",
+  "content": {
+    "path": "docforge.renderers.base",
+    "docstring": "This module defines the base interfaces and configuration containers for\ndoc-forge renderers. All renderer implementations should adhere to the\nDocRenderer protocol.",
+    "objects": {
+      "Path": {
+        "name": "Path",
+        "kind": "alias",
+        "path": "docforge.renderers.base.Path",
+        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+        "docstring": null
+      },
+      "Protocol": {
+        "name": "Protocol",
+        "kind": "alias",
+        "path": "docforge.renderers.base.Protocol",
+        "signature": "<bound method Alias.signature of Alias('Protocol', 'typing.Protocol')>",
+        "docstring": null
+      },
+      "Project": {
+        "name": "Project",
+        "kind": "class",
+        "path": "docforge.renderers.base.Project",
+        "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.Project')>",
+        "docstring": "Represents a documentation project, serving as a container for modules.\n\nAttributes:\n    name: Name of the project.\n    modules: Dictionary mapping module paths to Module instances.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.renderers.base.Project.name",
+            "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.project.Project.name')>",
+            "docstring": null
+          },
+          "modules": {
+            "name": "modules",
+            "kind": "attribute",
+            "path": "docforge.renderers.base.Project.modules",
+            "signature": "<bound method Alias.signature of Alias('modules', 'docforge.models.project.Project.modules')>",
+            "docstring": null
+          },
+          "add_module": {
+            "name": "add_module",
+            "kind": "function",
+            "path": "docforge.renderers.base.Project.add_module",
+            "signature": "<bound method Alias.signature of Alias('add_module', 'docforge.models.project.Project.add_module')>",
+            "docstring": "Add a module to the project.\n\nArgs:\n    module: The module to add."
+          },
+          "get_module": {
+            "name": "get_module",
+            "kind": "function",
+            "path": "docforge.renderers.base.Project.get_module",
+            "signature": "<bound method Alias.signature of Alias('get_module', 'docforge.models.project.Project.get_module')>",
+            "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path: The dotted path of the module (e.g., 'pkg.mod').\n\nReturns:\n    The requested Module."
+          },
+          "get_all_modules": {
+            "name": "get_all_modules",
+            "kind": "function",
+            "path": "docforge.renderers.base.Project.get_all_modules",
+            "signature": "<bound method Alias.signature of Alias('get_all_modules', 'docforge.models.project.Project.get_all_modules')>",
+            "docstring": "Get all modules in the project.\n\nReturns:\n    An iterable of Module objects."
+          },
+          "get_module_list": {
+            "name": "get_module_list",
+            "kind": "function",
+            "path": "docforge.renderers.base.Project.get_module_list",
+            "signature": "<bound method Alias.signature of Alias('get_module_list', 'docforge.models.project.Project.get_module_list')>",
+            "docstring": "Get the list of all module dotted paths.\n\nReturns:\n    A list of module paths."
+          }
+        }
+      },
+      "RendererConfig": {
+        "name": "RendererConfig",
+        "kind": "class",
+        "path": "docforge.renderers.base.RendererConfig",
+        "signature": "<bound method Class.signature of Class('RendererConfig', 13, 24)>",
+        "docstring": "Configuration container for documentation renderers.\n\nArgs:\n    out_dir: The directory where documentation files should be written.\n    project: The introspected project models to be rendered.",
+        "members": {
+          "out_dir": {
+            "name": "out_dir",
+            "kind": "attribute",
+            "path": "docforge.renderers.base.RendererConfig.out_dir",
+            "signature": null,
+            "docstring": null
+          },
+          "project": {
+            "name": "project",
+            "kind": "attribute",
+            "path": "docforge.renderers.base.RendererConfig.project",
+            "signature": null,
+            "docstring": null
+          }
+        }
+      },
+      "DocRenderer": {
+        "name": "DocRenderer",
+        "kind": "class",
+        "path": "docforge.renderers.base.DocRenderer",
+        "signature": "<bound method Class.signature of Class('DocRenderer', 27, 46)>",
+        "docstring": "Protocol defining the interface for documentation renderers.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.renderers.base.DocRenderer.name",
+            "signature": null,
+            "docstring": null
+          },
+          "generate_sources": {
+            "name": "generate_sources",
+            "kind": "function",
+            "path": "docforge.renderers.base.DocRenderer.generate_sources",
+            "signature": "<bound method Function.signature of Function('generate_sources', 34, 46)>",
+            "docstring": "Generate renderer-specific source files for the given project.\n\nArgs:\n    project: The project models containing modules and objects.\n    out_dir: Target directory for the generated files."
+          }
+        }
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.renderers.json

@@ -0,0 +1,557 @@
+{
+  "module": "docforge.renderers",
+  "content": {
+    "path": "docforge.renderers",
+    "docstring": "# Renderers Layer\n\nThe `docforge.renderers` package handles the transformation of the internal\ndocumentation models into physical files formatted for specific documentation\nengines.\n\n## Current Implementations\n\n- **MkDocsRenderer**: Generates Markdown files utilizing the `mkdocstrings`\n  syntax. It automatically handles package/module hierarchy and generates\n  `index.md` files for packages.\n\n## Extending\n\nTo add a new renderer, implement the `DocRenderer` protocol defined in\n`docforge.renderers.base`.",
+    "objects": {
+      "MkDocsRenderer": {
+        "name": "MkDocsRenderer",
+        "kind": "class",
+        "path": "docforge.renderers.MkDocsRenderer",
+        "signature": "<bound method Alias.signature of Alias('MkDocsRenderer', 'docforge.renderers.mkdocs_renderer.MkDocsRenderer')>",
+        "docstring": "Renderer that generates Markdown source files formatted for the MkDocs\n'mkdocstrings' plugin.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.renderers.MkDocsRenderer.name",
+            "signature": "<bound method Alias.signature of Alias('name', 'docforge.renderers.mkdocs_renderer.MkDocsRenderer.name')>",
+            "docstring": null
+          },
+          "generate_sources": {
+            "name": "generate_sources",
+            "kind": "function",
+            "path": "docforge.renderers.MkDocsRenderer.generate_sources",
+            "signature": "<bound method Alias.signature of Alias('generate_sources', 'docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_sources')>",
+            "docstring": "Produce a set of Markdown files in the output directory based on the\nprovided Project models.\n\nArgs:\n    project: The project models to render.\n    out_dir: Target directory for documentation files."
+          }
+        }
+      },
+      "MCPRenderer": {
+        "name": "MCPRenderer",
+        "kind": "class",
+        "path": "docforge.renderers.MCPRenderer",
+        "signature": "<bound method Alias.signature of Alias('MCPRenderer', 'docforge.renderers.mcp_renderer.MCPRenderer')>",
+        "docstring": "Renderer that emits MCP-native JSON resources from docforge models.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.renderers.MCPRenderer.name",
+            "signature": "<bound method Alias.signature of Alias('name', 'docforge.renderers.mcp_renderer.MCPRenderer.name')>",
+            "docstring": null
+          },
+          "generate_sources": {
+            "name": "generate_sources",
+            "kind": "function",
+            "path": "docforge.renderers.MCPRenderer.generate_sources",
+            "signature": "<bound method Alias.signature of Alias('generate_sources', 'docforge.renderers.mcp_renderer.MCPRenderer.generate_sources')>",
+            "docstring": "Generate MCP-compatible JSON resources and navigation for the project."
+          }
+        }
+      },
+      "base": {
+        "name": "base",
+        "kind": "module",
+        "path": "docforge.renderers.base",
+        "signature": null,
+        "docstring": "This module defines the base interfaces and configuration containers for\ndoc-forge renderers. All renderer implementations should adhere to the\nDocRenderer protocol.",
+        "members": {
+          "Path": {
+            "name": "Path",
+            "kind": "alias",
+            "path": "docforge.renderers.base.Path",
+            "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+            "docstring": null
+          },
+          "Protocol": {
+            "name": "Protocol",
+            "kind": "alias",
+            "path": "docforge.renderers.base.Protocol",
+            "signature": "<bound method Alias.signature of Alias('Protocol', 'typing.Protocol')>",
+            "docstring": null
+          },
+          "Project": {
+            "name": "Project",
+            "kind": "class",
+            "path": "docforge.renderers.base.Project",
+            "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.Project')>",
+            "docstring": "Represents a documentation project, serving as a container for modules.\n\nAttributes:\n    name: Name of the project.\n    modules: Dictionary mapping module paths to Module instances.",
+            "members": {
+              "name": {
+                "name": "name",
+                "kind": "attribute",
+                "path": "docforge.renderers.base.Project.name",
+                "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.project.Project.name')>",
+                "docstring": null
+              },
+              "modules": {
+                "name": "modules",
+                "kind": "attribute",
+                "path": "docforge.renderers.base.Project.modules",
+                "signature": "<bound method Alias.signature of Alias('modules', 'docforge.models.project.Project.modules')>",
+                "docstring": null
+              },
+              "add_module": {
+                "name": "add_module",
+                "kind": "function",
+                "path": "docforge.renderers.base.Project.add_module",
+                "signature": "<bound method Alias.signature of Alias('add_module', 'docforge.models.project.Project.add_module')>",
+                "docstring": "Add a module to the project.\n\nArgs:\n    module: The module to add."
+              },
+              "get_module": {
+                "name": "get_module",
+                "kind": "function",
+                "path": "docforge.renderers.base.Project.get_module",
+                "signature": "<bound method Alias.signature of Alias('get_module', 'docforge.models.project.Project.get_module')>",
+                "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path: The dotted path of the module (e.g., 'pkg.mod').\n\nReturns:\n    The requested Module."
+              },
+              "get_all_modules": {
+                "name": "get_all_modules",
+                "kind": "function",
+                "path": "docforge.renderers.base.Project.get_all_modules",
+                "signature": "<bound method Alias.signature of Alias('get_all_modules', 'docforge.models.project.Project.get_all_modules')>",
+                "docstring": "Get all modules in the project.\n\nReturns:\n    An iterable of Module objects."
+              },
+              "get_module_list": {
+                "name": "get_module_list",
+                "kind": "function",
+                "path": "docforge.renderers.base.Project.get_module_list",
+                "signature": "<bound method Alias.signature of Alias('get_module_list', 'docforge.models.project.Project.get_module_list')>",
+                "docstring": "Get the list of all module dotted paths.\n\nReturns:\n    A list of module paths."
+              }
+            }
+          },
+          "RendererConfig": {
+            "name": "RendererConfig",
+            "kind": "class",
+            "path": "docforge.renderers.base.RendererConfig",
+            "signature": "<bound method Class.signature of Class('RendererConfig', 13, 24)>",
+            "docstring": "Configuration container for documentation renderers.\n\nArgs:\n    out_dir: The directory where documentation files should be written.\n    project: The introspected project models to be rendered.",
+            "members": {
+              "out_dir": {
+                "name": "out_dir",
+                "kind": "attribute",
+                "path": "docforge.renderers.base.RendererConfig.out_dir",
+                "signature": null,
+                "docstring": null
+              },
+              "project": {
+                "name": "project",
+                "kind": "attribute",
+                "path": "docforge.renderers.base.RendererConfig.project",
+                "signature": null,
+                "docstring": null
+              }
+            }
+          },
+          "DocRenderer": {
+            "name": "DocRenderer",
+            "kind": "class",
+            "path": "docforge.renderers.base.DocRenderer",
+            "signature": "<bound method Class.signature of Class('DocRenderer', 27, 46)>",
+            "docstring": "Protocol defining the interface for documentation renderers.",
+            "members": {
+              "name": {
+                "name": "name",
+                "kind": "attribute",
+                "path": "docforge.renderers.base.DocRenderer.name",
+                "signature": null,
+                "docstring": null
+              },
+              "generate_sources": {
+                "name": "generate_sources",
+                "kind": "function",
+                "path": "docforge.renderers.base.DocRenderer.generate_sources",
+                "signature": "<bound method Function.signature of Function('generate_sources', 34, 46)>",
+                "docstring": "Generate renderer-specific source files for the given project.\n\nArgs:\n    project: The project models containing modules and objects.\n    out_dir: Target directory for the generated files."
+              }
+            }
+          }
+        }
+      },
+      "mcp_renderer": {
+        "name": "mcp_renderer",
+        "kind": "module",
+        "path": "docforge.renderers.mcp_renderer",
+        "signature": null,
+        "docstring": null,
+        "members": {
+          "json": {
+            "name": "json",
+            "kind": "alias",
+            "path": "docforge.renderers.mcp_renderer.json",
+            "signature": "<bound method Alias.signature of Alias('json', 'json')>",
+            "docstring": null
+          },
+          "Path": {
+            "name": "Path",
+            "kind": "alias",
+            "path": "docforge.renderers.mcp_renderer.Path",
+            "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+            "docstring": null
+          },
+          "Dict": {
+            "name": "Dict",
+            "kind": "alias",
+            "path": "docforge.renderers.mcp_renderer.Dict",
+            "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+            "docstring": null
+          },
+          "List": {
+            "name": "List",
+            "kind": "alias",
+            "path": "docforge.renderers.mcp_renderer.List",
+            "signature": "<bound method Alias.signature of Alias('List', 'typing.List')>",
+            "docstring": null
+          },
+          "Project": {
+            "name": "Project",
+            "kind": "class",
+            "path": "docforge.renderers.mcp_renderer.Project",
+            "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.Project')>",
+            "docstring": "Represents a documentation project, serving as a container for modules.\n\nAttributes:\n    name: Name of the project.\n    modules: Dictionary mapping module paths to Module instances.",
+            "members": {
+              "name": {
+                "name": "name",
+                "kind": "attribute",
+                "path": "docforge.renderers.mcp_renderer.Project.name",
+                "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.project.Project.name')>",
+                "docstring": null
+              },
+              "modules": {
+                "name": "modules",
+                "kind": "attribute",
+                "path": "docforge.renderers.mcp_renderer.Project.modules",
+                "signature": "<bound method Alias.signature of Alias('modules', 'docforge.models.project.Project.modules')>",
+                "docstring": null
+              },
+              "add_module": {
+                "name": "add_module",
+                "kind": "function",
+                "path": "docforge.renderers.mcp_renderer.Project.add_module",
+                "signature": "<bound method Alias.signature of Alias('add_module', 'docforge.models.project.Project.add_module')>",
+                "docstring": "Add a module to the project.\n\nArgs:\n    module: The module to add."
+              },
+              "get_module": {
+                "name": "get_module",
+                "kind": "function",
+                "path": "docforge.renderers.mcp_renderer.Project.get_module",
+                "signature": "<bound method Alias.signature of Alias('get_module', 'docforge.models.project.Project.get_module')>",
+                "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path: The dotted path of the module (e.g., 'pkg.mod').\n\nReturns:\n    The requested Module."
+              },
+              "get_all_modules": {
+                "name": "get_all_modules",
+                "kind": "function",
+                "path": "docforge.renderers.mcp_renderer.Project.get_all_modules",
+                "signature": "<bound method Alias.signature of Alias('get_all_modules', 'docforge.models.project.Project.get_all_modules')>",
+                "docstring": "Get all modules in the project.\n\nReturns:\n    An iterable of Module objects."
+              },
+              "get_module_list": {
+                "name": "get_module_list",
+                "kind": "function",
+                "path": "docforge.renderers.mcp_renderer.Project.get_module_list",
+                "signature": "<bound method Alias.signature of Alias('get_module_list', 'docforge.models.project.Project.get_module_list')>",
+                "docstring": "Get the list of all module dotted paths.\n\nReturns:\n    A list of module paths."
+              }
+            }
+          },
+          "Module": {
+            "name": "Module",
+            "kind": "class",
+            "path": "docforge.renderers.mcp_renderer.Module",
+            "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.Module')>",
+            "docstring": "Represents a documented Python module or package.\n\nAttributes:\n    path: Dotted import path of the module.\n    docstring: Module-level docstring content.\n    members: Dictionary mapping object names to their DocObject representations.",
+            "members": {
+              "path": {
+                "name": "path",
+                "kind": "attribute",
+                "path": "docforge.renderers.mcp_renderer.Module.path",
+                "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.module.Module.path')>",
+                "docstring": null
+              },
+              "docstring": {
+                "name": "docstring",
+                "kind": "attribute",
+                "path": "docforge.renderers.mcp_renderer.Module.docstring",
+                "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.module.Module.docstring')>",
+                "docstring": null
+              },
+              "members": {
+                "name": "members",
+                "kind": "attribute",
+                "path": "docforge.renderers.mcp_renderer.Module.members",
+                "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.module.Module.members')>",
+                "docstring": null
+              },
+              "add_object": {
+                "name": "add_object",
+                "kind": "function",
+                "path": "docforge.renderers.mcp_renderer.Module.add_object",
+                "signature": "<bound method Alias.signature of Alias('add_object', 'docforge.models.module.Module.add_object')>",
+                "docstring": "Add a documented object to the module.\n\nArgs:\n    obj: The object to add."
+              },
+              "get_object": {
+                "name": "get_object",
+                "kind": "function",
+                "path": "docforge.renderers.mcp_renderer.Module.get_object",
+                "signature": "<bound method Alias.signature of Alias('get_object', 'docforge.models.module.Module.get_object')>",
+                "docstring": "Retrieve a member object by name.\n\nArgs:\n    name: The name of the object.\n\nReturns:\n    The requested DocObject."
+              },
+              "get_all_objects": {
+                "name": "get_all_objects",
+                "kind": "function",
+                "path": "docforge.renderers.mcp_renderer.Module.get_all_objects",
+                "signature": "<bound method Alias.signature of Alias('get_all_objects', 'docforge.models.module.Module.get_all_objects')>",
+                "docstring": "Get all top-level objects in the module.\n\nReturns:\n    An iterable of DocObject instances."
+              }
+            }
+          },
+          "DocObject": {
+            "name": "DocObject",
+            "kind": "class",
+            "path": "docforge.renderers.mcp_renderer.DocObject",
+            "signature": "<bound method Alias.signature of Alias('DocObject', 'docforge.models.DocObject')>",
+            "docstring": "Represents a documented Python object (class, function, method, etc.).\n\nAttributes:\n    name: Local name of the object.\n    kind: Type of object (e.g., 'class', 'function', 'attribute').\n    path: Full dotted import path to the object.\n    signature: Callable signature, if applicable.\n    docstring: Raw docstring content extracted from the source.\n    members: Dictionary mapping member names to their DocObject representations.",
+            "members": {
+              "name": {
+                "name": "name",
+                "kind": "attribute",
+                "path": "docforge.renderers.mcp_renderer.DocObject.name",
+                "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.object.DocObject.name')>",
+                "docstring": null
+              },
+              "kind": {
+                "name": "kind",
+                "kind": "attribute",
+                "path": "docforge.renderers.mcp_renderer.DocObject.kind",
+                "signature": "<bound method Alias.signature of Alias('kind', 'docforge.models.object.DocObject.kind')>",
+                "docstring": null
+              },
+              "path": {
+                "name": "path",
+                "kind": "attribute",
+                "path": "docforge.renderers.mcp_renderer.DocObject.path",
+                "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.object.DocObject.path')>",
+                "docstring": null
+              },
+              "signature": {
+                "name": "signature",
+                "kind": "attribute",
+                "path": "docforge.renderers.mcp_renderer.DocObject.signature",
+                "signature": "<bound method Alias.signature of Alias('signature', 'docforge.models.object.DocObject.signature')>",
+                "docstring": null
+              },
+              "docstring": {
+                "name": "docstring",
+                "kind": "attribute",
+                "path": "docforge.renderers.mcp_renderer.DocObject.docstring",
+                "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.object.DocObject.docstring')>",
+                "docstring": null
+              },
+              "members": {
+                "name": "members",
+                "kind": "attribute",
+                "path": "docforge.renderers.mcp_renderer.DocObject.members",
+                "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.object.DocObject.members')>",
+                "docstring": null
+              },
+              "add_member": {
+                "name": "add_member",
+                "kind": "function",
+                "path": "docforge.renderers.mcp_renderer.DocObject.add_member",
+                "signature": "<bound method Alias.signature of Alias('add_member', 'docforge.models.object.DocObject.add_member')>",
+                "docstring": "Add a child member to this object (e.g., a method to a class).\n\nArgs:\n    obj: The child DocObject to add."
+              },
+              "get_member": {
+                "name": "get_member",
+                "kind": "function",
+                "path": "docforge.renderers.mcp_renderer.DocObject.get_member",
+                "signature": "<bound method Alias.signature of Alias('get_member', 'docforge.models.object.DocObject.get_member')>",
+                "docstring": "Retrieve a child member by name.\n\nArgs:\n    name: The name of the member.\n\nReturns:\n    The requested DocObject."
+              },
+              "get_all_members": {
+                "name": "get_all_members",
+                "kind": "function",
+                "path": "docforge.renderers.mcp_renderer.DocObject.get_all_members",
+                "signature": "<bound method Alias.signature of Alias('get_all_members', 'docforge.models.object.DocObject.get_all_members')>",
+                "docstring": "Get all members of this object.\n\nReturns:\n    An iterable of child DocObject instances."
+              }
+            }
+          },
+          "MCPRenderer": {
+            "name": "MCPRenderer",
+            "kind": "class",
+            "path": "docforge.renderers.mcp_renderer.MCPRenderer",
+            "signature": "<bound method Class.signature of Class('MCPRenderer', 8, 102)>",
+            "docstring": "Renderer that emits MCP-native JSON resources from docforge models.",
+            "members": {
+              "name": {
+                "name": "name",
+                "kind": "attribute",
+                "path": "docforge.renderers.mcp_renderer.MCPRenderer.name",
+                "signature": null,
+                "docstring": null
+              },
+              "generate_sources": {
+                "name": "generate_sources",
+                "kind": "function",
+                "path": "docforge.renderers.mcp_renderer.MCPRenderer.generate_sources",
+                "signature": "<bound method Function.signature of Function('generate_sources', 15, 49)>",
+                "docstring": "Generate MCP-compatible JSON resources and navigation for the project."
+              }
+            }
+          }
+        }
+      },
+      "mkdocs_renderer": {
+        "name": "mkdocs_renderer",
+        "kind": "module",
+        "path": "docforge.renderers.mkdocs_renderer",
+        "signature": null,
+        "docstring": "This module implements the MkDocsRenderer, which generates Markdown source files\ncompatible with the MkDocs 'material' theme and 'mkdocstrings' extension.",
+        "members": {
+          "Path": {
+            "name": "Path",
+            "kind": "alias",
+            "path": "docforge.renderers.mkdocs_renderer.Path",
+            "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+            "docstring": null
+          },
+          "Project": {
+            "name": "Project",
+            "kind": "class",
+            "path": "docforge.renderers.mkdocs_renderer.Project",
+            "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.Project')>",
+            "docstring": "Represents a documentation project, serving as a container for modules.\n\nAttributes:\n    name: Name of the project.\n    modules: Dictionary mapping module paths to Module instances.",
+            "members": {
+              "name": {
+                "name": "name",
+                "kind": "attribute",
+                "path": "docforge.renderers.mkdocs_renderer.Project.name",
+                "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.project.Project.name')>",
+                "docstring": null
+              },
+              "modules": {
+                "name": "modules",
+                "kind": "attribute",
+                "path": "docforge.renderers.mkdocs_renderer.Project.modules",
+                "signature": "<bound method Alias.signature of Alias('modules', 'docforge.models.project.Project.modules')>",
+                "docstring": null
+              },
+              "add_module": {
+                "name": "add_module",
+                "kind": "function",
+                "path": "docforge.renderers.mkdocs_renderer.Project.add_module",
+                "signature": "<bound method Alias.signature of Alias('add_module', 'docforge.models.project.Project.add_module')>",
+                "docstring": "Add a module to the project.\n\nArgs:\n    module: The module to add."
+              },
+              "get_module": {
+                "name": "get_module",
+                "kind": "function",
+                "path": "docforge.renderers.mkdocs_renderer.Project.get_module",
+                "signature": "<bound method Alias.signature of Alias('get_module', 'docforge.models.project.Project.get_module')>",
+                "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path: The dotted path of the module (e.g., 'pkg.mod').\n\nReturns:\n    The requested Module."
+              },
+              "get_all_modules": {
+                "name": "get_all_modules",
+                "kind": "function",
+                "path": "docforge.renderers.mkdocs_renderer.Project.get_all_modules",
+                "signature": "<bound method Alias.signature of Alias('get_all_modules', 'docforge.models.project.Project.get_all_modules')>",
+                "docstring": "Get all modules in the project.\n\nReturns:\n    An iterable of Module objects."
+              },
+              "get_module_list": {
+                "name": "get_module_list",
+                "kind": "function",
+                "path": "docforge.renderers.mkdocs_renderer.Project.get_module_list",
+                "signature": "<bound method Alias.signature of Alias('get_module_list', 'docforge.models.project.Project.get_module_list')>",
+                "docstring": "Get the list of all module dotted paths.\n\nReturns:\n    A list of module paths."
+              }
+            }
+          },
+          "MkDocsRenderer": {
+            "name": "MkDocsRenderer",
+            "kind": "class",
+            "path": "docforge.renderers.mkdocs_renderer.MkDocsRenderer",
+            "signature": "<bound method Class.signature of Class('MkDocsRenderer', 11, 91)>",
+            "docstring": "Renderer that generates Markdown source files formatted for the MkDocs\n'mkdocstrings' plugin.",
+            "members": {
+              "name": {
+                "name": "name",
+                "kind": "attribute",
+                "path": "docforge.renderers.mkdocs_renderer.MkDocsRenderer.name",
+                "signature": null,
+                "docstring": null
+              },
+              "generate_sources": {
+                "name": "generate_sources",
+                "kind": "function",
+                "path": "docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_sources",
+                "signature": "<bound method Function.signature of Function('generate_sources', 19, 38)>",
+                "docstring": "Produce a set of Markdown files in the output directory based on the\nprovided Project models.\n\nArgs:\n    project: The project models to render.\n    out_dir: Target directory for documentation files."
+              }
+            }
+          },
+          "Set": {
+            "name": "Set",
+            "kind": "alias",
+            "path": "docforge.renderers.mkdocs_renderer.Set",
+            "signature": "<bound method Alias.signature of Alias('Set', 'typing.Set')>",
+            "docstring": null
+          },
+          "Module": {
+            "name": "Module",
+            "kind": "class",
+            "path": "docforge.renderers.mkdocs_renderer.Module",
+            "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.Module')>",
+            "docstring": "Represents a documented Python module or package.\n\nAttributes:\n    path: Dotted import path of the module.\n    docstring: Module-level docstring content.\n    members: Dictionary mapping object names to their DocObject representations.",
+            "members": {
+              "path": {
+                "name": "path",
+                "kind": "attribute",
+                "path": "docforge.renderers.mkdocs_renderer.Module.path",
+                "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.module.Module.path')>",
+                "docstring": null
+              },
+              "docstring": {
+                "name": "docstring",
+                "kind": "attribute",
+                "path": "docforge.renderers.mkdocs_renderer.Module.docstring",
+                "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.module.Module.docstring')>",
+                "docstring": null
+              },
+              "members": {
+                "name": "members",
+                "kind": "attribute",
+                "path": "docforge.renderers.mkdocs_renderer.Module.members",
+                "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.module.Module.members')>",
+                "docstring": null
+              },
+              "add_object": {
+                "name": "add_object",
+                "kind": "function",
+                "path": "docforge.renderers.mkdocs_renderer.Module.add_object",
+                "signature": "<bound method Alias.signature of Alias('add_object', 'docforge.models.module.Module.add_object')>",
+                "docstring": "Add a documented object to the module.\n\nArgs:\n    obj: The object to add."
+              },
+              "get_object": {
+                "name": "get_object",
+                "kind": "function",
+                "path": "docforge.renderers.mkdocs_renderer.Module.get_object",
+                "signature": "<bound method Alias.signature of Alias('get_object', 'docforge.models.module.Module.get_object')>",
+                "docstring": "Retrieve a member object by name.\n\nArgs:\n    name: The name of the object.\n\nReturns:\n    The requested DocObject."
+              },
+              "get_all_objects": {
+                "name": "get_all_objects",
+                "kind": "function",
+                "path": "docforge.renderers.mkdocs_renderer.Module.get_all_objects",
+                "signature": "<bound method Alias.signature of Alias('get_all_objects', 'docforge.models.module.Module.get_all_objects')>",
+                "docstring": "Get all top-level objects in the module.\n\nReturns:\n    An iterable of DocObject instances."
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.renderers.mcp_renderer.json

@@ -0,0 +1,234 @@
+{
+  "module": "docforge.renderers.mcp_renderer",
+  "content": {
+    "path": "docforge.renderers.mcp_renderer",
+    "docstring": null,
+    "objects": {
+      "json": {
+        "name": "json",
+        "kind": "alias",
+        "path": "docforge.renderers.mcp_renderer.json",
+        "signature": "<bound method Alias.signature of Alias('json', 'json')>",
+        "docstring": null
+      },
+      "Path": {
+        "name": "Path",
+        "kind": "alias",
+        "path": "docforge.renderers.mcp_renderer.Path",
+        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+        "docstring": null
+      },
+      "Dict": {
+        "name": "Dict",
+        "kind": "alias",
+        "path": "docforge.renderers.mcp_renderer.Dict",
+        "signature": "<bound method Alias.signature of Alias('Dict', 'typing.Dict')>",
+        "docstring": null
+      },
+      "List": {
+        "name": "List",
+        "kind": "alias",
+        "path": "docforge.renderers.mcp_renderer.List",
+        "signature": "<bound method Alias.signature of Alias('List', 'typing.List')>",
+        "docstring": null
+      },
+      "Project": {
+        "name": "Project",
+        "kind": "class",
+        "path": "docforge.renderers.mcp_renderer.Project",
+        "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.Project')>",
+        "docstring": "Represents a documentation project, serving as a container for modules.\n\nAttributes:\n    name: Name of the project.\n    modules: Dictionary mapping module paths to Module instances.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.renderers.mcp_renderer.Project.name",
+            "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.project.Project.name')>",
+            "docstring": null
+          },
+          "modules": {
+            "name": "modules",
+            "kind": "attribute",
+            "path": "docforge.renderers.mcp_renderer.Project.modules",
+            "signature": "<bound method Alias.signature of Alias('modules', 'docforge.models.project.Project.modules')>",
+            "docstring": null
+          },
+          "add_module": {
+            "name": "add_module",
+            "kind": "function",
+            "path": "docforge.renderers.mcp_renderer.Project.add_module",
+            "signature": "<bound method Alias.signature of Alias('add_module', 'docforge.models.project.Project.add_module')>",
+            "docstring": "Add a module to the project.\n\nArgs:\n    module: The module to add."
+          },
+          "get_module": {
+            "name": "get_module",
+            "kind": "function",
+            "path": "docforge.renderers.mcp_renderer.Project.get_module",
+            "signature": "<bound method Alias.signature of Alias('get_module', 'docforge.models.project.Project.get_module')>",
+            "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path: The dotted path of the module (e.g., 'pkg.mod').\n\nReturns:\n    The requested Module."
+          },
+          "get_all_modules": {
+            "name": "get_all_modules",
+            "kind": "function",
+            "path": "docforge.renderers.mcp_renderer.Project.get_all_modules",
+            "signature": "<bound method Alias.signature of Alias('get_all_modules', 'docforge.models.project.Project.get_all_modules')>",
+            "docstring": "Get all modules in the project.\n\nReturns:\n    An iterable of Module objects."
+          },
+          "get_module_list": {
+            "name": "get_module_list",
+            "kind": "function",
+            "path": "docforge.renderers.mcp_renderer.Project.get_module_list",
+            "signature": "<bound method Alias.signature of Alias('get_module_list', 'docforge.models.project.Project.get_module_list')>",
+            "docstring": "Get the list of all module dotted paths.\n\nReturns:\n    A list of module paths."
+          }
+        }
+      },
+      "Module": {
+        "name": "Module",
+        "kind": "class",
+        "path": "docforge.renderers.mcp_renderer.Module",
+        "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.Module')>",
+        "docstring": "Represents a documented Python module or package.\n\nAttributes:\n    path: Dotted import path of the module.\n    docstring: Module-level docstring content.\n    members: Dictionary mapping object names to their DocObject representations.",
+        "members": {
+          "path": {
+            "name": "path",
+            "kind": "attribute",
+            "path": "docforge.renderers.mcp_renderer.Module.path",
+            "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.module.Module.path')>",
+            "docstring": null
+          },
+          "docstring": {
+            "name": "docstring",
+            "kind": "attribute",
+            "path": "docforge.renderers.mcp_renderer.Module.docstring",
+            "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.module.Module.docstring')>",
+            "docstring": null
+          },
+          "members": {
+            "name": "members",
+            "kind": "attribute",
+            "path": "docforge.renderers.mcp_renderer.Module.members",
+            "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.module.Module.members')>",
+            "docstring": null
+          },
+          "add_object": {
+            "name": "add_object",
+            "kind": "function",
+            "path": "docforge.renderers.mcp_renderer.Module.add_object",
+            "signature": "<bound method Alias.signature of Alias('add_object', 'docforge.models.module.Module.add_object')>",
+            "docstring": "Add a documented object to the module.\n\nArgs:\n    obj: The object to add."
+          },
+          "get_object": {
+            "name": "get_object",
+            "kind": "function",
+            "path": "docforge.renderers.mcp_renderer.Module.get_object",
+            "signature": "<bound method Alias.signature of Alias('get_object', 'docforge.models.module.Module.get_object')>",
+            "docstring": "Retrieve a member object by name.\n\nArgs:\n    name: The name of the object.\n\nReturns:\n    The requested DocObject."
+          },
+          "get_all_objects": {
+            "name": "get_all_objects",
+            "kind": "function",
+            "path": "docforge.renderers.mcp_renderer.Module.get_all_objects",
+            "signature": "<bound method Alias.signature of Alias('get_all_objects', 'docforge.models.module.Module.get_all_objects')>",
+            "docstring": "Get all top-level objects in the module.\n\nReturns:\n    An iterable of DocObject instances."
+          }
+        }
+      },
+      "DocObject": {
+        "name": "DocObject",
+        "kind": "class",
+        "path": "docforge.renderers.mcp_renderer.DocObject",
+        "signature": "<bound method Alias.signature of Alias('DocObject', 'docforge.models.DocObject')>",
+        "docstring": "Represents a documented Python object (class, function, method, etc.).\n\nAttributes:\n    name: Local name of the object.\n    kind: Type of object (e.g., 'class', 'function', 'attribute').\n    path: Full dotted import path to the object.\n    signature: Callable signature, if applicable.\n    docstring: Raw docstring content extracted from the source.\n    members: Dictionary mapping member names to their DocObject representations.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.renderers.mcp_renderer.DocObject.name",
+            "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.object.DocObject.name')>",
+            "docstring": null
+          },
+          "kind": {
+            "name": "kind",
+            "kind": "attribute",
+            "path": "docforge.renderers.mcp_renderer.DocObject.kind",
+            "signature": "<bound method Alias.signature of Alias('kind', 'docforge.models.object.DocObject.kind')>",
+            "docstring": null
+          },
+          "path": {
+            "name": "path",
+            "kind": "attribute",
+            "path": "docforge.renderers.mcp_renderer.DocObject.path",
+            "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.object.DocObject.path')>",
+            "docstring": null
+          },
+          "signature": {
+            "name": "signature",
+            "kind": "attribute",
+            "path": "docforge.renderers.mcp_renderer.DocObject.signature",
+            "signature": "<bound method Alias.signature of Alias('signature', 'docforge.models.object.DocObject.signature')>",
+            "docstring": null
+          },
+          "docstring": {
+            "name": "docstring",
+            "kind": "attribute",
+            "path": "docforge.renderers.mcp_renderer.DocObject.docstring",
+            "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.object.DocObject.docstring')>",
+            "docstring": null
+          },
+          "members": {
+            "name": "members",
+            "kind": "attribute",
+            "path": "docforge.renderers.mcp_renderer.DocObject.members",
+            "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.object.DocObject.members')>",
+            "docstring": null
+          },
+          "add_member": {
+            "name": "add_member",
+            "kind": "function",
+            "path": "docforge.renderers.mcp_renderer.DocObject.add_member",
+            "signature": "<bound method Alias.signature of Alias('add_member', 'docforge.models.object.DocObject.add_member')>",
+            "docstring": "Add a child member to this object (e.g., a method to a class).\n\nArgs:\n    obj: The child DocObject to add."
+          },
+          "get_member": {
+            "name": "get_member",
+            "kind": "function",
+            "path": "docforge.renderers.mcp_renderer.DocObject.get_member",
+            "signature": "<bound method Alias.signature of Alias('get_member', 'docforge.models.object.DocObject.get_member')>",
+            "docstring": "Retrieve a child member by name.\n\nArgs:\n    name: The name of the member.\n\nReturns:\n    The requested DocObject."
+          },
+          "get_all_members": {
+            "name": "get_all_members",
+            "kind": "function",
+            "path": "docforge.renderers.mcp_renderer.DocObject.get_all_members",
+            "signature": "<bound method Alias.signature of Alias('get_all_members', 'docforge.models.object.DocObject.get_all_members')>",
+            "docstring": "Get all members of this object.\n\nReturns:\n    An iterable of child DocObject instances."
+          }
+        }
+      },
+      "MCPRenderer": {
+        "name": "MCPRenderer",
+        "kind": "class",
+        "path": "docforge.renderers.mcp_renderer.MCPRenderer",
+        "signature": "<bound method Class.signature of Class('MCPRenderer', 8, 102)>",
+        "docstring": "Renderer that emits MCP-native JSON resources from docforge models.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.renderers.mcp_renderer.MCPRenderer.name",
+            "signature": null,
+            "docstring": null
+          },
+          "generate_sources": {
+            "name": "generate_sources",
+            "kind": "function",
+            "path": "docforge.renderers.mcp_renderer.MCPRenderer.generate_sources",
+            "signature": "<bound method Function.signature of Function('generate_sources', 15, 49)>",
+            "docstring": "Generate MCP-compatible JSON resources and navigation for the project."
+          }
+        }
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.renderers.mkdocs_renderer.json

@@ -0,0 +1,148 @@
+{
+  "module": "docforge.renderers.mkdocs_renderer",
+  "content": {
+    "path": "docforge.renderers.mkdocs_renderer",
+    "docstring": "This module implements the MkDocsRenderer, which generates Markdown source files\ncompatible with the MkDocs 'material' theme and 'mkdocstrings' extension.",
+    "objects": {
+      "Path": {
+        "name": "Path",
+        "kind": "alias",
+        "path": "docforge.renderers.mkdocs_renderer.Path",
+        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+        "docstring": null
+      },
+      "Project": {
+        "name": "Project",
+        "kind": "class",
+        "path": "docforge.renderers.mkdocs_renderer.Project",
+        "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.Project')>",
+        "docstring": "Represents a documentation project, serving as a container for modules.\n\nAttributes:\n    name: Name of the project.\n    modules: Dictionary mapping module paths to Module instances.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.renderers.mkdocs_renderer.Project.name",
+            "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.project.Project.name')>",
+            "docstring": null
+          },
+          "modules": {
+            "name": "modules",
+            "kind": "attribute",
+            "path": "docforge.renderers.mkdocs_renderer.Project.modules",
+            "signature": "<bound method Alias.signature of Alias('modules', 'docforge.models.project.Project.modules')>",
+            "docstring": null
+          },
+          "add_module": {
+            "name": "add_module",
+            "kind": "function",
+            "path": "docforge.renderers.mkdocs_renderer.Project.add_module",
+            "signature": "<bound method Alias.signature of Alias('add_module', 'docforge.models.project.Project.add_module')>",
+            "docstring": "Add a module to the project.\n\nArgs:\n    module: The module to add."
+          },
+          "get_module": {
+            "name": "get_module",
+            "kind": "function",
+            "path": "docforge.renderers.mkdocs_renderer.Project.get_module",
+            "signature": "<bound method Alias.signature of Alias('get_module', 'docforge.models.project.Project.get_module')>",
+            "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path: The dotted path of the module (e.g., 'pkg.mod').\n\nReturns:\n    The requested Module."
+          },
+          "get_all_modules": {
+            "name": "get_all_modules",
+            "kind": "function",
+            "path": "docforge.renderers.mkdocs_renderer.Project.get_all_modules",
+            "signature": "<bound method Alias.signature of Alias('get_all_modules', 'docforge.models.project.Project.get_all_modules')>",
+            "docstring": "Get all modules in the project.\n\nReturns:\n    An iterable of Module objects."
+          },
+          "get_module_list": {
+            "name": "get_module_list",
+            "kind": "function",
+            "path": "docforge.renderers.mkdocs_renderer.Project.get_module_list",
+            "signature": "<bound method Alias.signature of Alias('get_module_list', 'docforge.models.project.Project.get_module_list')>",
+            "docstring": "Get the list of all module dotted paths.\n\nReturns:\n    A list of module paths."
+          }
+        }
+      },
+      "MkDocsRenderer": {
+        "name": "MkDocsRenderer",
+        "kind": "class",
+        "path": "docforge.renderers.mkdocs_renderer.MkDocsRenderer",
+        "signature": "<bound method Class.signature of Class('MkDocsRenderer', 11, 91)>",
+        "docstring": "Renderer that generates Markdown source files formatted for the MkDocs\n'mkdocstrings' plugin.",
+        "members": {
+          "name": {
+            "name": "name",
+            "kind": "attribute",
+            "path": "docforge.renderers.mkdocs_renderer.MkDocsRenderer.name",
+            "signature": null,
+            "docstring": null
+          },
+          "generate_sources": {
+            "name": "generate_sources",
+            "kind": "function",
+            "path": "docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_sources",
+            "signature": "<bound method Function.signature of Function('generate_sources', 19, 38)>",
+            "docstring": "Produce a set of Markdown files in the output directory based on the\nprovided Project models.\n\nArgs:\n    project: The project models to render.\n    out_dir: Target directory for documentation files."
+          }
+        }
+      },
+      "Set": {
+        "name": "Set",
+        "kind": "alias",
+        "path": "docforge.renderers.mkdocs_renderer.Set",
+        "signature": "<bound method Alias.signature of Alias('Set', 'typing.Set')>",
+        "docstring": null
+      },
+      "Module": {
+        "name": "Module",
+        "kind": "class",
+        "path": "docforge.renderers.mkdocs_renderer.Module",
+        "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.Module')>",
+        "docstring": "Represents a documented Python module or package.\n\nAttributes:\n    path: Dotted import path of the module.\n    docstring: Module-level docstring content.\n    members: Dictionary mapping object names to their DocObject representations.",
+        "members": {
+          "path": {
+            "name": "path",
+            "kind": "attribute",
+            "path": "docforge.renderers.mkdocs_renderer.Module.path",
+            "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.module.Module.path')>",
+            "docstring": null
+          },
+          "docstring": {
+            "name": "docstring",
+            "kind": "attribute",
+            "path": "docforge.renderers.mkdocs_renderer.Module.docstring",
+            "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.module.Module.docstring')>",
+            "docstring": null
+          },
+          "members": {
+            "name": "members",
+            "kind": "attribute",
+            "path": "docforge.renderers.mkdocs_renderer.Module.members",
+            "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.module.Module.members')>",
+            "docstring": null
+          },
+          "add_object": {
+            "name": "add_object",
+            "kind": "function",
+            "path": "docforge.renderers.mkdocs_renderer.Module.add_object",
+            "signature": "<bound method Alias.signature of Alias('add_object', 'docforge.models.module.Module.add_object')>",
+            "docstring": "Add a documented object to the module.\n\nArgs:\n    obj: The object to add."
+          },
+          "get_object": {
+            "name": "get_object",
+            "kind": "function",
+            "path": "docforge.renderers.mkdocs_renderer.Module.get_object",
+            "signature": "<bound method Alias.signature of Alias('get_object', 'docforge.models.module.Module.get_object')>",
+            "docstring": "Retrieve a member object by name.\n\nArgs:\n    name: The name of the object.\n\nReturns:\n    The requested DocObject."
+          },
+          "get_all_objects": {
+            "name": "get_all_objects",
+            "kind": "function",
+            "path": "docforge.renderers.mkdocs_renderer.Module.get_all_objects",
+            "signature": "<bound method Alias.signature of Alias('get_all_objects', 'docforge.models.module.Module.get_all_objects')>",
+            "docstring": "Get all top-level objects in the module.\n\nReturns:\n    An iterable of DocObject instances."
+          }
+        }
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.servers.json

@@ -0,0 +1,120 @@
+{
+  "module": "docforge.servers",
+  "content": {
+    "path": "docforge.servers",
+    "docstring": null,
+    "objects": {
+      "MCPServer": {
+        "name": "MCPServer",
+        "kind": "class",
+        "path": "docforge.servers.MCPServer",
+        "signature": "<bound method Alias.signature of Alias('MCPServer', 'docforge.servers.mcp_server.MCPServer')>",
+        "docstring": "MCP server for serving a pre-built MCP documentation bundle.",
+        "members": {
+          "mcp_root": {
+            "name": "mcp_root",
+            "kind": "attribute",
+            "path": "docforge.servers.MCPServer.mcp_root",
+            "signature": "<bound method Alias.signature of Alias('mcp_root', 'docforge.servers.mcp_server.MCPServer.mcp_root')>",
+            "docstring": null
+          },
+          "app": {
+            "name": "app",
+            "kind": "attribute",
+            "path": "docforge.servers.MCPServer.app",
+            "signature": "<bound method Alias.signature of Alias('app', 'docforge.servers.mcp_server.MCPServer.app')>",
+            "docstring": null
+          },
+          "run": {
+            "name": "run",
+            "kind": "function",
+            "path": "docforge.servers.MCPServer.run",
+            "signature": "<bound method Alias.signature of Alias('run', 'docforge.servers.mcp_server.MCPServer.run')>",
+            "docstring": "Start the MCP server.\n\nArgs:\n    transport: MCP transport (default: streamable-http)"
+          }
+        }
+      },
+      "mcp_server": {
+        "name": "mcp_server",
+        "kind": "module",
+        "path": "docforge.servers.mcp_server",
+        "signature": null,
+        "docstring": null,
+        "members": {
+          "annotations": {
+            "name": "annotations",
+            "kind": "alias",
+            "path": "docforge.servers.mcp_server.annotations",
+            "signature": "<bound method Alias.signature of Alias('annotations', '__future__.annotations')>",
+            "docstring": null
+          },
+          "json": {
+            "name": "json",
+            "kind": "alias",
+            "path": "docforge.servers.mcp_server.json",
+            "signature": "<bound method Alias.signature of Alias('json', 'json')>",
+            "docstring": null
+          },
+          "Path": {
+            "name": "Path",
+            "kind": "alias",
+            "path": "docforge.servers.mcp_server.Path",
+            "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+            "docstring": null
+          },
+          "Any": {
+            "name": "Any",
+            "kind": "alias",
+            "path": "docforge.servers.mcp_server.Any",
+            "signature": "<bound method Alias.signature of Alias('Any', 'typing.Any')>",
+            "docstring": null
+          },
+          "Literal": {
+            "name": "Literal",
+            "kind": "alias",
+            "path": "docforge.servers.mcp_server.Literal",
+            "signature": "<bound method Alias.signature of Alias('Literal', 'typing.Literal')>",
+            "docstring": null
+          },
+          "FastMCP": {
+            "name": "FastMCP",
+            "kind": "alias",
+            "path": "docforge.servers.mcp_server.FastMCP",
+            "signature": "<bound method Alias.signature of Alias('FastMCP', 'mcp.server.fastmcp.FastMCP')>",
+            "docstring": null
+          },
+          "MCPServer": {
+            "name": "MCPServer",
+            "kind": "class",
+            "path": "docforge.servers.mcp_server.MCPServer",
+            "signature": "<bound method Class.signature of Class('MCPServer', 10, 73)>",
+            "docstring": "MCP server for serving a pre-built MCP documentation bundle.",
+            "members": {
+              "mcp_root": {
+                "name": "mcp_root",
+                "kind": "attribute",
+                "path": "docforge.servers.mcp_server.MCPServer.mcp_root",
+                "signature": null,
+                "docstring": null
+              },
+              "app": {
+                "name": "app",
+                "kind": "attribute",
+                "path": "docforge.servers.mcp_server.MCPServer.app",
+                "signature": null,
+                "docstring": null
+              },
+              "run": {
+                "name": "run",
+                "kind": "function",
+                "path": "docforge.servers.mcp_server.MCPServer.run",
+                "signature": "<bound method Function.signature of Function('run', 66, 73)>",
+                "docstring": "Start the MCP server.\n\nArgs:\n    transport: MCP transport (default: streamable-http)"
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}

mcp_docs/modules/docforge.servers.mcp_server.json

@@ -0,0 +1,81 @@
+{
+  "module": "docforge.servers.mcp_server",
+  "content": {
+    "path": "docforge.servers.mcp_server",
+    "docstring": null,
+    "objects": {
+      "annotations": {
+        "name": "annotations",
+        "kind": "alias",
+        "path": "docforge.servers.mcp_server.annotations",
+        "signature": "<bound method Alias.signature of Alias('annotations', '__future__.annotations')>",
+        "docstring": null
+      },
+      "json": {
+        "name": "json",
+        "kind": "alias",
+        "path": "docforge.servers.mcp_server.json",
+        "signature": "<bound method Alias.signature of Alias('json', 'json')>",
+        "docstring": null
+      },
+      "Path": {
+        "name": "Path",
+        "kind": "alias",
+        "path": "docforge.servers.mcp_server.Path",
+        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
+        "docstring": null
+      },
+      "Any": {
+        "name": "Any",
+        "kind": "alias",
+        "path": "docforge.servers.mcp_server.Any",
+        "signature": "<bound method Alias.signature of Alias('Any', 'typing.Any')>",
+        "docstring": null
+      },
+      "Literal": {
+        "name": "Literal",
+        "kind": "alias",
+        "path": "docforge.servers.mcp_server.Literal",
+        "signature": "<bound method Alias.signature of Alias('Literal', 'typing.Literal')>",
+        "docstring": null
+      },
+      "FastMCP": {
+        "name": "FastMCP",
+        "kind": "alias",
+        "path": "docforge.servers.mcp_server.FastMCP",
+        "signature": "<bound method Alias.signature of Alias('FastMCP', 'mcp.server.fastmcp.FastMCP')>",
+        "docstring": null
+      },
+      "MCPServer": {
+        "name": "MCPServer",
+        "kind": "class",
+        "path": "docforge.servers.mcp_server.MCPServer",
+        "signature": "<bound method Class.signature of Class('MCPServer', 10, 73)>",
+        "docstring": "MCP server for serving a pre-built MCP documentation bundle.",
+        "members": {
+          "mcp_root": {
+            "name": "mcp_root",
+            "kind": "attribute",
+            "path": "docforge.servers.mcp_server.MCPServer.mcp_root",
+            "signature": null,
+            "docstring": null
+          },
+          "app": {
+            "name": "app",
+            "kind": "attribute",
+            "path": "docforge.servers.mcp_server.MCPServer.app",
+            "signature": null,
+            "docstring": null
+          },
+          "run": {
+            "name": "run",
+            "kind": "function",
+            "path": "docforge.servers.mcp_server.MCPServer.run",
+            "signature": "<bound method Function.signature of Function('run', 66, 73)>",
+            "docstring": "Start the MCP server.\n\nArgs:\n    transport: MCP transport (default: streamable-http)"
+          }
+        }
+      }
+    }
+  }
+}

mcp_docs/nav.json

@@ -0,0 +1,82 @@
+[
+  {
+    "module": "docforge",
+    "resource": "doc://modules/docforge"
+  },
+  {
+    "module": "docforge.cli",
+    "resource": "doc://modules/docforge.cli"
+  },
+  {
+    "module": "docforge.cli.main",
+    "resource": "doc://modules/docforge.cli.main"
+  },
+  {
+    "module": "docforge.cli.mkdocs",
+    "resource": "doc://modules/docforge.cli.mkdocs"
+  },
+  {
+    "module": "docforge.loaders",
+    "resource": "doc://modules/docforge.loaders"
+  },
+  {
+    "module": "docforge.loaders.griffe_loader",
+    "resource": "doc://modules/docforge.loaders.griffe_loader"
+  },
+  {
+    "module": "docforge.models",
+    "resource": "doc://modules/docforge.models"
+  },
+  {
+    "module": "docforge.models.module",
+    "resource": "doc://modules/docforge.models.module"
+  },
+  {
+    "module": "docforge.models.object",
+    "resource": "doc://modules/docforge.models.object"
+  },
+  {
+    "module": "docforge.models.project",
+    "resource": "doc://modules/docforge.models.project"
+  },
+  {
+    "module": "docforge.nav",
+    "resource": "doc://modules/docforge.nav"
+  },
+  {
+    "module": "docforge.nav.mkdocs",
+    "resource": "doc://modules/docforge.nav.mkdocs"
+  },
+  {
+    "module": "docforge.nav.resolver",
+    "resource": "doc://modules/docforge.nav.resolver"
+  },
+  {
+    "module": "docforge.nav.spec",
+    "resource": "doc://modules/docforge.nav.spec"
+  },
+  {
+    "module": "docforge.renderers",
+    "resource": "doc://modules/docforge.renderers"
+  },
+  {
+    "module": "docforge.renderers.base",
+    "resource": "doc://modules/docforge.renderers.base"
+  },
+  {
+    "module": "docforge.renderers.mcp_renderer",
+    "resource": "doc://modules/docforge.renderers.mcp_renderer"
+  },
+  {
+    "module": "docforge.renderers.mkdocs_renderer",
+    "resource": "doc://modules/docforge.renderers.mkdocs_renderer"
+  },
+  {
+    "module": "docforge.servers",
+    "resource": "doc://modules/docforge.servers"
+  },
+  {
+    "module": "docforge.servers.mcp_server",
+    "resource": "doc://modules/docforge.servers.mcp_server"
+  }
+]

mkdocs.yml

@@ -36,14 +36,14 @@ plugins:
 
 nav:
 - Home: docforge/index.md
-- Loader:
+- Loaders:
-  - docforge/loader/index.md
+  - docforge/loaders/index.md
-  - docforge/loader/griffe_loader.md
+  - docforge/loaders/griffe_loader.md
-- Model:
+- Models:
-  - docforge/model/index.md
+  - docforge/models/index.md
-  - docforge/model/module.md
+  - docforge/models/module.md
-  - docforge/model/object.md
+  - docforge/models/object.md
-  - docforge/model/project.md
+  - docforge/models/project.md
 - Navigation:
   - docforge/nav/index.md
   - docforge/nav/spec.md
@@ -52,7 +52,8 @@ nav:
 - Renderers:
   - docforge/renderers/index.md
   - docforge/renderers/base.md
-  - docforge/renderers/mkdocs.md
+  - docforge/renderers/mkdocs_renderer.md
+  - docforge/renderers/mcp_renderer.md
 - CLI:
   - docforge/cli/index.md
   - docforge/cli/main.md

pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "doc-forge"
-version = "0.0.1"
+version = "0.0.2"
 description = "A renderer-agnostic Python documentation compiler"
 readme = "README.md"
 requires-python = ">=3.10"

tests/cli/conftest.py

@@ -1,7 +1,7 @@
-from pathlib import Path
+import json
-from typing import Callable
-
 import pytest
+from pathlib import Path
+
 from click.testing import CliRunner
 
 
@@ -65,3 +65,47 @@ def mock_mkdocs_serve(monkeypatch):
         fake_serve,
     )
     return lambda: called["value"]
+
+@pytest.fixture
+def fake_mcp_docs(tmp_path: Path) -> Path:
+    """
+    Create a minimal valid MCP bundle in mcp_docs/.
+    """
+    mcp_root = tmp_path / "mcp_docs"
+    modules_dir = mcp_root / "modules"
+    modules_dir.mkdir(parents=True)
+
+    (mcp_root / "index.json").write_text(
+        json.dumps({"project": "test", "type": "docforge-model"}),
+        encoding="utf-8",
+    )
+
+    (mcp_root / "nav.json").write_text(
+        json.dumps([]),
+        encoding="utf-8",
+    )
+
+    (modules_dir / "test.mod.json").write_text(
+        json.dumps({"module": "test.mod", "content": {}}),
+        encoding="utf-8",
+    )
+
+    return mcp_root
+
+
+@pytest.fixture
+def mock_mcp_server_run(monkeypatch):
+    """
+    Mock MCPServer.run so no real server is started.
+    """
+    called = {"value": False}
+
+    def fake_run(self, transport="streamable-http"):
+        called["value"] = True
+
+    monkeypatch.setattr(
+        "docforge.servers.MCPServer.run",
+        fake_run,
+    )
+
+    return lambda: called["value"]

tests/cli/test_mcp_serve.py

@@ -0,0 +1,18 @@
+from docforge.cli.main import cli
+
+
+def test_serve_mcp(
+    cli_runner,
+    fake_mcp_docs,
+    mock_mcp_server_run,
+    monkeypatch,
+):
+    monkeypatch.chdir(fake_mcp_docs.parent)
+
+    result = cli_runner.invoke(
+        cli,
+        ["serve-mcp"],
+    )
+
+    assert result.exit_code == 0
+    assert mock_mcp_server_run()

tests/renderers/mcp/test_mcp_content.py

@@ -0,0 +1,21 @@
+import json
+from pathlib import Path
+
+from docforge import MCPRenderer
+from docforge.models import Project, Module
+
+
+def test_mcp_file_content(tmp_path: Path):
+    project = Project("testpkg")
+    project.add_module(Module("testpkg.mod"))
+
+    out_dir = tmp_path / "mcp"
+    renderer = MCPRenderer()
+
+    renderer.generate_sources(project, out_dir)
+
+    module_file = out_dir / "modules" / "testpkg.mod.json"
+    payload = json.loads(module_file.read_text())
+
+    assert payload["module"] == "testpkg.mod"
+    assert payload["content"]["path"] == "testpkg.mod"

tests/renderers/mcp/test_mcp_idempotency.py

@@ -0,0 +1,20 @@
+from pathlib import Path
+
+from docforge import MCPRenderer
+from docforge.models import Project, Module
+
+
+def test_mcp_idempotent(tmp_path: Path):
+    project = Project("testpkg")
+    project.add_module(Module("testpkg.mod"))
+
+    out_dir = tmp_path / "mcp"
+    renderer = MCPRenderer()
+
+    renderer.generate_sources(project, out_dir)
+    first = (out_dir / "modules" / "testpkg.mod.json").read_text()
+
+    renderer.generate_sources(project, out_dir)
+    second = (out_dir / "modules" / "testpkg.mod.json").read_text()
+
+    assert first == second

tests/renderers/mcp/test_mcp_module_coverage.py

@@ -0,0 +1,34 @@
+from pathlib import Path
+
+from docforge.loaders import GriffeLoader, discover_module_paths
+from docforge import MCPRenderer
+
+
+def test_mcp_emits_all_modules(tmp_path: Path) -> None:
+    project_root = Path(__file__).resolve().parents[3]
+    loader = GriffeLoader()
+    discovered_paths = discover_module_paths(
+        "docforge",
+        project_root=project_root,
+    )
+
+    project = loader.load_project(discovered_paths)
+
+    renderer = MCPRenderer()
+    renderer.generate_sources(project, tmp_path)
+
+    emitted = {
+        p.relative_to(tmp_path).as_posix()
+        for p in (tmp_path / "modules").rglob("*.json")
+    }
+
+    expected = {
+        f"modules/{m.path}.json"
+        for m in project.get_all_modules()
+    }
+
+    missing = expected - emitted
+    assert not missing, f"Missing MCP module JSON files: {missing}"
+
+    # also assert nav.json exists
+    assert (tmp_path / "nav.json").exists()

tests/renderers/mcp/test_mcp_structure.py

@@ -0,0 +1,23 @@
+from pathlib import Path
+
+from docforge import MCPRenderer
+from docforge.models import Project, Module
+
+
+def test_mcp_directory_structure(tmp_path: Path):
+    project = Project("testpkg")
+    project.add_module(Module("testpkg"))
+    project.add_module(Module("testpkg.sub"))
+
+    out_dir = tmp_path / "mcp"
+    renderer = MCPRenderer()
+
+    renderer.generate_sources(project, out_dir)
+
+    # Bundle-level files
+    assert (out_dir / "index.json").exists()
+    assert (out_dir / "nav.json").exists()
+
+    # Module resources
+    assert (out_dir / "modules" / "testpkg.json").exists()
+    assert (out_dir / "modules" / "testpkg.sub.json").exists()

tests/renderers/mkdocs/test_mkdocs_content.py

@@ -1,7 +1,7 @@
 from pathlib import Path
 
 from docforge import MkDocsRenderer
-from docforge.model import Project, Module
+from docforge.models import Project, Module
 
 
 def test_mkdocs_file_content(tmp_path: Path):

tests/renderers/mkdocs/test_mkdocs_idempotency.py

@@ -1,7 +1,7 @@
 from pathlib import Path
 
 from docforge import MkDocsRenderer
-from docforge.model import Project, Module
+from docforge.models import Project, Module
 
 
 def test_mkdocs_idempotent(tmp_path: Path):

tests/renderers/mkdocs/test_mkdocs_module_coverage.py

@@ -0,0 +1,41 @@
+from pathlib import Path
+
+from docforge.loaders import GriffeLoader, discover_module_paths
+from docforge import MkDocsRenderer
+
+
+def test_mkdocs_emits_all_modules(tmp_path: Path) -> None:
+    project_root = Path(__file__).resolve().parents[3]
+    loader = GriffeLoader()
+    discovered_paths = discover_module_paths(
+        "docforge",
+        project_root=project_root,
+    )
+
+    project = loader.load_project(discovered_paths)
+
+    renderer = MkDocsRenderer()
+    renderer.generate_sources(project, tmp_path)
+
+    emitted = {
+        p.relative_to(tmp_path).as_posix()
+        for p in tmp_path.rglob("*.md")
+    }
+
+    module_paths = [m.path for m in project.get_all_modules()]
+
+    expected = set()
+    for path in module_paths:
+        parts = path.split(".")
+        is_package = any(
+            other != path and other.startswith(path + ".")
+            for other in module_paths
+        )
+
+        if is_package:
+            expected.add("/".join(parts) + "/index.md")
+        else:
+            expected.add("/".join(parts) + ".md")
+
+    missing = expected - emitted
+    assert not missing, f"Missing markdown files for modules: {missing}"

tests/renderers/mkdocs/test_mkdocs_structure.py

@@ -1,7 +1,7 @@
 from pathlib import Path
 
 from docforge import MkDocsRenderer
-from docforge.model import Project, Module
+from docforge.models import Project, Module
 
 
 def test_mkdocs_directory_structure(tmp_path: Path):

tests/renderers/test_mkdocs_module_coverage.py

@@ -1,61 +0,0 @@
-from pathlib import Path
-
-from docforge.loader import GriffeLoader, discover_module_paths
-from docforge.renderers.mkdocs import MkDocsRenderer
-
-
-def test_mkdocs_emits_all_modules(tmp_path: Path) -> None:
-    loader = GriffeLoader()
-    discovered_paths = discover_module_paths(
-        "docforge",
-        Path(r"C:\Users\vishe\WorkSpace\code\aetos\doc-forge")
-    )
-    project = loader.load_project(
-        discovered_paths
-    )
-
-    renderer = MkDocsRenderer()
-    renderer.generate_sources(project, tmp_path)
-
-    emitted = {
-        p.relative_to(tmp_path).as_posix()
-        for p in tmp_path.rglob("*.md")
-    }
-
-    module_paths = [m.path for m in project.get_all_modules()]
-
-    expected = set()
-    for path in module_paths:
-        parts = path.split(".")
-        # treat package as index.md if any other module is nested under it
-        is_package = any(
-            other != path and other.startswith(path + ".")
-            for other in module_paths
-        )
-
-        if is_package:
-            expected.add("/".join(parts) + "/index.md")
-        else:
-            expected.add("/".join(parts) + ".md")
-
-    # expected = {
-    #     'docforge/cli/main.md',
-    #     'docforge/renderers/index.md',
-    #     'docforge/loader/index.md',
-    #     'docforge/model/index.md',
-    #     'docforge/nav/index.md',
-    #     'docforge/renderers/mkdocs.md',
-    #     'docforge/index.md',
-    #     'docforge/loader/griffe_loader.md',
-    #     'docforge/model/object.md',
-    #     'docforge/cli/index.md',
-    #     'docforge/nav/resolver.md',
-    #     'docforge/renderers/base.md',
-    #     'docforge/nav/mkdocs.md',
-    #     'docforge/nav/spec.md',
-    #     'docforge/model/module.md',
-    #     'docforge/cli/mkdocs.md',
-    #     'docforge/model/project.md'
-    # }
-    missing = expected - emitted
-    assert not missing, f"Missing markdown files for modules: {missing}"