fix(mkdocs): rebase cross-kind wiki links under directory URLs

Wiki pages linking to a sibling kind (for example ../lib/...) were emitted verbatim by MkDocs and, with use_directory_urls, resolved into a non-existent <kind>/<kind>/ path. Add a docforge-linkfix plugin (doc-forge 0.0.8) that rebases those links to the repository root.

.drone.yml

@@ -23,13 +23,18 @@ steps:
     commands:
       - PACKAGE_NAME=$(grep -E '^name\s*=' pyproject.toml | head -1 | cut -d'"' -f2)
       - VERSION=$(grep -E '^version\s*=' pyproject.toml | head -1 | cut -d'"' -f2)
-      - echo "🔍 Checking if $PACKAGE_NAME==$VERSION exists on $PIP_REPO_URL ..."
       - |
-        if curl -fsSL -u "$PIP_USERNAME:$PIP_PASSWORD" "$PIP_REPO_URL/simple/$PACKAGE_NAME/" | grep -q "$VERSION"; then
+        if [ "$DRONE_TAG" != "$VERSION" ]; then
-          echo "✅ $PACKAGE_NAME==$VERSION already exists — skipping build."
+          echo "Tag '$DRONE_TAG' does not match pyproject version '$VERSION'; refusing to publish."
+          exit 1
+        fi
+      - echo "Checking if $PACKAGE_NAME==$VERSION exists on $PIP_REPO_URL ..."
+      - |
+        if curl -fsSL -u "$PIP_USERNAME:$PIP_PASSWORD" "$PIP_REPO_URL/simple/$PACKAGE_NAME/" | grep -qE "${PACKAGE_NAME}-${VERSION}(-|\.tar\.gz|\.whl)"; then
+          echo "$PACKAGE_NAME==$VERSION already exists; skipping build."
           exit 78
         else
-          echo "🆕 New version detected: $PACKAGE_NAME==$VERSION"
+          echo "New version detected: $PACKAGE_NAME==$VERSION"
         fi
 
   - name: quality-gate
@@ -44,19 +49,24 @@ steps:
     commands:
       - pip install --upgrade pip build
       - |
-        AUTH_URL="https://${PIP_USERNAME}:${PIP_PASSWORD}@$(echo "${PIP_REPO_URL#*://}" | sed 's:/*$::')/simple"
+        if [ -z "$PIP_REPO_URL" ] || [ -z "$PIP_USERNAME" ] || [ -z "$PIP_PASSWORD" ]; then
-        pip install --index-url "$AUTH_URL" --extra-index-url https://pypi.org/simple/ -U ".[dev]"
+          echo "PIP_REPO_URL / PIP_USERNAME / PIP_PASSWORD are not set" >&2
-      - echo "🛡️ Running quality gate..."
+          exit 1
+        fi
+      - AUTH_URL="https://$PIP_USERNAME:$PIP_PASSWORD@$(echo "$PIP_REPO_URL" | sed -E 's|^[a-zA-Z]+://||; s|/*$||')/simple"
+      - pip install --index-url "$AUTH_URL" --extra-index-url https://pypi.org/simple/ -U ".[dev]" "pydoclint>=0.9.1"
+      - echo "Running quality gate..."
       - python -m black --check .
       - python -m ruff check .
       - python -m mypy
+      - pydoclint .
       - python -m pytest
 
   - name: build-package
     image: python:3.13-slim
     commands:
       - pip install --upgrade pip build
-      - echo "📦 Building Python package..."
+      - echo "Building Python package..."
       - python -m build
       - ls -l dist
 
@@ -71,7 +81,7 @@ steps:
         from_secret: PIP_PASSWORD
     commands:
       - pip install --upgrade twine
-      - echo "🚀 Uploading to private PyPI at $PIP_REPO_URL ..."
+      - echo "Uploading to private PyPI at $PIP_REPO_URL ..."
       - |
         twine upload \
           --repository-url "$PIP_REPO_URL" \
@@ -118,25 +128,31 @@ steps:
         set -e
 
         PACKAGE_NAME=$(grep -E '^name\s*=' pyproject.toml | cut -d'"' -f2)
-        echo "📦 Package: $PACKAGE_NAME"
+        echo "Package: $PACKAGE_NAME"
 
         for TAG in $(git tag --sort=version:refname); do
           VERSION="$TAG"
-          echo "🔁 Version: $VERSION"
+          echo "Version: $VERSION"
 
           if curl -fsSL -u "$PIP_USERNAME:$PIP_PASSWORD" \
-            "$PIP_REPO_URL/simple/$PACKAGE_NAME/" | grep -q "$VERSION"; then
+            "$PIP_REPO_URL/simple/$PACKAGE_NAME/" | grep -qE "${PACKAGE_NAME}-${VERSION}(-|\.tar\.gz|\.whl)"; then
-            echo "⏭️  Exists, skipping"
+            echo "Exists, skipping"
             continue
           fi
 
           git checkout --force "$TAG"
 
-          echo "🏗️  Building $VERSION"
+          TAG_VERSION=$(grep -E '^version\s*=' pyproject.toml | head -1 | cut -d'"' -f2)
+          if [ "$TAG" != "$TAG_VERSION" ]; then
+            echo "Tag $TAG != pyproject version $TAG_VERSION at that commit; skipping"
+            continue
+          fi
+
+          echo "Building $VERSION"
           rm -rf dist
           python -m build
 
-          echo "⬆️  Uploading $VERSION"
+          echo "Uploading $VERSION"
           twine upload \
             --repository-url "$PIP_REPO_URL" \
             -u "$PIP_USERNAME" \
@@ -146,4 +162,4 @@ steps:
 
 trigger:
   event:
-    - custom
+    - custom

CHANGELOG.md

@@ -7,23 +7,58 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.8] - 2026-10-17
+
 ### Added
-- `py.typed` marker for PEP 561 type information.
+- `docforge-linkfix` MkDocs plugin (registered via the `mkdocs.plugins`
-- `.drone.yml` CI with a quality-gate step (black, ruff, mypy, pytest).
+  entry point) that rebases cross-kind relative links — for example
-- MIT `LICENSE`.
+  `../lib/...` written in a wiki page — to the repository root so they resolve
-- `build --refresh` flag to rebaseline an existing `docs/mkdocs.{kind}.yml`
+  to `/<repo>/<kind>/` under directory URLs.
-  from the packaged templates.
 
 ### Changed
+- The wiki template (`mkdocs.wiki.yml`) now enables `docforge-linkfix`;
+  regenerating a wiki config (or passing `--refresh`) propagates the fix.
+
+### Fixed
+- Cross-kind links (`../lib/`, `../api/`, `../wiki/`) in generated wikis no
+  longer resolve into a non-existent `<kind>/<kind>/` path.
+
+## [0.0.7] - 2026-10-17
+
+### Added
+- `py.typed` marker for PEP 561 type information.
+- `build --refresh` flag to rebaseline an existing `docs/mkdocs.{kind}.yml`
+  from the packaged templates.
+- `wiki` build kind with navigation derived from the source file structure.
+- `--api` build mode rendering an OpenAPI reference under `docs/api` with
+  lib-prefixed navigation.
+- Hand-written wiki, plus doc-forge-generated API reference under `docs/lib`
+  and MCP bundle under `docs/mcp` (per-kind MkDocs configs).
+- MIT `LICENSE`.
+
+### Changed
+- Adopted the standard Type A PyPI CI pipeline: a `tag == version` guard and a
+  quality gate (black, ruff, mypy, pydoclint, pytest).
 - Standardized `pyproject.toml` (canonical packaging, lint tool config, extras).
 - Pinned the `mcp` extra to `mcp>=1.0.0,<2.0.0` to restore compatibility with
   the current MCP server API used by doc-forge.
-- Per-kind MkDocs configs (`docs/mkdocs.{lib,api,wiki}.yml`) are now generated
+- Per-kind MkDocs configs (`docs/mkdocs.{lib,api,wiki}.yml`) are generated only
-  only when absent; an existing config is used verbatim (the file wins).
+  when absent; an existing config is used verbatim (the file wins). Pass
-  Pass `--refresh` to regenerate it from the templates.
+  `--refresh` to regenerate it from the templates.
 - The wiki template now uses the mongo-ops look: horizontal `navigation.tabs`
-  header, blue grey/teal palette, Roboto font, and additional material
+  header, blue grey/teal palette, Roboto font, and additional material feature
-  feature flags. The lib and api templates are unchanged.
+  flags. The lib and api templates are unchanged.
+- Docstrings and wiki brought to the GSDFC (Google-style) standard.
+- The `dev` extra now includes the `mkdocs` and `mcp` extras so the
+  quality-gate environment can install and run the full test suite.
 
 ### Fixed
-- Stub fixes for typed API surfaces.
+- Loader-generated signatures render cleanly and unresolvable aliases are
+  dropped from generated models.
+- Stub fixes for typed API surfaces.
+- `import docforge` no longer requires the optional `mcp` dependency; the
+  MCP server imports `mcp` lazily, matching the MkDocs backend.
+
+[Unreleased]: https://git.aetoskia.com/aetos/doc-forge/compare/0.0.8...HEAD
+[0.0.8]: https://git.aetoskia.com/aetos/doc-forge/compare/0.0.7...0.0.8
+[0.0.7]: https://git.aetoskia.com/aetos/doc-forge/compare/0.0.6...0.0.7

README.md

@@ -547,6 +547,20 @@ Example:
 
 ---
 
+# Type parity (`.pyi` stubs and `py.typed`)
+
+Documented APIs ship matching type information:
+
+- Each `.py` module has a synchronized `.pyi` stub in the same package.
+- Packages expose a `py.typed` marker so type checkers (and consumers)
+  use the authored signatures instead of `Any`.
+- When signatures change, update the `.py` implementation and its `.pyi`
+  stub together.
+- Doc-forge documents the docstrings in `.py`; the `.pyi` stub is the
+  machine-consumable signature surface.
+
+---
+
 # Parsing guarantees
 
 GSDFC ensures doc-forge can deterministically extract:

docforge/__init__.py

@@ -546,6 +546,20 @@ Example:
 
 ---
 
+# Type parity (`.pyi` stubs and `py.typed`)
+
+Documented APIs ship matching type information:
+
+- Each `.py` module has a synchronized `.pyi` stub in the same package.
+- Packages expose a `py.typed` marker so type checkers (and consumers)
+  use the authored signatures instead of `Any`.
+- When signatures change, update the `.py` implementation and its `.pyi`
+  stub together.
+- Doc-forge documents the docstrings in `.py`; the `.pyi` stub is the
+  machine-consumable signature surface.
+
+---
+
 # Parsing guarantees
 
 GSDFC ensures doc-forge can deterministically extract:

docforge/loaders/griffe_loader.py

@@ -12,6 +12,8 @@ into doc-forge documentation models.
 Notes:
     - All analysis is static; analyzed modules are never executed.
     - Private members (names starting with `_`) are skipped during conversion.
+    - Imported aliases that cannot be resolved (stdlib/third-party names) are
+      skipped; aliases that resolve within the documented project are kept.
 
 ---
 """
@@ -232,6 +234,8 @@ class GriffeLoader:
         for name, member in obj.members.items():
             if name.startswith("_"):
                 continue
+            if not self._is_resolvable_alias(member):
+                continue
 
             module.add_object(self._convert_object(member))
 
@@ -268,6 +272,8 @@ class GriffeLoader:
             for name, member in obj.members.items():
                 if name.startswith("_"):
                     continue
+                if not self._is_resolvable_alias(member):
+                    continue
                 doc_obj.add_member(self._convert_object(member))
         except AliasResolutionError:
             pass
@@ -299,17 +305,53 @@ class GriffeLoader:
         """
         Safely extract the signature of a Griffe object.
 
+        Griffe exposes signatures as callables (``Object.signature``); the
+        method is invoked and stringified to produce a clean, stable signature.
+        Aliases that point outside the loaded project fail resolution and are
+        reported as `None`.
+
         Args:
             obj (Object):
                 Griffe object to inspect.
 
         Returns:
             str | None:
-                String representation of the object's signature if available, otherwise `None`.
+                Clean string representation of the object's signature if
+                available, otherwise `None`.
         """
         try:
-            if hasattr(obj, "signature") and obj.signature:
+            signature = getattr(obj, "signature", None)
-                return str(obj.signature)
+            if signature is None:
-        except AliasResolutionError:
+                return None
+            if callable(signature):
+                signature = signature()
+            if not signature:
+                return None
+            return str(signature).strip() or None
+        except Exception:
             return None
-        return None
+
+    def _is_resolvable_alias(self, obj: Object) -> bool:
+        """
+        Report whether an object is a resolvable part of the documented API.
+
+        Aliases that cannot be resolved (stdlib or third-party imports) are
+        treated as noise and excluded from the model. Non-alias objects are
+        always resolvable.
+
+        Args:
+            obj (Object):
+                Griffe object to test.
+
+        Returns:
+            bool:
+                True if the object should be kept, False if it is an
+                unresolvable alias.
+        """
+        if obj.kind.value != "alias":
+            return True
+        try:
+            _ = obj.canonical_path
+        except AliasResolutionError:
+            return False
+        return True

docforge/mkdocs_links.py

@@ -0,0 +1,72 @@
+"""
+# Summary
+
+MkDocs plugin that fixes cross-kind relative links in generated wikis.
+
+A repository served under ``/<repo>/<kind>/`` (for example a wiki at
+``/myrepo/wiki/`` and a library reference at ``/myrepo/lib/``) is built as
+two independent MkDocs sites. Authors naturally write links between them
+using source-relative paths such as ``../lib/01_build_recipe/``.
+
+MkDocs only rewrites links whose target lives inside ``docs_dir``; anything
+pointing at a sibling site is emitted verbatim. When ``use_directory_urls``
+is enabled (the default) the rendered page sits one or more directory levels
+deeper than its source, so ``../lib/`` resolves to ``/<repo>/wiki/lib/`` and
+breaks.
+
+`docforge-linkfix` rewrites such links at render time, prefixing them with
+enough ``../`` segments to climb back to the repository root so they resolve
+to ``/<repo>/<kind>/`` regardless of how deeply the page is nested.
+"""
+
+from __future__ import annotations
+
+import re
+from typing import TYPE_CHECKING
+
+from mkdocs.plugins import BasePlugin
+
+if TYPE_CHECKING:
+    from mkdocs.config.defaults import MkDocsConfig
+    from mkdocs.structure.files import Files
+    from mkdocs.structure.pages import Page
+
+__all__ = ["LinkFixPlugin"]
+
+_CROSS_KIND_LINK = re.compile(r"\]\((?:\.\./)+(lib|api|wiki)/")
+"""Matches a Markdown link whose target climbs out of the current doc kind."""
+
+
+class LinkFixPlugin(BasePlugin):  # type: ignore[no-untyped-call, type-arg]
+    """
+    Rewrite cross-kind relative links so they survive directory URLs.
+    """
+
+    def on_page_markdown(
+        self,
+        markdown: str,
+        /,
+        *,
+        page: Page,
+        config: MkDocsConfig,
+        files: Files,
+    ) -> str:
+        """
+        Prefix cross-kind links with the depth required to reach the repo root.
+
+        Args:
+            markdown (str): The raw Markdown source of the current page.
+            page (Page): The page being rendered; its destination URI is used
+                to determine how many directory levels the output sits below
+                the site root.
+            config (MkDocsConfig): The active MkDocs configuration.
+            files (Files): The collection of files in the site.
+
+        Returns:
+            str: The Markdown with cross-kind links rebased to the repo root.
+        """
+        depth = page.file.dest_uri.count("/")
+        prefix = "../" * (depth + 1)
+        return _CROSS_KIND_LINK.sub(
+            lambda match: f"]({prefix}{match.group(1)}/", markdown
+        )

docforge/servers/mcp_server.py

@@ -23,8 +23,6 @@ import json
 from pathlib import Path
 from typing import Any, Literal
 
-from mcp.server.fastmcp import FastMCP
-
 
 class MCPServer:
     """
@@ -54,6 +52,8 @@ class MCPServer:
             name (str):
                 Identifier used for the MCP server instance.
         """
+        from mcp.server.fastmcp import FastMCP
+
         self.mcp_root = mcp_root
         self.app = FastMCP(name)
 

docforge/templates/mkdocs.wiki.yml

@@ -22,4 +22,5 @@ theme:
     logo: material/database
     repo: fontawesome/brands/github
 plugins:
-  - search
+  - search
+  - docforge-linkfix

docs/lib/docforge/cli/api_utils.md

@@ -1,3 +0,0 @@
-# Api Utils
-
-::: docforge.cli.api_utils

docs/lib/docforge/cli/commands.md

@@ -1,3 +0,0 @@
-# Commands
-
-::: docforge.cli.commands

docs/lib/docforge/cli/index.md

@@ -1,8 +0,0 @@
-# Cli
-
-::: docforge.cli
-- [Api Utils](api_utils.md)
-- [Commands](commands.md)
-- [Main](main.md)
-- [Mcp Utils](mcp_utils.md)
-- [Mkdocs Utils](mkdocs_utils.md)

docs/lib/docforge/cli/main.md

@@ -1,3 +0,0 @@
-# Main
-
-::: docforge.cli.main

docs/lib/docforge/cli/mcp_utils.md

@@ -1,3 +0,0 @@
-# Mcp Utils
-
-::: docforge.cli.mcp_utils

docs/lib/docforge/cli/mkdocs_utils.md

@@ -1,3 +0,0 @@
-# Mkdocs Utils
-
-::: docforge.cli.mkdocs_utils

docs/lib/docforge/index.md

@@ -1,9 +0,0 @@
-# Docforge
-
-::: docforge
-- [Cli](cli/)
-- [Loaders](loaders/)
-- [Models](models/)
-- [Nav](nav/)
-- [Renderers](renderers/)
-- [Servers](servers/)

docs/lib/docforge/loaders/griffe_loader.md

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

docs/lib/docforge/loaders/index.md

@@ -1,4 +0,0 @@
-# Loaders
-
-::: docforge.loaders
-- [Griffe Loader](griffe_loader.md)

docs/lib/docforge/models/index.md

@@ -1,6 +0,0 @@
-# Models
-
-::: docforge.models
-- [Module](module.md)
-- [Object](object.md)
-- [Project](project.md)

docs/lib/docforge/models/module.md

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

docs/lib/docforge/models/object.md

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

docs/lib/docforge/models/project.md

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

docs/lib/docforge/nav/index.md

@@ -1,7 +0,0 @@
-# Nav
-
-::: docforge.nav
-- [Mkdocs](mkdocs.md)
-- [Resolver](resolver.md)
-- [Spec](spec.md)
-- [Wiki](wiki.md)

docs/lib/docforge/nav/mkdocs.md

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

docs/lib/docforge/nav/resolver.md

@@ -1,3 +0,0 @@
-# Resolver
-
-::: docforge.nav.resolver

docs/lib/docforge/nav/spec.md

@@ -1,3 +0,0 @@
-# Spec
-
-::: docforge.nav.spec

docs/lib/docforge/nav/wiki.md

@@ -1,3 +0,0 @@
-# Wiki
-
-::: docforge.nav.wiki

docs/lib/docforge/renderers/base.md

@@ -1,3 +0,0 @@
-# Base
-
-::: docforge.renderers.base

docs/lib/docforge/renderers/index.md

@@ -1,6 +0,0 @@
-# Renderers
-
-::: docforge.renderers
-- [Base](base.md)
-- [Mcp Renderer](mcp_renderer.md)
-- [Mkdocs Renderer](mkdocs_renderer.md)

docs/lib/docforge/renderers/mcp_renderer.md

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

docs/lib/docforge/renderers/mkdocs_renderer.md

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

docs/lib/docforge/servers/index.md

@@ -1,4 +0,0 @@
-# Servers
-
-::: docforge.servers
-- [Mcp Server](mcp_server.md)

docs/lib/docforge/servers/mcp_server.md

@@ -1,3 +0,0 @@
-# Mcp Server
-
-::: docforge.servers.mcp_server

docs/lib/index.md

@@ -1,4 +1,3 @@
 # docforge
 
 ::: docforge
-- [Docforge](docforge/)

docs/mcp/modules/docforge.cli.api_utils.json

@@ -4,34 +4,6 @@
     "path": "docforge.cli.api_utils",
     "docstring": "# Summary\n\nUtilities for building API documentation from an OpenAPI specification.",
     "objects": {
-      "json": {
-        "name": "json",
-        "kind": "alias",
-        "path": "docforge.cli.api_utils.json",
-        "signature": "<bound method Alias.signature of Alias('json', 'json')>",
-        "docstring": null
-      },
-      "dataclass": {
-        "name": "dataclass",
-        "kind": "alias",
-        "path": "docforge.cli.api_utils.dataclass",
-        "signature": "<bound method Alias.signature of Alias('dataclass', 'dataclasses.dataclass')>",
-        "docstring": null
-      },
-      "Path": {
-        "name": "Path",
-        "kind": "alias",
-        "path": "docforge.cli.api_utils.Path",
-        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
-        "docstring": null
-      },
-      "click": {
-        "name": "click",
-        "kind": "alias",
-        "path": "docforge.cli.api_utils.click",
-        "signature": "<bound method Alias.signature of Alias('click', 'click')>",
-        "docstring": null
-      },
       "SWAGGER_SPEC_FILENAME": {
         "name": "SWAGGER_SPEC_FILENAME",
         "kind": "attribute",
@@ -43,7 +15,7 @@
         "name": "OpenAPIMetadata",
         "kind": "class",
         "path": "docforge.cli.api_utils.OpenAPIMetadata",
-        "signature": "<bound method Class.signature of Class('OpenAPIMetadata', 16, 30)>",
+        "signature": "OpenAPIMetadata(site_name: str, site_description: str | None, site_author: str | None)",
         "docstring": "Metadata derived from the ``info`` block of an OpenAPI specification.\n\nAttributes:\n    site_name: Spec title, used as the MkDocs site name.\n    site_description: Spec description, used as the site description.\n    site_author: Contact name (fallback: contact email), used as the\n        site author.",
         "members": {
           "site_name": {
@@ -73,29 +45,22 @@
         "name": "load_openapi_spec",
         "kind": "function",
         "path": "docforge.cli.api_utils.load_openapi_spec",
-        "signature": "<bound method Function.signature of Function('load_openapi_spec', 33, 64)>",
+        "signature": "load_openapi_spec(spec_path: Path) -> dict[Any, Any]",
         "docstring": "Load and validate an OpenAPI specification from a JSON file.\n\nArgs:\n    spec_path (Path):\n        Path to the OpenAPI JSON specification file.\n\nReturns:\n    dict:\n        The parsed OpenAPI specification.\n\nRaises:\n    click.ClickException:\n        If the file cannot be read or the ``info`` block is invalid."
       },
       "derive_metadata": {
         "name": "derive_metadata",
         "kind": "function",
         "path": "docforge.cli.api_utils.derive_metadata",
-        "signature": "<bound method Function.signature of Function('derive_metadata', 67, 91)>",
+        "signature": "derive_metadata(spec: dict[Any, Any]) -> OpenAPIMetadata",
         "docstring": "Derive MkDocs site metadata from an OpenAPI spec ``info`` block.\n\nArgs:\n    spec (dict):\n        Parsed OpenAPI specification.\n\nReturns:\n    OpenAPIMetadata:\n        Site name, description, and author derived from the spec."
       },
       "generate_api_sources": {
         "name": "generate_api_sources",
         "kind": "function",
         "path": "docforge.cli.api_utils.generate_api_sources",
-        "signature": "<bound method Function.signature of Function('generate_api_sources', 94, 118)>",
+        "signature": "generate_api_sources(spec: dict[Any, Any], docs_dir: Path) -> None",
         "docstring": "Generate swagger-enabled Markdown sources and the spec copy.\n\nThe specification is written as ``openapi.json`` inside ``docs_dir`` and\nan ``index.md`` embedding the swagger UI is generated alongside it.\n\nArgs:\n    spec (dict):\n        Parsed OpenAPI specification.\n    docs_dir (Path):\n        Directory (for example ``docs/api``) where the swagger\n        sources are written."
-      },
-      "Any": {
-        "name": "Any",
-        "kind": "alias",
-        "path": "docforge.cli.api_utils.Any",
-        "signature": "<bound method Alias.signature of Alias('Any', 'typing.Any')>",
-        "docstring": null
       }
     }
   }

docs/mcp/modules/docforge.cli.commands.json

@@ -4,95 +4,46 @@
     "path": "docforge.cli.commands",
     "docstring": "# Summary\n\nCommand definitions for the doc-forge CLI.\n\nProvides the CLI structure using Click, including build, serve, and tree commands.\n\n---\n\nNotes:\n    - The `build` command validates requested modes before generating anything.\n    - `--mkdocs`, `--api`, and `--wiki` each emit their own MkDocs config and\n      build (`docs/mkdocs.{kind}.yml` into `site/{kind}`); `--mcp` generates a\n      machine-readable bundle independently.\n\n---",
     "objects": {
-      "os": {
-        "name": "os",
-        "kind": "alias",
-        "path": "docforge.cli.commands.os",
-        "signature": "<bound method Alias.signature of Alias('os', 'os')>",
-        "docstring": null
-      },
-      "Path": {
-        "name": "Path",
-        "kind": "alias",
-        "path": "docforge.cli.commands.Path",
-        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
-        "docstring": null
-      },
-      "click": {
-        "name": "click",
-        "kind": "alias",
-        "path": "docforge.cli.commands.click",
-        "signature": "<bound method Alias.signature of Alias('click', 'click')>",
-        "docstring": null
-      },
       "api_utils": {
         "name": "api_utils",
         "kind": "module",
         "path": "docforge.cli.commands.api_utils",
-        "signature": "<bound method Alias.signature of Alias('api_utils', 'docforge.cli.api_utils')>",
+        "signature": null,
         "docstring": "# Summary\n\nUtilities for building API documentation from an OpenAPI specification.",
         "members": {
-          "json": {
-            "name": "json",
-            "kind": "alias",
-            "path": "docforge.cli.commands.api_utils.json",
-            "signature": "<bound method Alias.signature of Alias('json', 'docforge.cli.api_utils.json')>",
-            "docstring": null
-          },
-          "dataclass": {
-            "name": "dataclass",
-            "kind": "alias",
-            "path": "docforge.cli.commands.api_utils.dataclass",
-            "signature": "<bound method Alias.signature of Alias('dataclass', 'docforge.cli.api_utils.dataclass')>",
-            "docstring": null
-          },
-          "Path": {
-            "name": "Path",
-            "kind": "alias",
-            "path": "docforge.cli.commands.api_utils.Path",
-            "signature": "<bound method Alias.signature of Alias('Path', 'docforge.cli.api_utils.Path')>",
-            "docstring": null
-          },
-          "click": {
-            "name": "click",
-            "kind": "alias",
-            "path": "docforge.cli.commands.api_utils.click",
-            "signature": "<bound method Alias.signature of Alias('click', 'docforge.cli.api_utils.click')>",
-            "docstring": null
-          },
           "SWAGGER_SPEC_FILENAME": {
             "name": "SWAGGER_SPEC_FILENAME",
             "kind": "attribute",
             "path": "docforge.cli.commands.api_utils.SWAGGER_SPEC_FILENAME",
-            "signature": "<bound method Alias.signature of Alias('SWAGGER_SPEC_FILENAME', 'docforge.cli.api_utils.SWAGGER_SPEC_FILENAME')>",
+            "signature": null,
             "docstring": null
           },
           "OpenAPIMetadata": {
             "name": "OpenAPIMetadata",
             "kind": "class",
             "path": "docforge.cli.commands.api_utils.OpenAPIMetadata",
-            "signature": "<bound method Alias.signature of Alias('OpenAPIMetadata', 'docforge.cli.api_utils.OpenAPIMetadata')>",
+            "signature": "OpenAPIMetadata(site_name: str, site_description: str | None, site_author: str | None)",
             "docstring": "Metadata derived from the ``info`` block of an OpenAPI specification.\n\nAttributes:\n    site_name: Spec title, used as the MkDocs site name.\n    site_description: Spec description, used as the site description.\n    site_author: Contact name (fallback: contact email), used as the\n        site author.",
             "members": {
               "site_name": {
                 "name": "site_name",
                 "kind": "attribute",
                 "path": "docforge.cli.commands.api_utils.OpenAPIMetadata.site_name",
-                "signature": "<bound method Alias.signature of Alias('site_name', 'docforge.cli.api_utils.OpenAPIMetadata.site_name')>",
+                "signature": null,
                 "docstring": null
               },
               "site_description": {
                 "name": "site_description",
                 "kind": "attribute",
                 "path": "docforge.cli.commands.api_utils.OpenAPIMetadata.site_description",
-                "signature": "<bound method Alias.signature of Alias('site_description', 'docforge.cli.api_utils.OpenAPIMetadata.site_description')>",
+                "signature": null,
                 "docstring": null
               },
               "site_author": {
                 "name": "site_author",
                 "kind": "attribute",
                 "path": "docforge.cli.commands.api_utils.OpenAPIMetadata.site_author",
-                "signature": "<bound method Alias.signature of Alias('site_author', 'docforge.cli.api_utils.OpenAPIMetadata.site_author')>",
+                "signature": null,
                 "docstring": null
               }
             }
@@ -101,29 +52,22 @@
             "name": "load_openapi_spec",
             "kind": "function",
             "path": "docforge.cli.commands.api_utils.load_openapi_spec",
-            "signature": "<bound method Alias.signature of Alias('load_openapi_spec', 'docforge.cli.api_utils.load_openapi_spec')>",
+            "signature": "load_openapi_spec(spec_path: Path)",
             "docstring": "Load and validate an OpenAPI specification from a JSON file.\n\nArgs:\n    spec_path (Path):\n        Path to the OpenAPI JSON specification file.\n\nReturns:\n    dict:\n        The parsed OpenAPI specification.\n\nRaises:\n    click.ClickException:\n        If the file cannot be read or the ``info`` block is invalid."
           },
           "derive_metadata": {
             "name": "derive_metadata",
             "kind": "function",
             "path": "docforge.cli.commands.api_utils.derive_metadata",
-            "signature": "<bound method Alias.signature of Alias('derive_metadata', 'docforge.cli.api_utils.derive_metadata')>",
+            "signature": "derive_metadata(spec: dict[Any, Any])",
             "docstring": "Derive MkDocs site metadata from an OpenAPI spec ``info`` block.\n\nArgs:\n    spec (dict):\n        Parsed OpenAPI specification.\n\nReturns:\n    OpenAPIMetadata:\n        Site name, description, and author derived from the spec."
           },
           "generate_api_sources": {
             "name": "generate_api_sources",
             "kind": "function",
             "path": "docforge.cli.commands.api_utils.generate_api_sources",
-            "signature": "<bound method Alias.signature of Alias('generate_api_sources', 'docforge.cli.api_utils.generate_api_sources')>",
+            "signature": "generate_api_sources(spec: dict[Any, Any], docs_dir: Path)",
             "docstring": "Generate swagger-enabled Markdown sources and the spec copy.\n\nThe specification is written as ``openapi.json`` inside ``docs_dir`` and\nan ``index.md`` embedding the swagger UI is generated alongside it.\n\nArgs:\n    spec (dict):\n        Parsed OpenAPI specification.\n    docs_dir (Path):\n        Directory (for example ``docs/api``) where the swagger\n        sources are written."
-          },
-          "Any": {
-            "name": "Any",
-            "kind": "alias",
-            "path": "docforge.cli.commands.api_utils.Any",
-            "signature": "<bound method Alias.signature of Alias('Any', 'docforge.cli.api_utils.Any')>",
-            "docstring": null
           }
         }
       },
@@ -131,42 +75,28 @@
         "name": "mcp_utils",
         "kind": "module",
         "path": "docforge.cli.commands.mcp_utils",
-        "signature": "<bound method Alias.signature of Alias('mcp_utils', 'docforge.cli.mcp_utils')>",
+        "signature": null,
         "docstring": "# Summary\n\nUtilities for working with MCP in the doc-forge CLI.\n\n---\n\nNotes:\n    - `generate_resources` produces the bundle consumed by `MCPServer`:\n      `index.json`, `nav.json`, and per-module resources under `modules/`.\n    - Resource URIs use the `docs://` scheme: `docs://index`, `docs://nav`,\n      and `docs://modules/{module}`.\n\n---",
         "members": {
-          "Path": {
-            "name": "Path",
-            "kind": "alias",
-            "path": "docforge.cli.commands.mcp_utils.Path",
-            "signature": "<bound method Alias.signature of Alias('Path', 'docforge.cli.mcp_utils.Path')>",
-            "docstring": null
-          },
-          "click": {
-            "name": "click",
-            "kind": "alias",
-            "path": "docforge.cli.commands.mcp_utils.click",
-            "signature": "<bound method Alias.signature of Alias('click', 'docforge.cli.mcp_utils.click')>",
-            "docstring": null
-          },
           "GriffeLoader": {
             "name": "GriffeLoader",
             "kind": "class",
             "path": "docforge.cli.commands.mcp_utils.GriffeLoader",
-            "signature": "<bound method Alias.signature of Alias('GriffeLoader', 'docforge.cli.mcp_utils.GriffeLoader')>",
+            "signature": "GriffeLoader()",
             "docstring": "Load Python modules using Griffe and convert them into doc-forge models.\n\nThis loader uses the Griffe introspection engine to analyze Python source\ncode and transform the extracted information into `Project`, `Module`,\nand `DocObject` instances used by doc-forge.\n\nAttributes:\n    _loader (_GriffeLoader):\n        Internal Griffe loader with dedicated module and line collections.",
             "members": {
               "load_project": {
                 "name": "load_project",
                 "kind": "function",
                 "path": "docforge.cli.commands.mcp_utils.GriffeLoader.load_project",
-                "signature": "<bound method Alias.signature of Alias('load_project', 'docforge.loaders.griffe_loader.GriffeLoader.load_project')>",
+                "signature": "load_project(module_paths: list[str], project_name: str | None = None, skip_import_errors: bool | None = None)",
                 "docstring": "Load multiple modules and assemble them into a Project model.\n\nEach module path is introspected and converted into a `Module`\ninstance. All modules are then aggregated into a single `Project`\nobject.\n\nArgs:\n    module_paths (list[str]):\n        List of dotted module import paths to load.\n\n    project_name (str | None):\n        Optional override for the project name. Defaults to the top-level\n        name of the first module.\n\n    skip_import_errors (bool | None):\n        If True, modules that fail to load will be skipped instead of raising an error.\n\nReturns:\n    Project:\n        A populated `Project` instance containing the loaded modules.\n\nRaises:\n    ValueError:\n        If no module paths are provided.\n\n    ImportError:\n        If a module fails to load and `skip_import_errors` is False."
               },
               "load_module": {
                 "name": "load_module",
                 "kind": "function",
                 "path": "docforge.cli.commands.mcp_utils.GriffeLoader.load_module",
-                "signature": "<bound method Alias.signature of Alias('load_module', 'docforge.loaders.griffe_loader.GriffeLoader.load_module')>",
+                "signature": "load_module(path: str)",
                 "docstring": "Load and convert a single Python module.\n\nThe module is introspected using Griffe and then transformed into\na doc-forge `Module` model.\n\nArgs:\n    path (str):\n        Dotted import path of the module.\n\nReturns:\n    Module:\n        A populated `Module` instance.\n\nRaises:\n    ImportError:\n        If the module cannot be loaded by Griffe.\n\n    KeyError:\n        If the loaded module is missing from the module collection.\n\nExample:\n    Load a single module:\n\n        ```python\n        loader = GriffeLoader()\n        module = loader.load_module(\"mypackage.submodule\")\n        ```"
               }
             }
@@ -175,28 +105,28 @@
             "name": "discover_module_paths",
             "kind": "function",
             "path": "docforge.cli.commands.mcp_utils.discover_module_paths",
-            "signature": "<bound method Alias.signature of Alias('discover_module_paths', 'docforge.cli.mcp_utils.discover_module_paths')>",
+            "signature": "discover_module_paths(module_name: str, project_root: Path | None = None)",
             "docstring": "Discover Python modules within a package directory.\n\nThe function scans the filesystem for `.py` files inside the specified\npackage and converts them into dotted module import paths.\n\nDiscovery rules:\n\n- Directories containing `__init__.py` are treated as packages.\n- Each `.py` file is treated as a module.\n- Results are returned as dotted import paths.\n\nArgs:\n    module_name (str):\n        Top-level package name to discover modules from.\n\n    project_root (Path | None):\n        Root directory used to resolve module paths. If not provided, the\n        current working directory is used.\n\nReturns:\n    list[str]:\n        A sorted list of unique dotted module import paths.\n\nRaises:\n    FileNotFoundError:\n        If the specified package directory does not exist."
           },
           "MCPRenderer": {
             "name": "MCPRenderer",
             "kind": "class",
             "path": "docforge.cli.commands.mcp_utils.MCPRenderer",
-            "signature": "<bound method Alias.signature of Alias('MCPRenderer', 'docforge.cli.mcp_utils.MCPRenderer')>",
+            "signature": null,
             "docstring": "Renderer that generates MCP-compatible documentation resources.\n\nThis renderer converts doc-forge project models into structured JSON\nresources suitable for consumption by systems implementing the Model\nContext Protocol (MCP).",
             "members": {
               "name": {
                 "name": "name",
                 "kind": "attribute",
                 "path": "docforge.cli.commands.mcp_utils.MCPRenderer.name",
-                "signature": "<bound method Alias.signature of Alias('name', 'docforge.renderers.mcp_renderer.MCPRenderer.name')>",
+                "signature": null,
                 "docstring": null
               },
               "generate_sources": {
                 "name": "generate_sources",
                 "kind": "function",
                 "path": "docforge.cli.commands.mcp_utils.MCPRenderer.generate_sources",
-                "signature": "<bound method Alias.signature of Alias('generate_sources', 'docforge.renderers.mcp_renderer.MCPRenderer.generate_sources')>",
+                "signature": "generate_sources(project: Project, out_dir: Path)",
                 "docstring": "Generate MCP documentation resources for a project.\n\nThe renderer serializes each module into a JSON resource and produces\nsupporting metadata files such as `nav.json` and `index.json`.\n\nArgs:\n    project (Project):\n        Documentation project model to render.\n\n    out_dir (Path):\n        Directory where MCP resources will be written."
               }
             }
@@ -205,28 +135,28 @@
             "name": "MCPServer",
             "kind": "class",
             "path": "docforge.cli.commands.mcp_utils.MCPServer",
-            "signature": "<bound method Alias.signature of Alias('MCPServer', 'docforge.cli.mcp_utils.MCPServer')>",
+            "signature": "MCPServer(mcp_root: Path, name: str)",
             "docstring": "MCP server for serving a pre-generated documentation bundle.\n\nThe server exposes documentation resources and diagnostic tools through\nMCP endpoints backed by JSON files generated by the MCP renderer.\n\nAttributes:\n    mcp_root (Path):\n        Directory containing the generated MCP documentation bundle.\n\n    app (FastMCP):\n        Underlying FastMCP application instance that registers resources\n        and tools.",
             "members": {
               "mcp_root": {
                 "name": "mcp_root",
                 "kind": "attribute",
                 "path": "docforge.cli.commands.mcp_utils.MCPServer.mcp_root",
-                "signature": "<bound method Alias.signature of Alias('mcp_root', 'docforge.servers.mcp_server.MCPServer.mcp_root')>",
+                "signature": null,
                 "docstring": null
               },
               "app": {
                 "name": "app",
                 "kind": "attribute",
                 "path": "docforge.cli.commands.mcp_utils.MCPServer.app",
-                "signature": "<bound method Alias.signature of Alias('app', 'docforge.servers.mcp_server.MCPServer.app')>",
+                "signature": null,
                 "docstring": null
               },
               "run": {
                 "name": "run",
                 "kind": "function",
                 "path": "docforge.cli.commands.mcp_utils.MCPServer.run",
-                "signature": "<bound method Alias.signature of Alias('run', 'docforge.servers.mcp_server.MCPServer.run')>",
+                "signature": "run(transport: Literal['stdio', 'sse', 'streamable-http'] = 'streamable-http')",
                 "docstring": "Start the MCP server.\n\nArgs:\n    transport (Literal[\"stdio\", \"sse\", \"streamable-http\"]):\n        Transport mechanism used by the MCP server. Supported options\n        include `stdio`, `sse`, and `streamable-http`."
               }
             }
@@ -235,14 +165,14 @@
             "name": "generate_resources",
             "kind": "function",
             "path": "docforge.cli.commands.mcp_utils.generate_resources",
-            "signature": "<bound method Alias.signature of Alias('generate_resources', 'docforge.cli.mcp_utils.generate_resources')>",
+            "signature": "generate_resources(module: str, project_name: str | None, out_dir: Path)",
             "docstring": "Generate MCP documentation resources from a Python module.\n\nThe function performs project introspection, builds the internal\ndocumentation model, and renders MCP-compatible JSON resources\nto the specified output directory.\n\nArgs:\n    module (str):\n        Python module import path used as the entry point for\n        documentation generation.\n\n    project_name (str | None):\n        Optional override for the project name used in generated\n        documentation metadata.\n\n    out_dir (Path):\n        Directory where MCP resources (index.json, nav.json, and module data)\n        will be written."
           },
           "serve": {
             "name": "serve",
             "kind": "function",
             "path": "docforge.cli.commands.mcp_utils.serve",
-            "signature": "<bound method Alias.signature of Alias('serve', 'docforge.cli.mcp_utils.serve')>",
+            "signature": "serve(module: str, mcp_root: Path)",
             "docstring": "Start an MCP server for a pre-generated documentation bundle.\n\nThe server exposes documentation resources such as project metadata,\nnavigation structure, and module documentation through MCP endpoints.\n\nArgs:\n    module (str):\n        Python module import path used to identify the served\n        documentation instance.\n\n    mcp_root (Path):\n        Path to the directory containing the MCP documentation\n        bundle (index.json, nav.json, and modules/).\n\nRaises:\n    click.ClickException:\n        If the MCP documentation bundle is missing required files or directories."
           }
         }
@@ -251,77 +181,28 @@
         "name": "mkdocs_utils",
         "kind": "module",
         "path": "docforge.cli.commands.mkdocs_utils",
-        "signature": "<bound method Alias.signature of Alias('mkdocs_utils', 'docforge.cli.mkdocs_utils')>",
+        "signature": null,
         "docstring": "# Summary\n\nUtilities for working with MkDocs in the doc-forge CLI.\n\n---\n\nNotes:\n    - A separate `mkdocs.{kind}.yml` configuration and build is emitted per\n      enabled kind (lib, api, wiki), each scoped to its own `docs_dir` and\n      written into its own `site_dir` (`site/lib`, `site/api`, `site/wiki`).\n    - Navigation blocks are re-rooted per kind: the wiki navigation drops its\n      leading `wiki/` scope and the resolved nav spec drops its `lib/` scope.\n\n---",
         "members": {
-          "Iterable": {
-            "name": "Iterable",
-            "kind": "alias",
-            "path": "docforge.cli.commands.mkdocs_utils.Iterable",
-            "signature": "<bound method Alias.signature of Alias('Iterable', 'docforge.cli.mkdocs_utils.Iterable')>",
-            "docstring": null
-          },
-          "resources": {
-            "name": "resources",
-            "kind": "alias",
-            "path": "docforge.cli.commands.mkdocs_utils.resources",
-            "signature": "<bound method Alias.signature of Alias('resources', 'docforge.cli.mkdocs_utils.resources')>",
-            "docstring": null
-          },
-          "Path": {
-            "name": "Path",
-            "kind": "alias",
-            "path": "docforge.cli.commands.mkdocs_utils.Path",
-            "signature": "<bound method Alias.signature of Alias('Path', 'docforge.cli.mkdocs_utils.Path')>",
-            "docstring": null
-          },
-          "Any": {
-            "name": "Any",
-            "kind": "alias",
-            "path": "docforge.cli.commands.mkdocs_utils.Any",
-            "signature": "<bound method Alias.signature of Alias('Any', 'docforge.cli.mkdocs_utils.Any')>",
-            "docstring": null
-          },
-          "cast": {
-            "name": "cast",
-            "kind": "alias",
-            "path": "docforge.cli.commands.mkdocs_utils.cast",
-            "signature": "<bound method Alias.signature of Alias('cast', 'docforge.cli.mkdocs_utils.cast')>",
-            "docstring": null
-          },
-          "click": {
-            "name": "click",
-            "kind": "alias",
-            "path": "docforge.cli.commands.mkdocs_utils.click",
-            "signature": "<bound method Alias.signature of Alias('click', 'docforge.cli.mkdocs_utils.click')>",
-            "docstring": null
-          },
-          "yaml": {
-            "name": "yaml",
-            "kind": "alias",
-            "path": "docforge.cli.commands.mkdocs_utils.yaml",
-            "signature": "<bound method Alias.signature of Alias('yaml', 'docforge.cli.mkdocs_utils.yaml')>",
-            "docstring": null
-          },
           "GriffeLoader": {
             "name": "GriffeLoader",
             "kind": "class",
             "path": "docforge.cli.commands.mkdocs_utils.GriffeLoader",
-            "signature": "<bound method Alias.signature of Alias('GriffeLoader', 'docforge.cli.mkdocs_utils.GriffeLoader')>",
+            "signature": "GriffeLoader()",
             "docstring": "Load Python modules using Griffe and convert them into doc-forge models.\n\nThis loader uses the Griffe introspection engine to analyze Python source\ncode and transform the extracted information into `Project`, `Module`,\nand `DocObject` instances used by doc-forge.\n\nAttributes:\n    _loader (_GriffeLoader):\n        Internal Griffe loader with dedicated module and line collections.",
             "members": {
               "load_project": {
                 "name": "load_project",
                 "kind": "function",
                 "path": "docforge.cli.commands.mkdocs_utils.GriffeLoader.load_project",
-                "signature": "<bound method Alias.signature of Alias('load_project', 'docforge.loaders.griffe_loader.GriffeLoader.load_project')>",
+                "signature": "load_project(module_paths: list[str], project_name: str | None = None, skip_import_errors: bool | None = None)",
                 "docstring": "Load multiple modules and assemble them into a Project model.\n\nEach module path is introspected and converted into a `Module`\ninstance. All modules are then aggregated into a single `Project`\nobject.\n\nArgs:\n    module_paths (list[str]):\n        List of dotted module import paths to load.\n\n    project_name (str | None):\n        Optional override for the project name. Defaults to the top-level\n        name of the first module.\n\n    skip_import_errors (bool | None):\n        If True, modules that fail to load will be skipped instead of raising an error.\n\nReturns:\n    Project:\n        A populated `Project` instance containing the loaded modules.\n\nRaises:\n    ValueError:\n        If no module paths are provided.\n\n    ImportError:\n        If a module fails to load and `skip_import_errors` is False."
               },
               "load_module": {
                 "name": "load_module",
                 "kind": "function",
                 "path": "docforge.cli.commands.mkdocs_utils.GriffeLoader.load_module",
-                "signature": "<bound method Alias.signature of Alias('load_module', 'docforge.loaders.griffe_loader.GriffeLoader.load_module')>",
+                "signature": "load_module(path: str)",
                 "docstring": "Load and convert a single Python module.\n\nThe module is introspected using Griffe and then transformed into\na doc-forge `Module` model.\n\nArgs:\n    path (str):\n        Dotted import path of the module.\n\nReturns:\n    Module:\n        A populated `Module` instance.\n\nRaises:\n    ImportError:\n        If the module cannot be loaded by Griffe.\n\n    KeyError:\n        If the loaded module is missing from the module collection.\n\nExample:\n    Load a single module:\n\n        ```python\n        loader = GriffeLoader()\n        module = loader.load_module(\"mypackage.submodule\")\n        ```"
               }
             }
@@ -330,21 +211,21 @@
             "name": "discover_module_paths",
             "kind": "function",
             "path": "docforge.cli.commands.mkdocs_utils.discover_module_paths",
-            "signature": "<bound method Alias.signature of Alias('discover_module_paths', 'docforge.cli.mkdocs_utils.discover_module_paths')>",
+            "signature": "discover_module_paths(module_name: str, project_root: Path | None = None)",
             "docstring": "Discover Python modules within a package directory.\n\nThe function scans the filesystem for `.py` files inside the specified\npackage and converts them into dotted module import paths.\n\nDiscovery rules:\n\n- Directories containing `__init__.py` are treated as packages.\n- Each `.py` file is treated as a module.\n- Results are returned as dotted import paths.\n\nArgs:\n    module_name (str):\n        Top-level package name to discover modules from.\n\n    project_root (Path | None):\n        Root directory used to resolve module paths. If not provided, the\n        current working directory is used.\n\nReturns:\n    list[str]:\n        A sorted list of unique dotted module import paths.\n\nRaises:\n    FileNotFoundError:\n        If the specified package directory does not exist."
           },
           "MkDocsNavEmitter": {
             "name": "MkDocsNavEmitter",
             "kind": "class",
             "path": "docforge.cli.commands.mkdocs_utils.MkDocsNavEmitter",
-            "signature": "<bound method Alias.signature of Alias('MkDocsNavEmitter', 'docforge.cli.mkdocs_utils.MkDocsNavEmitter')>",
+            "signature": null,
             "docstring": "Emit MkDocs navigation structures from resolved navigation data.\n\nThe emitter transforms a ``ResolvedNav`` object into the YAML-compatible\nlist structure expected by the MkDocs ``nav`` configuration field.",
             "members": {
               "emit": {
                 "name": "emit",
                 "kind": "function",
                 "path": "docforge.cli.commands.mkdocs_utils.MkDocsNavEmitter.emit",
-                "signature": "<bound method Alias.signature of Alias('emit', 'docforge.nav.mkdocs.MkDocsNavEmitter.emit')>",
+                "signature": "emit(nav: ResolvedNav)",
                 "docstring": "Generate a navigation structure for ``mkdocs.yml``.\n\nArgs:\n    nav (ResolvedNav):\n        Resolved navigation data describing documentation groups\n        and their associated Markdown files.\n\nReturns:\n    list[dict[str, Any]]:\n        A list of dictionaries representing the MkDocs navigation layout.\n        Each dictionary maps a navigation label to a page or a list of\n        pages."
               }
             }
@@ -353,49 +234,49 @@
             "name": "build_wiki_nav",
             "kind": "function",
             "path": "docforge.cli.commands.mkdocs_utils.build_wiki_nav",
-            "signature": "<bound method Alias.signature of Alias('build_wiki_nav', 'docforge.cli.mkdocs_utils.build_wiki_nav')>",
+            "signature": "build_wiki_nav(wiki_dir: Path)",
             "docstring": "Derive an MkDocs navigation block from a wiki directory.\n\nReturned paths are relative to the parent of ``wiki_dir`` and carry the\nwiki directory name as their leading component (for example\n``wiki/01_overview.md`` when the wiki lives at ``docs/wiki``). This makes\nthe result directly usable in an MkDocs ``nav`` block with\n\n- ``index.md`` at the wiki root becomes the ``Home`` entry.\n- Page labels are derived from filenames: numeric order prefixes such as\n  ``01_`` or ``02-`` are stripped, separators are replaced with spaces, and\n  names are title-cased (``01_overview.md`` becomes ``Overview``).\n- Subdirectories become nested navigation groups. A nested ``index.md`` is\n  rendered as the section root placed first inside the group.\n- Only ``.md`` files are considered; hidden entries are ignored.\n\nArgs:\n    wiki_dir (Path):\n        Path to the hand-written wiki directory, for example ``docs/wiki``.\n\nReturns:\n    list[dict[str, Any]]:\n        Navigation entries compatible with the MkDocs ``nav`` configuration.\n        The list is empty if the wiki contains no Markdown files.\n\nRaises:\n    FileNotFoundError:\n        If the wiki directory does not exist."
           },
           "load_nav_spec": {
             "name": "load_nav_spec",
             "kind": "function",
             "path": "docforge.cli.commands.mkdocs_utils.load_nav_spec",
-            "signature": "<bound method Alias.signature of Alias('load_nav_spec', 'docforge.cli.mkdocs_utils.load_nav_spec')>",
+            "signature": "load_nav_spec(path: Path)",
             "docstring": "Load a navigation specification file.\n\nThis helper function reads a YAML navigation file and constructs a\ncorresponding ``NavSpec`` instance.\n\nArgs:\n    path (Path):\n        Path to the navigation specification file.\n\nReturns:\n    NavSpec:\n        A ``NavSpec`` instance representing the parsed specification.\n\nRaises:\n    FileNotFoundError: If the specification file does not exist.\n    ValueError: If the YAML structure is invalid."
           },
           "resolve_nav": {
             "name": "resolve_nav",
             "kind": "function",
             "path": "docforge.cli.commands.mkdocs_utils.resolve_nav",
-            "signature": "<bound method Alias.signature of Alias('resolve_nav', 'docforge.cli.mkdocs_utils.resolve_nav')>",
+            "signature": "resolve_nav(spec: NavSpec, docs_root: Path)",
             "docstring": "Resolve a navigation specification against the filesystem.\n\nThe function expands glob patterns defined in a ``NavSpec`` and verifies\nthat referenced documentation files exist within the documentation root.\n\nArgs:\n    spec (NavSpec):\n        Navigation specification describing documentation layout.\n    docs_root (Path):\n        Root directory containing documentation Markdown files.\n\nReturns:\n    ResolvedNav:\n        A `ResolvedNav` instance containing validated navigation paths.\n\nRaises:\n    FileNotFoundError: If the documentation root does not exist or a\n        navigation pattern does not match any files."
           },
           "MkDocsRenderer": {
             "name": "MkDocsRenderer",
             "kind": "class",
             "path": "docforge.cli.commands.mkdocs_utils.MkDocsRenderer",
-            "signature": "<bound method Alias.signature of Alias('MkDocsRenderer', 'docforge.cli.mkdocs_utils.MkDocsRenderer')>",
+            "signature": null,
             "docstring": "Renderer that produces Markdown documentation for MkDocs.\n\nGenerated pages use mkdocstrings directives to reference Python modules,\nallowing MkDocs to render API documentation dynamically.",
             "members": {
               "name": {
                 "name": "name",
                 "kind": "attribute",
                 "path": "docforge.cli.commands.mkdocs_utils.MkDocsRenderer.name",
-                "signature": "<bound method Alias.signature of Alias('name', 'docforge.renderers.mkdocs_renderer.MkDocsRenderer.name')>",
+                "signature": null,
                 "docstring": null
               },
               "generate_sources": {
                 "name": "generate_sources",
                 "kind": "function",
                 "path": "docforge.cli.commands.mkdocs_utils.MkDocsRenderer.generate_sources",
-                "signature": "<bound method Alias.signature of Alias('generate_sources', 'docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_sources')>",
+                "signature": "generate_sources(project: Project, out_dir: Path, module_is_source: bool | None = None)",
                 "docstring": "Generate Markdown documentation files for a project.\n\nThis method renders a documentation structure from the provided\nproject model and writes the resulting Markdown files to the\nspecified output directory.\n\nArgs:\n    project (Project):\n        Project model containing modules to document.\n\n    out_dir (Path):\n        Directory where generated Markdown files will be written.\n\n    module_is_source (bool | None):\n        If True, treat the specified module as the documentation root\n        rather than nesting it inside a folder."
               },
               "generate_readme": {
                 "name": "generate_readme",
                 "kind": "function",
                 "path": "docforge.cli.commands.mkdocs_utils.MkDocsRenderer.generate_readme",
-                "signature": "<bound method Alias.signature of Alias('generate_readme', 'docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_readme')>",
+                "signature": "generate_readme(project: Project, docs_dir: Path, module_is_source: bool | None = None, readme_dir: Path | None = None)",
                 "docstring": "Generate a `README.md` file from the root module docstring.\n\nNotes:\n    - If `module_is_source` is True, `README.md` is written to the\n      project root directory.\n    - If False, README generation is currently not implemented.\n\nArgs:\n    project (Project):\n        Project model containing documentation metadata.\n\n    docs_dir (Path):\n        Directory containing generated documentation sources.\n\n    module_is_source (bool | None):\n        Whether the module is treated as the project source root.\n\n    readme_dir (Path | None):\n        Directory where the generated README.md should be written.\n        Defaults to the parent of `docs_dir`."
               }
             }
@@ -404,49 +285,49 @@
             "name": "generate_sources",
             "kind": "function",
             "path": "docforge.cli.commands.mkdocs_utils.generate_sources",
-            "signature": "<bound method Alias.signature of Alias('generate_sources', 'docforge.cli.mkdocs_utils.generate_sources')>",
+            "signature": "generate_sources(module: str, docs_dir: Path, project_name: str | None = None, module_is_source: bool | None = None, readme_dir: Path | None = None)",
             "docstring": "Generate MkDocs Markdown sources for a Python module.\n\nThis function introspects the specified module, builds the internal\ndocumentation model, and renders Markdown documentation files for\nuse with MkDocs.\n\nArgs:\n    module (str):\n        Python module import path used as the entry point for\n        documentation generation.\n\n    docs_dir (Path):\n        Directory where the generated Markdown files will be written.\n\n    project_name (str | None):\n        Optional override for the project name used in documentation metadata.\n\n    module_is_source (bool | None):\n        If True, treat the specified module directory as the project root\n        rather than a nested module.\n\n    readme_dir (Path | None):\n        Directory where the generated README.md should be written. If not\n        provided, defaults to the parent of ``docs_dir``."
           },
           "build_lib_nav": {
             "name": "build_lib_nav",
             "kind": "function",
             "path": "docforge.cli.commands.mkdocs_utils.build_lib_nav",
-            "signature": "<bound method Alias.signature of Alias('build_lib_nav', 'docforge.cli.mkdocs_utils.build_lib_nav')>",
+            "signature": "build_lib_nav(nav_file: Path, docs_root: Path)",
             "docstring": "Build the re-rooted navigation block for a lib site.\n\nThe navigation specification is resolved against the shared documentation\nroot and every resulting path is re-rooted relative to the ``lib``\nsubdirectory by stripping its leading ``lib/`` scope component.\n\nArgs:\n    nav_file (Path):\n        Path to the `docforge.nav.yml` navigation specification.\n\n    docs_root (Path):\n        Shared documentation root containing the ``lib`` sources.\n\nReturns:\n    tuple[list[dict[str, Any]], dict[str, str] | None]:\n        The re-rooted navigation block and the optional theme icon\n        mapping from the specification.\n\nRaises:\n    click.FileError:\n        If the navigation specification cannot be found."
           },
           "build_wiki_nav_block": {
             "name": "build_wiki_nav_block",
             "kind": "function",
             "path": "docforge.cli.commands.mkdocs_utils.build_wiki_nav_block",
-            "signature": "<bound method Alias.signature of Alias('build_wiki_nav_block', 'docforge.cli.mkdocs_utils.build_wiki_nav_block')>",
+            "signature": "build_wiki_nav_block(wiki_dir: Path)",
             "docstring": "Build the re-rooted navigation block for a wiki site.\n\nThe wiki navigation derived from the wiki file structure is re-rooted\nrelative to the wiki directory itself by stripping the leading ``wiki/``\nscope component.\n\nArgs:\n    wiki_dir (Path):\n        Path to the hand-written wiki directory, for example ``docs/wiki``.\n\nReturns:\n    list[dict[str, Any]]:\n        Navigation entries relative to the wiki directory.\n\nRaises:\n    click.FileError:\n        If the wiki directory does not exist."
           },
           "load_spec_icon": {
             "name": "load_spec_icon",
             "kind": "function",
             "path": "docforge.cli.commands.mkdocs_utils.load_spec_icon",
-            "signature": "<bound method Alias.signature of Alias('load_spec_icon', 'docforge.cli.mkdocs_utils.load_spec_icon')>",
+            "signature": "load_spec_icon(nav_file: Path)",
             "docstring": "Load the theme icon mapping from a navigation specification.\n\nArgs:\n    nav_file (Path):\n        Path to the navigation specification file.\n\nReturns:\n    dict[str, str] | None:\n        The icon mapping, or ``None`` when the specification file is\n        absent or cannot be parsed."
           },
           "generate_site_config": {
             "name": "generate_site_config",
             "kind": "function",
             "path": "docforge.cli.commands.mkdocs_utils.generate_site_config",
-            "signature": "<bound method Alias.signature of Alias('generate_site_config', 'docforge.cli.mkdocs_utils.generate_site_config')>",
+            "signature": "generate_site_config(kind: str, kind_root: Path, nav_block: list[dict[str, Any]], out: Path, site_name: str, docs_dir: str, site_dir: str, template: Path | None = None, site_description: str | None = None, site_author: str | None = None, theme_icon: dict[str, str] | None = None)",
             "docstring": "Generate a per-kind `mkdocs.{kind}.yml` configuration file.\n\nThe configuration is created by merging the shared ``mkdocs.common.yml``\ntemplate with the fragment contributed by the kind (``lib``, ``api``, or\n``wiki``). Both ``docs_dir`` and ``site_dir`` are written relative to the\nconfiguration file's directory: the kind's sources when expressed as a\nsibling path (for example ``lib``) and the per-kind site output (for\nexample ``../site/lib``).\n\nArgs:\n    kind (str):\n        Documentation kind, one of ``lib``, ``api``, or ``wiki``.\n\n    kind_root (Path):\n        Directory scoped to the kind (for example ``docs/lib``) that\n        serves as the MkDocs ``docs_dir``.\n\n    nav_block (list[dict[str, Any]]):\n        Re-rooted navigation entries for the kind's site.\n\n    out (Path):\n        Destination path where the generated ``mkdocs.{kind}.yml`` file\n        is written.\n\n    site_name (str):\n        Display name for the generated documentation site.\n\n    docs_dir (str):\n        MkDocs ``docs_dir`` value, relative to the configuration\n        file's directory.\n\n    site_dir (str):\n        MkDocs ``site_dir`` value, relative to the configuration\n        file's directory.\n\n    template (Path | None):\n        Optional path to a fully custom MkDocs configuration template\n        that replaces the built-in templates entirely.\n\n    site_description (str | None):\n        Optional site description written into the configuration.\n\n    site_author (str | None):\n        Optional site author written into the configuration.\n\n    theme_icon (dict[str, str] | None):\n        Optional mapping of theme icon entries injected as\n        ``theme.icon``."
           },
           "build_configs": {
             "name": "build_configs",
             "kind": "function",
             "path": "docforge.cli.commands.mkdocs_utils.build_configs",
-            "signature": "<bound method Alias.signature of Alias('build_configs', 'docforge.cli.mkdocs_utils.build_configs')>",
+            "signature": "build_configs(yml_paths: Iterable[Path])",
             "docstring": "Build the MkDocs documentation site for every given configuration.\n\nEach configuration file is loaded and built in turn, producing the\nper-kind static sites (``site/lib``, ``site/api``, ``site/wiki``).\n\nArgs:\n    yml_paths (Iterable[Path]):\n        Configuration files to build, in order.\n\nRaises:\n    click.ClickException:\n        If a configuration file does not exist."
           },
           "serve": {
             "name": "serve",
             "kind": "function",
             "path": "docforge.cli.commands.mkdocs_utils.serve",
-            "signature": "<bound method Alias.signature of Alias('serve', 'docforge.cli.mkdocs_utils.serve')>",
+            "signature": "serve(mkdocs_yml: Path)",
             "docstring": "Start an MkDocs development server with live reload.\n\nThe server watches documentation files and automatically reloads\nthe site when changes are detected.\n\nArgs:\n    mkdocs_yml (Path):\n        Path to the `mkdocs.yml` configuration file.\n\nRaises:\n    click.ClickException:\n        If the configuration file does not exist."
           }
         }
@@ -455,21 +336,21 @@
         "name": "GriffeLoader",
         "kind": "class",
         "path": "docforge.cli.commands.GriffeLoader",
-        "signature": "<bound method Alias.signature of Alias('GriffeLoader', 'docforge.loaders.GriffeLoader')>",
+        "signature": "GriffeLoader()",
         "docstring": "Load Python modules using Griffe and convert them into doc-forge models.\n\nThis loader uses the Griffe introspection engine to analyze Python source\ncode and transform the extracted information into `Project`, `Module`,\nand `DocObject` instances used by doc-forge.\n\nAttributes:\n    _loader (_GriffeLoader):\n        Internal Griffe loader with dedicated module and line collections.",
         "members": {
           "load_project": {
             "name": "load_project",
             "kind": "function",
             "path": "docforge.cli.commands.GriffeLoader.load_project",
-            "signature": "<bound method Alias.signature of Alias('load_project', 'docforge.loaders.griffe_loader.GriffeLoader.load_project')>",
+            "signature": "load_project(module_paths: list[str], project_name: str | None = None, skip_import_errors: bool | None = None)",
             "docstring": "Load multiple modules and assemble them into a Project model.\n\nEach module path is introspected and converted into a `Module`\ninstance. All modules are then aggregated into a single `Project`\nobject.\n\nArgs:\n    module_paths (list[str]):\n        List of dotted module import paths to load.\n\n    project_name (str | None):\n        Optional override for the project name. Defaults to the top-level\n        name of the first module.\n\n    skip_import_errors (bool | None):\n        If True, modules that fail to load will be skipped instead of raising an error.\n\nReturns:\n    Project:\n        A populated `Project` instance containing the loaded modules.\n\nRaises:\n    ValueError:\n        If no module paths are provided.\n\n    ImportError:\n        If a module fails to load and `skip_import_errors` is False."
           },
           "load_module": {
             "name": "load_module",
             "kind": "function",
             "path": "docforge.cli.commands.GriffeLoader.load_module",
-            "signature": "<bound method Alias.signature of Alias('load_module', 'docforge.loaders.griffe_loader.GriffeLoader.load_module')>",
+            "signature": "load_module(path: str)",
             "docstring": "Load and convert a single Python module.\n\nThe module is introspected using Griffe and then transformed into\na doc-forge `Module` model.\n\nArgs:\n    path (str):\n        Dotted import path of the module.\n\nReturns:\n    Module:\n        A populated `Module` instance.\n\nRaises:\n    ImportError:\n        If the module cannot be loaded by Griffe.\n\n    KeyError:\n        If the loaded module is missing from the module collection.\n\nExample:\n    Load a single module:\n\n        ```python\n        loader = GriffeLoader()\n        module = loader.load_module(\"mypackage.submodule\")\n        ```"
           }
         }
@@ -478,70 +359,70 @@
         "name": "DocObject",
         "kind": "class",
         "path": "docforge.cli.commands.DocObject",
-        "signature": "<bound method Alias.signature of Alias('DocObject', 'docforge.models.DocObject')>",
+        "signature": "DocObject(name: str, kind: str, path: str, signature: str | None = None, docstring: str | None = None)",
         "docstring": "Representation of a documented Python object.\n\nA `DocObject` models a single Python entity discovered during\nintrospection. Objects may contain nested members, allowing the structure\nof modules, classes, and other containers to be represented recursively.\n\nAttributes:\n    name (str):\n        Local name of the object.\n\n    kind (str):\n        Type of object (for example `class`, `function`, `method`, or `attribute`).\n\n    path (str):\n        Fully qualified dotted path to the object.\n\n    signature (str | None):\n        Callable signature if the object represents a callable.\n\n    docstring (str | None):\n        Raw docstring text extracted from the source code.\n\n    members (dict[str, DocObject]):\n        Mapping of member names to child `DocObject` instances.",
         "members": {
           "name": {
             "name": "name",
             "kind": "attribute",
             "path": "docforge.cli.commands.DocObject.name",
-            "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.object.DocObject.name')>",
+            "signature": null,
             "docstring": null
           },
           "kind": {
             "name": "kind",
             "kind": "attribute",
             "path": "docforge.cli.commands.DocObject.kind",
-            "signature": "<bound method Alias.signature of Alias('kind', 'docforge.models.object.DocObject.kind')>",
+            "signature": null,
             "docstring": null
           },
           "path": {
             "name": "path",
             "kind": "attribute",
             "path": "docforge.cli.commands.DocObject.path",
-            "signature": "<bound method Alias.signature of Alias('path', 'docforge.models.object.DocObject.path')>",
+            "signature": null,
             "docstring": null
           },
           "signature": {
             "name": "signature",
             "kind": "attribute",
             "path": "docforge.cli.commands.DocObject.signature",
-            "signature": "<bound method Alias.signature of Alias('signature', 'docforge.models.object.DocObject.signature')>",
+            "signature": null,
             "docstring": null
           },
           "docstring": {
             "name": "docstring",
             "kind": "attribute",
             "path": "docforge.cli.commands.DocObject.docstring",
-            "signature": "<bound method Alias.signature of Alias('docstring', 'docforge.models.object.DocObject.docstring')>",
+            "signature": null,
             "docstring": null
           },
           "members": {
             "name": "members",
             "kind": "attribute",
             "path": "docforge.cli.commands.DocObject.members",
-            "signature": "<bound method Alias.signature of Alias('members', 'docforge.models.object.DocObject.members')>",
+            "signature": null,
             "docstring": null
           },
           "add_member": {
             "name": "add_member",
             "kind": "function",
             "path": "docforge.cli.commands.DocObject.add_member",
-            "signature": "<bound method Alias.signature of Alias('add_member', 'docforge.models.object.DocObject.add_member')>",
+            "signature": "add_member(obj: DocObject)",
             "docstring": "Add a child documentation object.\n\nThis is typically used when attaching methods to classes or\nnested objects to their parent containers.\n\nArgs:\n    obj (DocObject):\n        Documentation object to add as a member."
           },
           "get_member": {
             "name": "get_member",
             "kind": "function",
             "path": "docforge.cli.commands.DocObject.get_member",
-            "signature": "<bound method Alias.signature of Alias('get_member', 'docforge.models.object.DocObject.get_member')>",
+            "signature": "get_member(name: str)",
             "docstring": "Retrieve a member object by name.\n\nArgs:\n    name (str):\n        Name of the member to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If the member does not exist."
           },
           "get_all_members": {
             "name": "get_all_members",
             "kind": "function",
             "path": "docforge.cli.commands.DocObject.get_all_members",
-            "signature": "<bound method Alias.signature of Alias('get_all_members', 'docforge.models.object.DocObject.get_all_members')>",
+            "signature": "get_all_members()",
             "docstring": "Return all child members of the object.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing nested members."
           }
         }
@@ -557,29 +438,22 @@
         "name": "build",
         "kind": "function",
         "path": "docforge.cli.commands.build",
-        "signature": "<bound method Function.signature of Function('build', 40, 264)>",
+        "signature": "build(mcp: bool, mkdocs: bool, api: bool, wiki: bool, refresh: bool, module_is_source: bool, module: str | None, openapi_spec: Path | None, project_name: str | None, site_name: str | None, docs_dir: Path, wiki_dir: Path, nav_file: Path, template: Path | None, out_dir: Path) -> None",
-        "docstring": "Build documentation artifacts.\n\nThis command runs the full documentation pipeline: it loads Python\nmodules, generates renderer-specific documentation sources, and\noptionally builds the final output.\n\nDepending on the selected options, the build can target:\n\n- A lib MkDocs site (`--mkdocs`) for library reference docs\n- A swagger-enabled API MkDocs site (`--api`) built from an OpenAPI spec\n- A wiki MkDocs site (`--wiki`) built from hand-written markdown\n- MCP structured documentation resources (`--mcp`)\n\nEach enabled site kind produces its own MkDocs configuration\n(`docs/mkdocs.{kind}.yml`) and its own build (`site/{kind}`).\n\nNotes:\n    - At least one of `--mcp`, `--mkdocs`, `--wiki`, or `--api` must be\n      provided.\n    - `--mkdocs`, `--api`, and `--wiki` emit independent MkDocs builds,\n      while `--mcp` emits a machine-readable bundle.\n\nArgs:\n    mcp (bool):\n        Enable MCP documentation generation.\n\n    mkdocs (bool):\n        Enable the lib MkDocs documentation generation.\n\n    api (bool):\n        Enable API documentation generation from an OpenAPI spec.\n\n    wiki (bool):\n        Build a hand-written wiki directory as its own MkDocs site.\n\n    module_is_source (bool):\n        Treat the specified module directory as the project root.\n\n    module (str | None):\n        Python module import path to document.\n\n    openapi_spec (Path | None):\n        Path to the OpenAPI JSON specification used for API docs.\n\n    project_name (str | None):\n        Optional override for the project name.\n\n    site_name (str | None):\n        Display name for the lib and wiki MkDocs sites.\n\n    docs_dir (Path):\n        Shared documentation root used for generated sources.\n    wiki_dir (Path):\n        Directory containing hand-written wiki markdown files.\n\n    nav_file (Path):\n        Path to the navigation specification file.\n\n    template (Path | None):\n        Optional custom MkDocs configuration template.\n\n    out_dir (Path):\n        Output directory for generated MCP resources.\n\nRaises:\n    click.UsageError:\n        If required options are missing or conflicting."
+        "docstring": "Build documentation artifacts.\n\nThis command runs the full documentation pipeline: it loads Python\nmodules, generates renderer-specific documentation sources, and\noptionally builds the final output.\n\nDepending on the selected options, the build can target:\n\n- A lib MkDocs site (`--mkdocs`) for library reference docs\n- A swagger-enabled API MkDocs site (`--api`) built from an OpenAPI spec\n- A wiki MkDocs site (`--wiki`) built from hand-written markdown\n- MCP structured documentation resources (`--mcp`)\n\nEach enabled site kind produces its own MkDocs configuration\n(`docs/mkdocs.{kind}.yml`) and its own build (`site/{kind}`).\n\nNotes:\n    - At least one of `--mcp`, `--mkdocs`, `--wiki`, or `--api` must be\n      provided.\n    - `--mkdocs`, `--api`, and `--wiki` emit independent MkDocs builds,\n      while `--mcp` emits a machine-readable bundle.\n    - Configuration files are generated only when absent; an existing\n      `docs/mkdocs.{kind}.yml` is used as-is. Pass `--refresh` to\n      rebaseline it from the templates.\n\nArgs:\n    mcp (bool):\n        Enable MCP documentation generation.\n\n    mkdocs (bool):\n        Enable the lib MkDocs documentation generation.\n\n    api (bool):\n        Enable API documentation generation from an OpenAPI spec.\n\n    wiki (bool):\n        Build a hand-written wiki directory as its own MkDocs site.\n\n    refresh (bool):\n        Regenerate ``docs/mkdocs.{kind}.yml`` from templates even when\n        it already exists. By default, existing configs are used as-is.\n\n    module_is_source (bool):\n        Treat the specified module directory as the project root.\n\n    module (str | None):\n        Python module import path to document.\n\n    openapi_spec (Path | None):\n        Path to the OpenAPI JSON specification used for API docs.\n\n    project_name (str | None):\n        Optional override for the project name.\n\n    site_name (str | None):\n        Display name for the lib and wiki MkDocs sites.\n\n    docs_dir (Path):\n        Shared documentation root used for generated sources.\n    wiki_dir (Path):\n        Directory containing hand-written wiki markdown files.\n\n    nav_file (Path):\n        Path to the navigation specification file.\n\n    template (Path | None):\n        Optional custom MkDocs configuration template.\n\n    out_dir (Path):\n        Output directory for generated MCP resources.\n\nRaises:\n    click.UsageError:\n        If required options are missing or conflicting."
       },
       "serve": {
         "name": "serve",
         "kind": "function",
         "path": "docforge.cli.commands.serve",
-        "signature": "<bound method Function.signature of Function('serve', 267, 367)>",
+        "signature": "serve(mcp: bool, mkdocs: bool, lib: bool, api: bool, wiki: bool, module: str | None, mkdocs_yml: Path, out_dir: Path) -> None",
         "docstring": "Serve generated documentation locally.\n\nDepending on the selected mode, this command starts either:\n\n- A MkDocs development server for browsing a site, or\n- An MCP server exposing structured documentation resources\n\nThe kind flags (`--lib`, `--api`, `--wiki`) select the generated\nper-kind config (`docs/mkdocs.{kind}.yml`); `--mkdocs` serves the config\npassed via `--mkdocs-yml`.\n\nArgs:\n    mcp (bool):\n        Serve documentation using the MCP server.\n\n    mkdocs (bool):\n        Serve the MkDocs development site from ``--mkdocs-yml``.\n\n    lib (bool):\n        Serve the lib MkDocs site.\n\n    api (bool):\n        Serve the API MkDocs site.\n\n    wiki (bool):\n        Serve the wiki MkDocs site.\n\n    module (str | None):\n        Python module import path to serve via MCP.\n\n    mkdocs_yml (Path):\n        Path to the MkDocs configuration file.\n\n    out_dir (Path):\n        Root directory containing MCP documentation resources.\n\nRaises:\n    click.UsageError:\n        If invalid or conflicting options are provided."
       },
       "tree": {
         "name": "tree",
         "kind": "function",
         "path": "docforge.cli.commands.tree",
-        "signature": "<bound method Function.signature of Function('tree', 370, 406)>",
+        "signature": "tree(module: str, project_name: str | None) -> None",
         "docstring": "Display the documentation object tree for a module.\n\nThis command introspects the specified module and prints a\nhierarchical representation of the discovered documentation\nobjects, including modules, classes, functions, and members.\n\nArgs:\n    module (str):\n        Python module import path to introspect.\n\n    project_name (str | None):\n        Optional name to display as the project root."
-      },
-      "Group": {
-        "name": "Group",
-        "kind": "alias",
-        "path": "docforge.cli.commands.Group",
-        "signature": "<bound method Alias.signature of Alias('Group', 'click.core.Group')>",
-        "docstring": null
       }
     }
   }

docs/mcp/modules/docforge.cli.main.json

@@ -8,14 +8,14 @@
         "name": "cli",
         "kind": "attribute",
         "path": "docforge.cli.main.cli",
-        "signature": "<bound method Alias.signature of Alias('cli', 'docforge.cli.commands.cli')>",
+        "signature": null,
         "docstring": null
       },
       "main": {
         "name": "main",
         "kind": "function",
         "path": "docforge.cli.main.main",
-        "signature": "<bound method Function.signature of Function('main', 13, 21)>",
+        "signature": "main() -> None",
         "docstring": "Run the doc-forge command-line interface.\n\nThis function initializes and executes the Click CLI application.\nIt is used as the console entry point when invoking `doc-forge`\nfrom the command line."
       }
     }

docs/mcp/modules/docforge.cli.mcp_utils.json

@@ -4,39 +4,25 @@
     "path": "docforge.cli.mcp_utils",
     "docstring": "# Summary\n\nUtilities for working with MCP in the doc-forge CLI.\n\n---\n\nNotes:\n    - `generate_resources` produces the bundle consumed by `MCPServer`:\n      `index.json`, `nav.json`, and per-module resources under `modules/`.\n    - Resource URIs use the `docs://` scheme: `docs://index`, `docs://nav`,\n      and `docs://modules/{module}`.\n\n---",
     "objects": {
-      "Path": {
-        "name": "Path",
-        "kind": "alias",
-        "path": "docforge.cli.mcp_utils.Path",
-        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
-        "docstring": null
-      },
-      "click": {
-        "name": "click",
-        "kind": "alias",
-        "path": "docforge.cli.mcp_utils.click",
-        "signature": "<bound method Alias.signature of Alias('click', 'click')>",
-        "docstring": null
-      },
       "GriffeLoader": {
         "name": "GriffeLoader",
         "kind": "class",
         "path": "docforge.cli.mcp_utils.GriffeLoader",
-        "signature": "<bound method Alias.signature of Alias('GriffeLoader', 'docforge.loaders.GriffeLoader')>",
+        "signature": "GriffeLoader()",
         "docstring": "Load Python modules using Griffe and convert them into doc-forge models.\n\nThis loader uses the Griffe introspection engine to analyze Python source\ncode and transform the extracted information into `Project`, `Module`,\nand `DocObject` instances used by doc-forge.\n\nAttributes:\n    _loader (_GriffeLoader):\n        Internal Griffe loader with dedicated module and line collections.",
         "members": {
           "load_project": {
             "name": "load_project",
             "kind": "function",
             "path": "docforge.cli.mcp_utils.GriffeLoader.load_project",
-            "signature": "<bound method Alias.signature of Alias('load_project', 'docforge.loaders.griffe_loader.GriffeLoader.load_project')>",
+            "signature": "load_project(module_paths: list[str], project_name: str | None = None, skip_import_errors: bool | None = None)",
             "docstring": "Load multiple modules and assemble them into a Project model.\n\nEach module path is introspected and converted into a `Module`\ninstance. All modules are then aggregated into a single `Project`\nobject.\n\nArgs:\n    module_paths (list[str]):\n        List of dotted module import paths to load.\n\n    project_name (str | None):\n        Optional override for the project name. Defaults to the top-level\n        name of the first module.\n\n    skip_import_errors (bool | None):\n        If True, modules that fail to load will be skipped instead of raising an error.\n\nReturns:\n    Project:\n        A populated `Project` instance containing the loaded modules.\n\nRaises:\n    ValueError:\n        If no module paths are provided.\n\n    ImportError:\n        If a module fails to load and `skip_import_errors` is False."
           },
           "load_module": {
             "name": "load_module",
             "kind": "function",
             "path": "docforge.cli.mcp_utils.GriffeLoader.load_module",
-            "signature": "<bound method Alias.signature of Alias('load_module', 'docforge.loaders.griffe_loader.GriffeLoader.load_module')>",
+            "signature": "load_module(path: str)",
             "docstring": "Load and convert a single Python module.\n\nThe module is introspected using Griffe and then transformed into\na doc-forge `Module` model.\n\nArgs:\n    path (str):\n        Dotted import path of the module.\n\nReturns:\n    Module:\n        A populated `Module` instance.\n\nRaises:\n    ImportError:\n        If the module cannot be loaded by Griffe.\n\n    KeyError:\n        If the loaded module is missing from the module collection.\n\nExample:\n    Load a single module:\n\n        ```python\n        loader = GriffeLoader()\n        module = loader.load_module(\"mypackage.submodule\")\n        ```"
           }
         }
@@ -45,28 +31,28 @@
         "name": "discover_module_paths",
         "kind": "function",
         "path": "docforge.cli.mcp_utils.discover_module_paths",
-        "signature": "<bound method Alias.signature of Alias('discover_module_paths', 'docforge.loaders.discover_module_paths')>",
+        "signature": "discover_module_paths(module_name: str, project_root: Path | None = None)",
         "docstring": "Discover Python modules within a package directory.\n\nThe function scans the filesystem for `.py` files inside the specified\npackage and converts them into dotted module import paths.\n\nDiscovery rules:\n\n- Directories containing `__init__.py` are treated as packages.\n- Each `.py` file is treated as a module.\n- Results are returned as dotted import paths.\n\nArgs:\n    module_name (str):\n        Top-level package name to discover modules from.\n\n    project_root (Path | None):\n        Root directory used to resolve module paths. If not provided, the\n        current working directory is used.\n\nReturns:\n    list[str]:\n        A sorted list of unique dotted module import paths.\n\nRaises:\n    FileNotFoundError:\n        If the specified package directory does not exist."
       },
       "MCPRenderer": {
         "name": "MCPRenderer",
         "kind": "class",
         "path": "docforge.cli.mcp_utils.MCPRenderer",
-        "signature": "<bound method Alias.signature of Alias('MCPRenderer', 'docforge.renderers.MCPRenderer')>",
+        "signature": null,
         "docstring": "Renderer that generates MCP-compatible documentation resources.\n\nThis renderer converts doc-forge project models into structured JSON\nresources suitable for consumption by systems implementing the Model\nContext Protocol (MCP).",
         "members": {
           "name": {
             "name": "name",
             "kind": "attribute",
             "path": "docforge.cli.mcp_utils.MCPRenderer.name",
-            "signature": "<bound method Alias.signature of Alias('name', 'docforge.renderers.mcp_renderer.MCPRenderer.name')>",
+            "signature": null,
             "docstring": null
           },
           "generate_sources": {
             "name": "generate_sources",
             "kind": "function",
             "path": "docforge.cli.mcp_utils.MCPRenderer.generate_sources",
-            "signature": "<bound method Alias.signature of Alias('generate_sources', 'docforge.renderers.mcp_renderer.MCPRenderer.generate_sources')>",
+            "signature": "generate_sources(project: Project, out_dir: Path)",
             "docstring": "Generate MCP documentation resources for a project.\n\nThe renderer serializes each module into a JSON resource and produces\nsupporting metadata files such as `nav.json` and `index.json`.\n\nArgs:\n    project (Project):\n        Documentation project model to render.\n\n    out_dir (Path):\n        Directory where MCP resources will be written."
           }
         }
@@ -75,28 +61,28 @@
         "name": "MCPServer",
         "kind": "class",
         "path": "docforge.cli.mcp_utils.MCPServer",
-        "signature": "<bound method Alias.signature of Alias('MCPServer', 'docforge.servers.MCPServer')>",
+        "signature": "MCPServer(mcp_root: Path, name: str)",
         "docstring": "MCP server for serving a pre-generated documentation bundle.\n\nThe server exposes documentation resources and diagnostic tools through\nMCP endpoints backed by JSON files generated by the MCP renderer.\n\nAttributes:\n    mcp_root (Path):\n        Directory containing the generated MCP documentation bundle.\n\n    app (FastMCP):\n        Underlying FastMCP application instance that registers resources\n        and tools.",
         "members": {
           "mcp_root": {
             "name": "mcp_root",
             "kind": "attribute",
             "path": "docforge.cli.mcp_utils.MCPServer.mcp_root",
-            "signature": "<bound method Alias.signature of Alias('mcp_root', 'docforge.servers.mcp_server.MCPServer.mcp_root')>",
+            "signature": null,
             "docstring": null
           },
           "app": {
             "name": "app",
             "kind": "attribute",
             "path": "docforge.cli.mcp_utils.MCPServer.app",
-            "signature": "<bound method Alias.signature of Alias('app', 'docforge.servers.mcp_server.MCPServer.app')>",
+            "signature": null,
             "docstring": null
           },
           "run": {
             "name": "run",
             "kind": "function",
             "path": "docforge.cli.mcp_utils.MCPServer.run",
-            "signature": "<bound method Alias.signature of Alias('run', 'docforge.servers.mcp_server.MCPServer.run')>",
+            "signature": "run(transport: Literal['stdio', 'sse', 'streamable-http'] = 'streamable-http')",
             "docstring": "Start the MCP server.\n\nArgs:\n    transport (Literal[\"stdio\", \"sse\", \"streamable-http\"]):\n        Transport mechanism used by the MCP server. Supported options\n        include `stdio`, `sse`, and `streamable-http`."
           }
         }
@@ -105,14 +91,14 @@
         "name": "generate_resources",
         "kind": "function",
         "path": "docforge.cli.mcp_utils.generate_resources",
-        "signature": "<bound method Function.signature of Function('generate_resources', 26, 52)>",
+        "signature": "generate_resources(module: str, project_name: str | None, out_dir: Path) -> None",
         "docstring": "Generate MCP documentation resources from a Python module.\n\nThe function performs project introspection, builds the internal\ndocumentation model, and renders MCP-compatible JSON resources\nto the specified output directory.\n\nArgs:\n    module (str):\n        Python module import path used as the entry point for\n        documentation generation.\n\n    project_name (str | None):\n        Optional override for the project name used in generated\n        documentation metadata.\n\n    out_dir (Path):\n        Directory where MCP resources (index.json, nav.json, and module data)\n        will be written."
       },
       "serve": {
         "name": "serve",
         "kind": "function",
         "path": "docforge.cli.mcp_utils.serve",
-        "signature": "<bound method Function.signature of Function('serve', 55, 92)>",
+        "signature": "serve(module: str, mcp_root: Path) -> None",
         "docstring": "Start an MCP server for a pre-generated documentation bundle.\n\nThe server exposes documentation resources such as project metadata,\nnavigation structure, and module documentation through MCP endpoints.\n\nArgs:\n    module (str):\n        Python module import path used to identify the served\n        documentation instance.\n\n    mcp_root (Path):\n        Path to the directory containing the MCP documentation\n        bundle (index.json, nav.json, and modules/).\n\nRaises:\n    click.ClickException:\n        If the MCP documentation bundle is missing required files or directories."
       }
     }

docs/mcp/modules/docforge.cli.mkdocs_utils.json

@@ -4,74 +4,25 @@
     "path": "docforge.cli.mkdocs_utils",
     "docstring": "# Summary\n\nUtilities for working with MkDocs in the doc-forge CLI.\n\n---\n\nNotes:\n    - A separate `mkdocs.{kind}.yml` configuration and build is emitted per\n      enabled kind (lib, api, wiki), each scoped to its own `docs_dir` and\n      written into its own `site_dir` (`site/lib`, `site/api`, `site/wiki`).\n    - Navigation blocks are re-rooted per kind: the wiki navigation drops its\n      leading `wiki/` scope and the resolved nav spec drops its `lib/` scope.\n\n---",
     "objects": {
-      "Iterable": {
-        "name": "Iterable",
-        "kind": "alias",
-        "path": "docforge.cli.mkdocs_utils.Iterable",
-        "signature": "<bound method Alias.signature of Alias('Iterable', 'collections.abc.Iterable')>",
-        "docstring": null
-      },
-      "resources": {
-        "name": "resources",
-        "kind": "alias",
-        "path": "docforge.cli.mkdocs_utils.resources",
-        "signature": "<bound method Alias.signature of Alias('resources', 'importlib.resources')>",
-        "docstring": null
-      },
-      "Path": {
-        "name": "Path",
-        "kind": "alias",
-        "path": "docforge.cli.mkdocs_utils.Path",
-        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
-        "docstring": null
-      },
-      "Any": {
-        "name": "Any",
-        "kind": "alias",
-        "path": "docforge.cli.mkdocs_utils.Any",
-        "signature": "<bound method Alias.signature of Alias('Any', 'typing.Any')>",
-        "docstring": null
-      },
-      "cast": {
-        "name": "cast",
-        "kind": "alias",
-        "path": "docforge.cli.mkdocs_utils.cast",
-        "signature": "<bound method Alias.signature of Alias('cast', 'typing.cast')>",
-        "docstring": null
-      },
-      "click": {
-        "name": "click",
-        "kind": "alias",
-        "path": "docforge.cli.mkdocs_utils.click",
-        "signature": "<bound method Alias.signature of Alias('click', 'click')>",
-        "docstring": null
-      },
-      "yaml": {
-        "name": "yaml",
-        "kind": "alias",
-        "path": "docforge.cli.mkdocs_utils.yaml",
-        "signature": "<bound method Alias.signature of Alias('yaml', 'yaml')>",
-        "docstring": null
-      },
       "GriffeLoader": {
         "name": "GriffeLoader",
         "kind": "class",
         "path": "docforge.cli.mkdocs_utils.GriffeLoader",
-        "signature": "<bound method Alias.signature of Alias('GriffeLoader', 'docforge.loaders.GriffeLoader')>",
+        "signature": "GriffeLoader()",
         "docstring": "Load Python modules using Griffe and convert them into doc-forge models.\n\nThis loader uses the Griffe introspection engine to analyze Python source\ncode and transform the extracted information into `Project`, `Module`,\nand `DocObject` instances used by doc-forge.\n\nAttributes:\n    _loader (_GriffeLoader):\n        Internal Griffe loader with dedicated module and line collections.",
         "members": {
           "load_project": {
             "name": "load_project",
             "kind": "function",
             "path": "docforge.cli.mkdocs_utils.GriffeLoader.load_project",
-            "signature": "<bound method Alias.signature of Alias('load_project', 'docforge.loaders.griffe_loader.GriffeLoader.load_project')>",
+            "signature": "load_project(module_paths: list[str], project_name: str | None = None, skip_import_errors: bool | None = None)",
             "docstring": "Load multiple modules and assemble them into a Project model.\n\nEach module path is introspected and converted into a `Module`\ninstance. All modules are then aggregated into a single `Project`\nobject.\n\nArgs:\n    module_paths (list[str]):\n        List of dotted module import paths to load.\n\n    project_name (str | None):\n        Optional override for the project name. Defaults to the top-level\n        name of the first module.\n\n    skip_import_errors (bool | None):\n        If True, modules that fail to load will be skipped instead of raising an error.\n\nReturns:\n    Project:\n        A populated `Project` instance containing the loaded modules.\n\nRaises:\n    ValueError:\n        If no module paths are provided.\n\n    ImportError:\n        If a module fails to load and `skip_import_errors` is False."
           },
           "load_module": {
             "name": "load_module",
             "kind": "function",
             "path": "docforge.cli.mkdocs_utils.GriffeLoader.load_module",
-            "signature": "<bound method Alias.signature of Alias('load_module', 'docforge.loaders.griffe_loader.GriffeLoader.load_module')>",
+            "signature": "load_module(path: str)",
             "docstring": "Load and convert a single Python module.\n\nThe module is introspected using Griffe and then transformed into\na doc-forge `Module` model.\n\nArgs:\n    path (str):\n        Dotted import path of the module.\n\nReturns:\n    Module:\n        A populated `Module` instance.\n\nRaises:\n    ImportError:\n        If the module cannot be loaded by Griffe.\n\n    KeyError:\n        If the loaded module is missing from the module collection.\n\nExample:\n    Load a single module:\n\n        ```python\n        loader = GriffeLoader()\n        module = loader.load_module(\"mypackage.submodule\")\n        ```"
           }
         }
@@ -80,21 +31,21 @@
         "name": "discover_module_paths",
         "kind": "function",
         "path": "docforge.cli.mkdocs_utils.discover_module_paths",
-        "signature": "<bound method Alias.signature of Alias('discover_module_paths', 'docforge.loaders.discover_module_paths')>",
+        "signature": "discover_module_paths(module_name: str, project_root: Path | None = None)",
         "docstring": "Discover Python modules within a package directory.\n\nThe function scans the filesystem for `.py` files inside the specified\npackage and converts them into dotted module import paths.\n\nDiscovery rules:\n\n- Directories containing `__init__.py` are treated as packages.\n- Each `.py` file is treated as a module.\n- Results are returned as dotted import paths.\n\nArgs:\n    module_name (str):\n        Top-level package name to discover modules from.\n\n    project_root (Path | None):\n        Root directory used to resolve module paths. If not provided, the\n        current working directory is used.\n\nReturns:\n    list[str]:\n        A sorted list of unique dotted module import paths.\n\nRaises:\n    FileNotFoundError:\n        If the specified package directory does not exist."
       },
       "MkDocsNavEmitter": {
         "name": "MkDocsNavEmitter",
         "kind": "class",
         "path": "docforge.cli.mkdocs_utils.MkDocsNavEmitter",
-        "signature": "<bound method Alias.signature of Alias('MkDocsNavEmitter', 'docforge.nav.MkDocsNavEmitter')>",
+        "signature": null,
         "docstring": "Emit MkDocs navigation structures from resolved navigation data.\n\nThe emitter transforms a ``ResolvedNav`` object into the YAML-compatible\nlist structure expected by the MkDocs ``nav`` configuration field.",
         "members": {
           "emit": {
             "name": "emit",
             "kind": "function",
             "path": "docforge.cli.mkdocs_utils.MkDocsNavEmitter.emit",
-            "signature": "<bound method Alias.signature of Alias('emit', 'docforge.nav.mkdocs.MkDocsNavEmitter.emit')>",
+            "signature": "emit(nav: ResolvedNav)",
             "docstring": "Generate a navigation structure for ``mkdocs.yml``.\n\nArgs:\n    nav (ResolvedNav):\n        Resolved navigation data describing documentation groups\n        and their associated Markdown files.\n\nReturns:\n    list[dict[str, Any]]:\n        A list of dictionaries representing the MkDocs navigation layout.\n        Each dictionary maps a navigation label to a page or a list of\n        pages."
           }
         }
@@ -103,49 +54,49 @@
         "name": "build_wiki_nav",
         "kind": "function",
         "path": "docforge.cli.mkdocs_utils.build_wiki_nav",
-        "signature": "<bound method Alias.signature of Alias('build_wiki_nav', 'docforge.nav.build_wiki_nav')>",
+        "signature": "build_wiki_nav(wiki_dir: Path)",
         "docstring": "Derive an MkDocs navigation block from a wiki directory.\n\nReturned paths are relative to the parent of ``wiki_dir`` and carry the\nwiki directory name as their leading component (for example\n``wiki/01_overview.md`` when the wiki lives at ``docs/wiki``). This makes\nthe result directly usable in an MkDocs ``nav`` block with\n\n- ``index.md`` at the wiki root becomes the ``Home`` entry.\n- Page labels are derived from filenames: numeric order prefixes such as\n  ``01_`` or ``02-`` are stripped, separators are replaced with spaces, and\n  names are title-cased (``01_overview.md`` becomes ``Overview``).\n- Subdirectories become nested navigation groups. A nested ``index.md`` is\n  rendered as the section root placed first inside the group.\n- Only ``.md`` files are considered; hidden entries are ignored.\n\nArgs:\n    wiki_dir (Path):\n        Path to the hand-written wiki directory, for example ``docs/wiki``.\n\nReturns:\n    list[dict[str, Any]]:\n        Navigation entries compatible with the MkDocs ``nav`` configuration.\n        The list is empty if the wiki contains no Markdown files.\n\nRaises:\n    FileNotFoundError:\n        If the wiki directory does not exist."
       },
       "load_nav_spec": {
         "name": "load_nav_spec",
         "kind": "function",
         "path": "docforge.cli.mkdocs_utils.load_nav_spec",
-        "signature": "<bound method Alias.signature of Alias('load_nav_spec', 'docforge.nav.load_nav_spec')>",
+        "signature": "load_nav_spec(path: Path)",
         "docstring": "Load a navigation specification file.\n\nThis helper function reads a YAML navigation file and constructs a\ncorresponding ``NavSpec`` instance.\n\nArgs:\n    path (Path):\n        Path to the navigation specification file.\n\nReturns:\n    NavSpec:\n        A ``NavSpec`` instance representing the parsed specification.\n\nRaises:\n    FileNotFoundError: If the specification file does not exist.\n    ValueError: If the YAML structure is invalid."
       },
       "resolve_nav": {
         "name": "resolve_nav",
         "kind": "function",
         "path": "docforge.cli.mkdocs_utils.resolve_nav",
-        "signature": "<bound method Alias.signature of Alias('resolve_nav', 'docforge.nav.resolve_nav')>",
+        "signature": "resolve_nav(spec: NavSpec, docs_root: Path)",
         "docstring": "Resolve a navigation specification against the filesystem.\n\nThe function expands glob patterns defined in a ``NavSpec`` and verifies\nthat referenced documentation files exist within the documentation root.\n\nArgs:\n    spec (NavSpec):\n        Navigation specification describing documentation layout.\n    docs_root (Path):\n        Root directory containing documentation Markdown files.\n\nReturns:\n    ResolvedNav:\n        A `ResolvedNav` instance containing validated navigation paths.\n\nRaises:\n    FileNotFoundError: If the documentation root does not exist or a\n        navigation pattern does not match any files."
       },
       "MkDocsRenderer": {
         "name": "MkDocsRenderer",
         "kind": "class",
         "path": "docforge.cli.mkdocs_utils.MkDocsRenderer",
-        "signature": "<bound method Alias.signature of Alias('MkDocsRenderer', 'docforge.renderers.MkDocsRenderer')>",
+        "signature": null,
         "docstring": "Renderer that produces Markdown documentation for MkDocs.\n\nGenerated pages use mkdocstrings directives to reference Python modules,\nallowing MkDocs to render API documentation dynamically.",
         "members": {
           "name": {
             "name": "name",
             "kind": "attribute",
             "path": "docforge.cli.mkdocs_utils.MkDocsRenderer.name",
-            "signature": "<bound method Alias.signature of Alias('name', 'docforge.renderers.mkdocs_renderer.MkDocsRenderer.name')>",
+            "signature": null,
             "docstring": null
           },
           "generate_sources": {
             "name": "generate_sources",
             "kind": "function",
             "path": "docforge.cli.mkdocs_utils.MkDocsRenderer.generate_sources",
-            "signature": "<bound method Alias.signature of Alias('generate_sources', 'docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_sources')>",
+            "signature": "generate_sources(project: Project, out_dir: Path, module_is_source: bool | None = None)",
             "docstring": "Generate Markdown documentation files for a project.\n\nThis method renders a documentation structure from the provided\nproject model and writes the resulting Markdown files to the\nspecified output directory.\n\nArgs:\n    project (Project):\n        Project model containing modules to document.\n\n    out_dir (Path):\n        Directory where generated Markdown files will be written.\n\n    module_is_source (bool | None):\n        If True, treat the specified module as the documentation root\n        rather than nesting it inside a folder."
           },
           "generate_readme": {
             "name": "generate_readme",
             "kind": "function",
             "path": "docforge.cli.mkdocs_utils.MkDocsRenderer.generate_readme",
-            "signature": "<bound method Alias.signature of Alias('generate_readme', 'docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_readme')>",
+            "signature": "generate_readme(project: Project, docs_dir: Path, module_is_source: bool | None = None, readme_dir: Path | None = None)",
             "docstring": "Generate a `README.md` file from the root module docstring.\n\nNotes:\n    - If `module_is_source` is True, `README.md` is written to the\n      project root directory.\n    - If False, README generation is currently not implemented.\n\nArgs:\n    project (Project):\n        Project model containing documentation metadata.\n\n    docs_dir (Path):\n        Directory containing generated documentation sources.\n\n    module_is_source (bool | None):\n        Whether the module is treated as the project source root.\n\n    readme_dir (Path | None):\n        Directory where the generated README.md should be written.\n        Defaults to the parent of `docs_dir`."
           }
         }
@@ -154,49 +105,49 @@
         "name": "generate_sources",
         "kind": "function",
         "path": "docforge.cli.mkdocs_utils.generate_sources",
-        "signature": "<bound method Function.signature of Function('generate_sources', 36, 85)>",
+        "signature": "generate_sources(module: str, docs_dir: Path, project_name: str | None = None, module_is_source: bool | None = None, readme_dir: Path | None = None) -> None",
         "docstring": "Generate MkDocs Markdown sources for a Python module.\n\nThis function introspects the specified module, builds the internal\ndocumentation model, and renders Markdown documentation files for\nuse with MkDocs.\n\nArgs:\n    module (str):\n        Python module import path used as the entry point for\n        documentation generation.\n\n    docs_dir (Path):\n        Directory where the generated Markdown files will be written.\n\n    project_name (str | None):\n        Optional override for the project name used in documentation metadata.\n\n    module_is_source (bool | None):\n        If True, treat the specified module directory as the project root\n        rather than a nested module.\n\n    readme_dir (Path | None):\n        Directory where the generated README.md should be written. If not\n        provided, defaults to the parent of ``docs_dir``."
       },
       "build_lib_nav": {
         "name": "build_lib_nav",
         "kind": "function",
         "path": "docforge.cli.mkdocs_utils.build_lib_nav",
-        "signature": "<bound method Function.signature of Function('build_lib_nav', 88, 121)>",
+        "signature": "build_lib_nav(nav_file: Path, docs_root: Path) -> tuple[list[dict[str, Any]], dict[str, str] | None]",
         "docstring": "Build the re-rooted navigation block for a lib site.\n\nThe navigation specification is resolved against the shared documentation\nroot and every resulting path is re-rooted relative to the ``lib``\nsubdirectory by stripping its leading ``lib/`` scope component.\n\nArgs:\n    nav_file (Path):\n        Path to the `docforge.nav.yml` navigation specification.\n\n    docs_root (Path):\n        Shared documentation root containing the ``lib`` sources.\n\nReturns:\n    tuple[list[dict[str, Any]], dict[str, str] | None]:\n        The re-rooted navigation block and the optional theme icon\n        mapping from the specification.\n\nRaises:\n    click.FileError:\n        If the navigation specification cannot be found."
       },
       "build_wiki_nav_block": {
         "name": "build_wiki_nav_block",
         "kind": "function",
         "path": "docforge.cli.mkdocs_utils.build_wiki_nav_block",
-        "signature": "<bound method Function.signature of Function('build_wiki_nav_block', 124, 147)>",
+        "signature": "build_wiki_nav_block(wiki_dir: Path) -> list[dict[str, Any]]",
         "docstring": "Build the re-rooted navigation block for a wiki site.\n\nThe wiki navigation derived from the wiki file structure is re-rooted\nrelative to the wiki directory itself by stripping the leading ``wiki/``\nscope component.\n\nArgs:\n    wiki_dir (Path):\n        Path to the hand-written wiki directory, for example ``docs/wiki``.\n\nReturns:\n    list[dict[str, Any]]:\n        Navigation entries relative to the wiki directory.\n\nRaises:\n    click.FileError:\n        If the wiki directory does not exist."
       },
       "load_spec_icon": {
         "name": "load_spec_icon",
         "kind": "function",
         "path": "docforge.cli.mkdocs_utils.load_spec_icon",
-        "signature": "<bound method Function.signature of Function('load_spec_icon', 150, 169)>",
+        "signature": "load_spec_icon(nav_file: Path) -> dict[str, str] | None",
         "docstring": "Load the theme icon mapping from a navigation specification.\n\nArgs:\n    nav_file (Path):\n        Path to the navigation specification file.\n\nReturns:\n    dict[str, str] | None:\n        The icon mapping, or ``None`` when the specification file is\n        absent or cannot be parsed."
       },
       "generate_site_config": {
         "name": "generate_site_config",
         "kind": "function",
         "path": "docforge.cli.mkdocs_utils.generate_site_config",
-        "signature": "<bound method Function.signature of Function('generate_site_config', 201, 282)>",
+        "signature": "generate_site_config(kind: str, kind_root: Path, nav_block: list[dict[str, Any]], out: Path, site_name: str, docs_dir: str, site_dir: str, template: Path | None = None, site_description: str | None = None, site_author: str | None = None, theme_icon: dict[str, str] | None = None) -> None",
         "docstring": "Generate a per-kind `mkdocs.{kind}.yml` configuration file.\n\nThe configuration is created by merging the shared ``mkdocs.common.yml``\ntemplate with the fragment contributed by the kind (``lib``, ``api``, or\n``wiki``). Both ``docs_dir`` and ``site_dir`` are written relative to the\nconfiguration file's directory: the kind's sources when expressed as a\nsibling path (for example ``lib``) and the per-kind site output (for\nexample ``../site/lib``).\n\nArgs:\n    kind (str):\n        Documentation kind, one of ``lib``, ``api``, or ``wiki``.\n\n    kind_root (Path):\n        Directory scoped to the kind (for example ``docs/lib``) that\n        serves as the MkDocs ``docs_dir``.\n\n    nav_block (list[dict[str, Any]]):\n        Re-rooted navigation entries for the kind's site.\n\n    out (Path):\n        Destination path where the generated ``mkdocs.{kind}.yml`` file\n        is written.\n\n    site_name (str):\n        Display name for the generated documentation site.\n\n    docs_dir (str):\n        MkDocs ``docs_dir`` value, relative to the configuration\n        file's directory.\n\n    site_dir (str):\n        MkDocs ``site_dir`` value, relative to the configuration\n        file's directory.\n\n    template (Path | None):\n        Optional path to a fully custom MkDocs configuration template\n        that replaces the built-in templates entirely.\n\n    site_description (str | None):\n        Optional site description written into the configuration.\n\n    site_author (str | None):\n        Optional site author written into the configuration.\n\n    theme_icon (dict[str, str] | None):\n        Optional mapping of theme icon entries injected as\n        ``theme.icon``."
       },
       "build_configs": {
         "name": "build_configs",
         "kind": "function",
         "path": "docforge.cli.mkdocs_utils.build_configs",
-        "signature": "<bound method Function.signature of Function('build_configs', 409, 430)>",
+        "signature": "build_configs(yml_paths: Iterable[Path]) -> None",
         "docstring": "Build the MkDocs documentation site for every given configuration.\n\nEach configuration file is loaded and built in turn, producing the\nper-kind static sites (``site/lib``, ``site/api``, ``site/wiki``).\n\nArgs:\n    yml_paths (Iterable[Path]):\n        Configuration files to build, in order.\n\nRaises:\n    click.ClickException:\n        If a configuration file does not exist."
       },
       "serve": {
         "name": "serve",
         "kind": "function",
         "path": "docforge.cli.mkdocs_utils.serve",
-        "signature": "<bound method Function.signature of Function('serve', 433, 453)>",
+        "signature": "serve(mkdocs_yml: Path) -> None",
         "docstring": "Start an MkDocs development server with live reload.\n\nThe server watches documentation files and automatically reloads\nthe site when changes are detected.\n\nArgs:\n    mkdocs_yml (Path):\n        Path to the `mkdocs.yml` configuration file.\n\nRaises:\n    click.ClickException:\n        If the configuration file does not exist."
       }
     }

docs/mcp/modules/docforge.loaders.griffe_loader.json

@@ -2,118 +2,76 @@
   "module": "docforge.loaders.griffe_loader",
   "content": {
     "path": "docforge.loaders.griffe_loader",
-    "docstring": "# Summary\n\nUtilities for loading and introspecting Python modules using Griffe.\n\nThis module provides the `GriffeLoader` class and helper utilities used to\ndiscover Python modules, introspect their structure, and convert the results\ninto doc-forge documentation models.\n\n---\n\nNotes:\n    - All analysis is static; analyzed modules are never executed.\n    - Private members (names starting with `_`) are skipped during conversion.\n\n---",
+    "docstring": "# Summary\n\nUtilities for loading and introspecting Python modules using Griffe.\n\nThis module provides the `GriffeLoader` class and helper utilities used to\ndiscover Python modules, introspect their structure, and convert the results\ninto doc-forge documentation models.\n\n---\n\nNotes:\n    - All analysis is static; analyzed modules are never executed.\n    - Private members (names starting with `_`) are skipped during conversion.\n    - Imported aliases that cannot be resolved (stdlib/third-party names) are\n      skipped; aliases that resolve within the documented project are kept.\n\n---",
     "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
-      },
-      "AliasResolutionError": {
-        "name": "AliasResolutionError",
-        "kind": "alias",
-        "path": "docforge.loaders.griffe_loader.AliasResolutionError",
-        "signature": "<bound method Alias.signature of Alias('AliasResolutionError', 'griffe.AliasResolutionError')>",
-        "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
-      },
-      "ModulesCollection": {
-        "name": "ModulesCollection",
-        "kind": "alias",
-        "path": "docforge.loaders.griffe_loader.ModulesCollection",
-        "signature": "<bound method Alias.signature of Alias('ModulesCollection', 'griffe.ModulesCollection')>",
-        "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
-      },
       "DocObject": {
         "name": "DocObject",
         "kind": "class",
         "path": "docforge.loaders.griffe_loader.DocObject",
-        "signature": "<bound method Alias.signature of Alias('DocObject', 'docforge.models.DocObject')>",
+        "signature": "DocObject(name: str, kind: str, path: str, signature: str | None = None, docstring: str | None = None)",
         "docstring": "Representation of a documented Python object.\n\nA `DocObject` models a single Python entity discovered during\nintrospection. Objects may contain nested members, allowing the structure\nof modules, classes, and other containers to be represented recursively.\n\nAttributes:\n    name (str):\n        Local name of the object.\n\n    kind (str):\n        Type of object (for example `class`, `function`, `method`, or `attribute`).\n\n    path (str):\n        Fully qualified dotted path to the object.\n\n    signature (str | None):\n        Callable signature if the object represents a callable.\n\n    docstring (str | None):\n        Raw docstring text extracted from the source code.\n\n    members (dict[str, DocObject]):\n        Mapping of member names to child `DocObject` instances.",
         "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "add_member(obj: DocObject)",
             "docstring": "Add a child documentation object.\n\nThis is typically used when attaching methods to classes or\nnested objects to their parent containers.\n\nArgs:\n    obj (DocObject):\n        Documentation object to add as a member."
           },
           "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')>",
+            "signature": "get_member(name: str)",
             "docstring": "Retrieve a member object by name.\n\nArgs:\n    name (str):\n        Name of the member to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If the member does not exist."
           },
           "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')>",
+            "signature": "get_all_members()",
             "docstring": "Return all child members of the object.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing nested members."
           }
         }
@@ -122,49 +80,49 @@
         "name": "Module",
         "kind": "class",
         "path": "docforge.loaders.griffe_loader.Module",
-        "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.Module')>",
+        "signature": "Module(path: str, docstring: str | None = None)",
         "docstring": "Representation of a documented Python module or package.\n\nA `Module` stores metadata about the module itself and maintains a\ncollection of top-level documentation objects discovered during\nintrospection.\n\nAttributes:\n    path (str):\n        Dotted import path of the module.\n\n    docstring (str | None):\n        Module-level documentation string, if present.\n\n    members (dict[str, DocObject]):\n        Mapping of object names to their corresponding `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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "add_object(obj: DocObject)",
             "docstring": "Add a documented object to the module.\n\nArgs:\n    obj (DocObject):\n        Documentation object to register as a top-level member of the module."
           },
           "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')>",
+            "signature": "get_object(name: str)",
             "docstring": "Retrieve a documented object by name.\n\nArgs:\n    name (str):\n        Name of the object to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If no object with the given name exists."
           },
           "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')>",
+            "signature": "get_all_objects()",
             "docstring": "Return all top-level documentation objects in the module.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing the module's public members."
           }
         }
@@ -173,49 +131,49 @@
         "name": "Project",
         "kind": "class",
         "path": "docforge.loaders.griffe_loader.Project",
-        "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.Project')>",
+        "signature": "Project(name: str)",
         "docstring": "Representation of a documentation project.\n\nA `Project` serves as the root container for all modules discovered during\nintrospection. Each module is stored by its dotted import path.\n\nAttributes:\n    name (str):\n        Name of the project.\n\n    modules (dict[str, Module]):\n        Mapping of 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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "add_module(module: Module)",
             "docstring": "Register a module in the project.\n\nArgs:\n    module (Module):\n        Module instance to add to the project."
           },
           "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')>",
+            "signature": "get_module(path: str)",
             "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path (str):\n        Fully qualified dotted module path (for example `pkg.module`).\n\nReturns:\n    Module:\n        The corresponding `Module` instance.\n\nRaises:\n    KeyError:\n        If the module does not exist in the project."
           },
           "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')>",
+            "signature": "get_all_modules()",
             "docstring": "Return all modules contained in the project.\n\nReturns:\n    Iterable[Module]:\n        An iterable of `Module` instances."
           },
           "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')>",
+            "signature": "get_module_list()",
             "docstring": "Return the list of module import paths.\n\nReturns:\n    list[str]:\n        A list containing the dotted paths of all modules in the project."
           }
         }
@@ -231,28 +189,28 @@
         "name": "discover_module_paths",
         "kind": "function",
         "path": "docforge.loaders.griffe_loader.discover_module_paths",
-        "signature": "<bound method Function.signature of Function('discover_module_paths', 37, 89)>",
+        "signature": "discover_module_paths(module_name: str, project_root: Path | None = None) -> list[str]",
         "docstring": "Discover Python modules within a package directory.\n\nThe function scans the filesystem for `.py` files inside the specified\npackage and converts them into dotted module import paths.\n\nDiscovery rules:\n\n- Directories containing `__init__.py` are treated as packages.\n- Each `.py` file is treated as a module.\n- Results are returned as dotted import paths.\n\nArgs:\n    module_name (str):\n        Top-level package name to discover modules from.\n\n    project_root (Path | None):\n        Root directory used to resolve module paths. If not provided, the\n        current working directory is used.\n\nReturns:\n    list[str]:\n        A sorted list of unique dotted module import paths.\n\nRaises:\n    FileNotFoundError:\n        If the specified package directory does not exist."
       },
       "GriffeLoader": {
         "name": "GriffeLoader",
         "kind": "class",
         "path": "docforge.loaders.griffe_loader.GriffeLoader",
-        "signature": "<bound method Class.signature of Class('GriffeLoader', 92, 315)>",
+        "signature": "GriffeLoader()",
         "docstring": "Load Python modules using Griffe and convert them into doc-forge models.\n\nThis loader uses the Griffe introspection engine to analyze Python source\ncode and transform the extracted information into `Project`, `Module`,\nand `DocObject` instances used by doc-forge.\n\nAttributes:\n    _loader (_GriffeLoader):\n        Internal Griffe loader with dedicated module and line collections.",
         "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', 117, 171)>",
+            "signature": "load_project(module_paths: list[str], project_name: str | None = None, skip_import_errors: bool | None = None) -> Project",
             "docstring": "Load multiple modules and assemble them into a Project model.\n\nEach module path is introspected and converted into a `Module`\ninstance. All modules are then aggregated into a single `Project`\nobject.\n\nArgs:\n    module_paths (list[str]):\n        List of dotted module import paths to load.\n\n    project_name (str | None):\n        Optional override for the project name. Defaults to the top-level\n        name of the first module.\n\n    skip_import_errors (bool | None):\n        If True, modules that fail to load will be skipped instead of raising an error.\n\nReturns:\n    Project:\n        A populated `Project` instance containing the loaded modules.\n\nRaises:\n    ValueError:\n        If no module paths are provided.\n\n    ImportError:\n        If a module fails to load and `skip_import_errors` is False."
           },
           "load_module": {
             "name": "load_module",
             "kind": "function",
             "path": "docforge.loaders.griffe_loader.GriffeLoader.load_module",
-            "signature": "<bound method Function.signature of Function('load_module', 173, 206)>",
+            "signature": "load_module(path: str) -> Module",
             "docstring": "Load and convert a single Python module.\n\nThe module is introspected using Griffe and then transformed into\na doc-forge `Module` model.\n\nArgs:\n    path (str):\n        Dotted import path of the module.\n\nReturns:\n    Module:\n        A populated `Module` instance.\n\nRaises:\n    ImportError:\n        If the module cannot be loaded by Griffe.\n\n    KeyError:\n        If the loaded module is missing from the module collection.\n\nExample:\n    Load a single module:\n\n        ```python\n        loader = GriffeLoader()\n        module = loader.load_module(\"mypackage.submodule\")\n        ```"
           }
         }

docs/mcp/modules/docforge.loaders.json

@@ -8,21 +8,21 @@
         "name": "GriffeLoader",
         "kind": "class",
         "path": "docforge.loaders.GriffeLoader",
-        "signature": "<bound method Alias.signature of Alias('GriffeLoader', 'docforge.loaders.griffe_loader.GriffeLoader')>",
+        "signature": "GriffeLoader()",
         "docstring": "Load Python modules using Griffe and convert them into doc-forge models.\n\nThis loader uses the Griffe introspection engine to analyze Python source\ncode and transform the extracted information into `Project`, `Module`,\nand `DocObject` instances used by doc-forge.\n\nAttributes:\n    _loader (_GriffeLoader):\n        Internal Griffe loader with dedicated module and line collections.",
         "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')>",
+            "signature": "load_project(module_paths: list[str], project_name: str | None = None, skip_import_errors: bool | None = None)",
             "docstring": "Load multiple modules and assemble them into a Project model.\n\nEach module path is introspected and converted into a `Module`\ninstance. All modules are then aggregated into a single `Project`\nobject.\n\nArgs:\n    module_paths (list[str]):\n        List of dotted module import paths to load.\n\n    project_name (str | None):\n        Optional override for the project name. Defaults to the top-level\n        name of the first module.\n\n    skip_import_errors (bool | None):\n        If True, modules that fail to load will be skipped instead of raising an error.\n\nReturns:\n    Project:\n        A populated `Project` instance containing the loaded modules.\n\nRaises:\n    ValueError:\n        If no module paths are provided.\n\n    ImportError:\n        If a module fails to load and `skip_import_errors` is False."
           },
           "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')>",
+            "signature": "load_module(path: str)",
             "docstring": "Load and convert a single Python module.\n\nThe module is introspected using Griffe and then transformed into\na doc-forge `Module` model.\n\nArgs:\n    path (str):\n        Dotted import path of the module.\n\nReturns:\n    Module:\n        A populated `Module` instance.\n\nRaises:\n    ImportError:\n        If the module cannot be loaded by Griffe.\n\n    KeyError:\n        If the loaded module is missing from the module collection.\n\nExample:\n    Load a single module:\n\n        ```python\n        loader = GriffeLoader()\n        module = loader.load_module(\"mypackage.submodule\")\n        ```"
           }
         }
@@ -31,7 +31,7 @@
         "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')>",
+        "signature": "discover_module_paths(module_name: str, project_root: Path | None = None)",
         "docstring": "Discover Python modules within a package directory.\n\nThe function scans the filesystem for `.py` files inside the specified\npackage and converts them into dotted module import paths.\n\nDiscovery rules:\n\n- Directories containing `__init__.py` are treated as packages.\n- Each `.py` file is treated as a module.\n- Results are returned as dotted import paths.\n\nArgs:\n    module_name (str):\n        Top-level package name to discover modules from.\n\n    project_root (Path | None):\n        Root directory used to resolve module paths. If not provided, the\n        current working directory is used.\n\nReturns:\n    list[str]:\n        A sorted list of unique dotted module import paths.\n\nRaises:\n    FileNotFoundError:\n        If the specified package directory does not exist."
       },
       "griffe_loader": {
@@ -39,118 +39,76 @@
         "kind": "module",
         "path": "docforge.loaders.griffe_loader",
         "signature": null,
-        "docstring": "# Summary\n\nUtilities for loading and introspecting Python modules using Griffe.\n\nThis module provides the `GriffeLoader` class and helper utilities used to\ndiscover Python modules, introspect their structure, and convert the results\ninto doc-forge documentation models.\n\n---\n\nNotes:\n    - All analysis is static; analyzed modules are never executed.\n    - Private members (names starting with `_`) are skipped during conversion.\n\n---",
+        "docstring": "# Summary\n\nUtilities for loading and introspecting Python modules using Griffe.\n\nThis module provides the `GriffeLoader` class and helper utilities used to\ndiscover Python modules, introspect their structure, and convert the results\ninto doc-forge documentation models.\n\n---\n\nNotes:\n    - All analysis is static; analyzed modules are never executed.\n    - Private members (names starting with `_`) are skipped during conversion.\n    - Imported aliases that cannot be resolved (stdlib/third-party names) are\n      skipped; aliases that resolve within the documented project are kept.\n\n---",
         "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
-          },
-          "AliasResolutionError": {
-            "name": "AliasResolutionError",
-            "kind": "alias",
-            "path": "docforge.loaders.griffe_loader.AliasResolutionError",
-            "signature": "<bound method Alias.signature of Alias('AliasResolutionError', 'griffe.AliasResolutionError')>",
-            "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
-          },
-          "ModulesCollection": {
-            "name": "ModulesCollection",
-            "kind": "alias",
-            "path": "docforge.loaders.griffe_loader.ModulesCollection",
-            "signature": "<bound method Alias.signature of Alias('ModulesCollection', 'griffe.ModulesCollection')>",
-            "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
-          },
           "DocObject": {
             "name": "DocObject",
             "kind": "class",
             "path": "docforge.loaders.griffe_loader.DocObject",
-            "signature": "<bound method Alias.signature of Alias('DocObject', 'docforge.models.DocObject')>",
+            "signature": "DocObject(name: str, kind: str, path: str, signature: str | None = None, docstring: str | None = None)",
             "docstring": "Representation of a documented Python object.\n\nA `DocObject` models a single Python entity discovered during\nintrospection. Objects may contain nested members, allowing the structure\nof modules, classes, and other containers to be represented recursively.\n\nAttributes:\n    name (str):\n        Local name of the object.\n\n    kind (str):\n        Type of object (for example `class`, `function`, `method`, or `attribute`).\n\n    path (str):\n        Fully qualified dotted path to the object.\n\n    signature (str | None):\n        Callable signature if the object represents a callable.\n\n    docstring (str | None):\n        Raw docstring text extracted from the source code.\n\n    members (dict[str, DocObject]):\n        Mapping of member names to child `DocObject` instances.",
             "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": "add_member(obj: DocObject)",
                 "docstring": "Add a child documentation object.\n\nThis is typically used when attaching methods to classes or\nnested objects to their parent containers.\n\nArgs:\n    obj (DocObject):\n        Documentation object to add as a member."
               },
               "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')>",
+                "signature": "get_member(name: str)",
                 "docstring": "Retrieve a member object by name.\n\nArgs:\n    name (str):\n        Name of the member to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If the member does not exist."
               },
               "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')>",
+                "signature": "get_all_members()",
                 "docstring": "Return all child members of the object.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing nested members."
               }
             }
@@ -159,49 +117,49 @@
             "name": "Module",
             "kind": "class",
             "path": "docforge.loaders.griffe_loader.Module",
-            "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.Module')>",
+            "signature": "Module(path: str, docstring: str | None = None)",
             "docstring": "Representation of a documented Python module or package.\n\nA `Module` stores metadata about the module itself and maintains a\ncollection of top-level documentation objects discovered during\nintrospection.\n\nAttributes:\n    path (str):\n        Dotted import path of the module.\n\n    docstring (str | None):\n        Module-level documentation string, if present.\n\n    members (dict[str, DocObject]):\n        Mapping of object names to their corresponding `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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": "add_object(obj: DocObject)",
                 "docstring": "Add a documented object to the module.\n\nArgs:\n    obj (DocObject):\n        Documentation object to register as a top-level member of the module."
               },
               "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')>",
+                "signature": "get_object(name: str)",
                 "docstring": "Retrieve a documented object by name.\n\nArgs:\n    name (str):\n        Name of the object to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If no object with the given name exists."
               },
               "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')>",
+                "signature": "get_all_objects()",
                 "docstring": "Return all top-level documentation objects in the module.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing the module's public members."
               }
             }
@@ -210,49 +168,49 @@
             "name": "Project",
             "kind": "class",
             "path": "docforge.loaders.griffe_loader.Project",
-            "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.Project')>",
+            "signature": "Project(name: str)",
             "docstring": "Representation of a documentation project.\n\nA `Project` serves as the root container for all modules discovered during\nintrospection. Each module is stored by its dotted import path.\n\nAttributes:\n    name (str):\n        Name of the project.\n\n    modules (dict[str, Module]):\n        Mapping of 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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": "add_module(module: Module)",
                 "docstring": "Register a module in the project.\n\nArgs:\n    module (Module):\n        Module instance to add to the project."
               },
               "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')>",
+                "signature": "get_module(path: str)",
                 "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path (str):\n        Fully qualified dotted module path (for example `pkg.module`).\n\nReturns:\n    Module:\n        The corresponding `Module` instance.\n\nRaises:\n    KeyError:\n        If the module does not exist in the project."
               },
               "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')>",
+                "signature": "get_all_modules()",
                 "docstring": "Return all modules contained in the project.\n\nReturns:\n    Iterable[Module]:\n        An iterable of `Module` instances."
               },
               "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')>",
+                "signature": "get_module_list()",
                 "docstring": "Return the list of module import paths.\n\nReturns:\n    list[str]:\n        A list containing the dotted paths of all modules in the project."
               }
             }
@@ -268,28 +226,28 @@
             "name": "discover_module_paths",
             "kind": "function",
             "path": "docforge.loaders.griffe_loader.discover_module_paths",
-            "signature": "<bound method Function.signature of Function('discover_module_paths', 37, 89)>",
+            "signature": "discover_module_paths(module_name: str, project_root: Path | None = None) -> list[str]",
             "docstring": "Discover Python modules within a package directory.\n\nThe function scans the filesystem for `.py` files inside the specified\npackage and converts them into dotted module import paths.\n\nDiscovery rules:\n\n- Directories containing `__init__.py` are treated as packages.\n- Each `.py` file is treated as a module.\n- Results are returned as dotted import paths.\n\nArgs:\n    module_name (str):\n        Top-level package name to discover modules from.\n\n    project_root (Path | None):\n        Root directory used to resolve module paths. If not provided, the\n        current working directory is used.\n\nReturns:\n    list[str]:\n        A sorted list of unique dotted module import paths.\n\nRaises:\n    FileNotFoundError:\n        If the specified package directory does not exist."
           },
           "GriffeLoader": {
             "name": "GriffeLoader",
             "kind": "class",
             "path": "docforge.loaders.griffe_loader.GriffeLoader",
-            "signature": "<bound method Class.signature of Class('GriffeLoader', 92, 315)>",
+            "signature": "GriffeLoader()",
             "docstring": "Load Python modules using Griffe and convert them into doc-forge models.\n\nThis loader uses the Griffe introspection engine to analyze Python source\ncode and transform the extracted information into `Project`, `Module`,\nand `DocObject` instances used by doc-forge.\n\nAttributes:\n    _loader (_GriffeLoader):\n        Internal Griffe loader with dedicated module and line collections.",
             "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', 117, 171)>",
+                "signature": "load_project(module_paths: list[str], project_name: str | None = None, skip_import_errors: bool | None = None) -> Project",
                 "docstring": "Load multiple modules and assemble them into a Project model.\n\nEach module path is introspected and converted into a `Module`\ninstance. All modules are then aggregated into a single `Project`\nobject.\n\nArgs:\n    module_paths (list[str]):\n        List of dotted module import paths to load.\n\n    project_name (str | None):\n        Optional override for the project name. Defaults to the top-level\n        name of the first module.\n\n    skip_import_errors (bool | None):\n        If True, modules that fail to load will be skipped instead of raising an error.\n\nReturns:\n    Project:\n        A populated `Project` instance containing the loaded modules.\n\nRaises:\n    ValueError:\n        If no module paths are provided.\n\n    ImportError:\n        If a module fails to load and `skip_import_errors` is False."
               },
               "load_module": {
                 "name": "load_module",
                 "kind": "function",
                 "path": "docforge.loaders.griffe_loader.GriffeLoader.load_module",
-                "signature": "<bound method Function.signature of Function('load_module', 173, 206)>",
+                "signature": "load_module(path: str) -> Module",
                 "docstring": "Load and convert a single Python module.\n\nThe module is introspected using Griffe and then transformed into\na doc-forge `Module` model.\n\nArgs:\n    path (str):\n        Dotted import path of the module.\n\nReturns:\n    Module:\n        A populated `Module` instance.\n\nRaises:\n    ImportError:\n        If the module cannot be loaded by Griffe.\n\n    KeyError:\n        If the loaded module is missing from the module collection.\n\nExample:\n    Load a single module:\n\n        ```python\n        loader = GriffeLoader()\n        module = loader.load_module(\"mypackage.submodule\")\n        ```"
               }
             }

docs/mcp/modules/docforge.models.json

@@ -8,49 +8,49 @@
         "name": "Project",
         "kind": "class",
         "path": "docforge.models.Project",
-        "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.project.Project')>",
+        "signature": "Project(name: str)",
         "docstring": "Representation of a documentation project.\n\nA `Project` serves as the root container for all modules discovered during\nintrospection. Each module is stored by its dotted import path.\n\nAttributes:\n    name (str):\n        Name of the project.\n\n    modules (dict[str, Module]):\n        Mapping of 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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "add_module(module: Module)",
             "docstring": "Register a module in the project.\n\nArgs:\n    module (Module):\n        Module instance to add to the project."
           },
           "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')>",
+            "signature": "get_module(path: str)",
             "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path (str):\n        Fully qualified dotted module path (for example `pkg.module`).\n\nReturns:\n    Module:\n        The corresponding `Module` instance.\n\nRaises:\n    KeyError:\n        If the module does not exist in the project."
           },
           "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')>",
+            "signature": "get_all_modules()",
             "docstring": "Return all modules contained in the project.\n\nReturns:\n    Iterable[Module]:\n        An iterable of `Module` instances."
           },
           "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')>",
+            "signature": "get_module_list()",
             "docstring": "Return the list of module import paths.\n\nReturns:\n    list[str]:\n        A list containing the dotted paths of all modules in the project."
           }
         }
@@ -59,49 +59,49 @@
         "name": "Module",
         "kind": "class",
         "path": "docforge.models.Module",
-        "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.module.Module')>",
+        "signature": "Module(path: str, docstring: str | None = None)",
         "docstring": "Representation of a documented Python module or package.\n\nA `Module` stores metadata about the module itself and maintains a\ncollection of top-level documentation objects discovered during\nintrospection.\n\nAttributes:\n    path (str):\n        Dotted import path of the module.\n\n    docstring (str | None):\n        Module-level documentation string, if present.\n\n    members (dict[str, DocObject]):\n        Mapping of object names to their corresponding `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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "add_object(obj: DocObject)",
             "docstring": "Add a documented object to the module.\n\nArgs:\n    obj (DocObject):\n        Documentation object to register as a top-level member of the module."
           },
           "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')>",
+            "signature": "get_object(name: str)",
             "docstring": "Retrieve a documented object by name.\n\nArgs:\n    name (str):\n        Name of the object to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If no object with the given name exists."
           },
           "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')>",
+            "signature": "get_all_objects()",
             "docstring": "Return all top-level documentation objects in the module.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing the module's public members."
           }
         }
@@ -110,70 +110,70 @@
         "name": "DocObject",
         "kind": "class",
         "path": "docforge.models.DocObject",
-        "signature": "<bound method Alias.signature of Alias('DocObject', 'docforge.models.object.DocObject')>",
+        "signature": "DocObject(name: str, kind: str, path: str, signature: str | None = None, docstring: str | None = None)",
         "docstring": "Representation of a documented Python object.\n\nA `DocObject` models a single Python entity discovered during\nintrospection. Objects may contain nested members, allowing the structure\nof modules, classes, and other containers to be represented recursively.\n\nAttributes:\n    name (str):\n        Local name of the object.\n\n    kind (str):\n        Type of object (for example `class`, `function`, `method`, or `attribute`).\n\n    path (str):\n        Fully qualified dotted path to the object.\n\n    signature (str | None):\n        Callable signature if the object represents a callable.\n\n    docstring (str | None):\n        Raw docstring text extracted from the source code.\n\n    members (dict[str, DocObject]):\n        Mapping of member names to child `DocObject` instances.",
         "members": {
           "name": {
             "name": "name",
             "kind": "attribute",
             "path": "docforge.models.DocObject.name",
-            "signature": "<bound method Alias.signature of Alias('name', 'docforge.models.object.DocObject.name')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "add_member(obj: DocObject)",
             "docstring": "Add a child documentation object.\n\nThis is typically used when attaching methods to classes or\nnested objects to their parent containers.\n\nArgs:\n    obj (DocObject):\n        Documentation object to add as a member."
           },
           "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')>",
+            "signature": "get_member(name: str)",
             "docstring": "Retrieve a member object by name.\n\nArgs:\n    name (str):\n        Name of the member to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If the member does not exist."
           },
           "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')>",
+            "signature": "get_all_members()",
             "docstring": "Return all child members of the object.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing nested members."
           }
         }
@@ -185,81 +185,74 @@
         "signature": null,
         "docstring": "# Summary\n\nDocumentation model representing a Python module or package.\n\nThis module defines the `Module` class used in the doc-forge documentation\nmodel. A `Module` acts as a container for top-level documented objects\n(classes, functions, variables, and other members) discovered during\nintrospection.\n\n---\n\nNotes:\n    - Only public members are stored; private names are filtered by the loader.\n\n---",
         "members": {
-          "Iterable": {
-            "name": "Iterable",
-            "kind": "alias",
-            "path": "docforge.models.module.Iterable",
-            "signature": "<bound method Alias.signature of Alias('Iterable', 'collections.abc.Iterable')>",
-            "docstring": null
-          },
           "DocObject": {
             "name": "DocObject",
             "kind": "class",
             "path": "docforge.models.module.DocObject",
-            "signature": "<bound method Alias.signature of Alias('DocObject', 'docforge.models.object.DocObject')>",
+            "signature": "DocObject(name: str, kind: str, path: str, signature: str | None = None, docstring: str | None = None)",
             "docstring": "Representation of a documented Python object.\n\nA `DocObject` models a single Python entity discovered during\nintrospection. Objects may contain nested members, allowing the structure\nof modules, classes, and other containers to be represented recursively.\n\nAttributes:\n    name (str):\n        Local name of the object.\n\n    kind (str):\n        Type of object (for example `class`, `function`, `method`, or `attribute`).\n\n    path (str):\n        Fully qualified dotted path to the object.\n\n    signature (str | None):\n        Callable signature if the object represents a callable.\n\n    docstring (str | None):\n        Raw docstring text extracted from the source code.\n\n    members (dict[str, DocObject]):\n        Mapping of member names to child `DocObject` instances.",
             "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": "add_member(obj: DocObject)",
                 "docstring": "Add a child documentation object.\n\nThis is typically used when attaching methods to classes or\nnested objects to their parent containers.\n\nArgs:\n    obj (DocObject):\n        Documentation object to add as a member."
               },
               "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')>",
+                "signature": "get_member(name: str)",
                 "docstring": "Retrieve a member object by name.\n\nArgs:\n    name (str):\n        Name of the member to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If the member does not exist."
               },
               "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')>",
+                "signature": "get_all_members()",
                 "docstring": "Return all child members of the object.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing nested members."
               }
             }
@@ -268,7 +261,7 @@
             "name": "Module",
             "kind": "class",
             "path": "docforge.models.module.Module",
-            "signature": "<bound method Class.signature of Class('Module', 24, 98)>",
+            "signature": "Module(path: str, docstring: str | None = None)",
             "docstring": "Representation of a documented Python module or package.\n\nA `Module` stores metadata about the module itself and maintains a\ncollection of top-level documentation objects discovered during\nintrospection.\n\nAttributes:\n    path (str):\n        Dotted import path of the module.\n\n    docstring (str | None):\n        Module-level documentation string, if present.\n\n    members (dict[str, DocObject]):\n        Mapping of object names to their corresponding `DocObject` representations.",
             "members": {
               "path": {
@@ -296,21 +289,21 @@
                 "name": "add_object",
                 "kind": "function",
                 "path": "docforge.models.module.Module.add_object",
-                "signature": "<bound method Function.signature of Function('add_object', 62, 70)>",
+                "signature": "add_object(obj: DocObject) -> None",
                 "docstring": "Add a documented object to the module.\n\nArgs:\n    obj (DocObject):\n        Documentation object to register as a top-level member of the module."
               },
               "get_object": {
                 "name": "get_object",
                 "kind": "function",
                 "path": "docforge.models.module.Module.get_object",
-                "signature": "<bound method Function.signature of Function('get_object', 72, 88)>",
+                "signature": "get_object(name: str) -> DocObject",
                 "docstring": "Retrieve a documented object by name.\n\nArgs:\n    name (str):\n        Name of the object to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If no object with the given name exists."
               },
               "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', 90, 98)>",
+                "signature": "get_all_objects() -> Iterable[DocObject]",
                 "docstring": "Return all top-level documentation objects in the module.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing the module's public members."
               }
             }
@@ -324,18 +317,11 @@
         "signature": null,
         "docstring": "# Summary\n\nDocumentation model representing individual Python objects.\n\nThis module defines the `DocObject` class, the fundamental recursive unit of\nthe doc-forge documentation model. Each `DocObject` represents a Python\nentity such as a class, function, method, or attribute, and may contain nested\nmembers that form a hierarchical documentation structure.\n\n---\n\nNotes:\n    - `DocObject` instances form a tree mirroring the Python import hierarchy.\n    - Objects are renderer-agnostic and may be consumed by any renderer.\n\n---",
         "members": {
-          "Iterable": {
-            "name": "Iterable",
-            "kind": "alias",
-            "path": "docforge.models.object.Iterable",
-            "signature": "<bound method Alias.signature of Alias('Iterable', 'collections.abc.Iterable')>",
-            "docstring": null
-          },
           "DocObject": {
             "name": "DocObject",
             "kind": "class",
             "path": "docforge.models.object.DocObject",
-            "signature": "<bound method Class.signature of Class('DocObject', 23, 124)>",
+            "signature": "DocObject(name: str, kind: str, path: str, signature: str | None = None, docstring: str | None = None)",
             "docstring": "Representation of a documented Python object.\n\nA `DocObject` models a single Python entity discovered during\nintrospection. Objects may contain nested members, allowing the structure\nof modules, classes, and other containers to be represented recursively.\n\nAttributes:\n    name (str):\n        Local name of the object.\n\n    kind (str):\n        Type of object (for example `class`, `function`, `method`, or `attribute`).\n\n    path (str):\n        Fully qualified dotted path to the object.\n\n    signature (str | None):\n        Callable signature if the object represents a callable.\n\n    docstring (str | None):\n        Raw docstring text extracted from the source code.\n\n    members (dict[str, DocObject]):\n        Mapping of member names to child `DocObject` instances.",
             "members": {
               "name": {
@@ -384,21 +370,21 @@
                 "name": "add_member",
                 "kind": "function",
                 "path": "docforge.models.object.DocObject.add_member",
-                "signature": "<bound method Function.signature of Function('add_member', 85, 96)>",
+                "signature": "add_member(obj: DocObject) -> None",
                 "docstring": "Add a child documentation object.\n\nThis is typically used when attaching methods to classes or\nnested objects to their parent containers.\n\nArgs:\n    obj (DocObject):\n        Documentation object to add as a member."
               },
               "get_member": {
                 "name": "get_member",
                 "kind": "function",
                 "path": "docforge.models.object.DocObject.get_member",
-                "signature": "<bound method Function.signature of Function('get_member', 98, 114)>",
+                "signature": "get_member(name: str) -> DocObject",
                 "docstring": "Retrieve a member object by name.\n\nArgs:\n    name (str):\n        Name of the member to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If the member does not exist."
               },
               "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', 116, 124)>",
+                "signature": "get_all_members() -> Iterable[DocObject]",
                 "docstring": "Return all child members of the object.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing nested members."
               }
             }
@@ -412,60 +398,53 @@
         "signature": null,
         "docstring": "# Summary\n\nDocumentation model representing a project.\n\nThis module defines the `Project` class, the top-level container used by\ndoc-forge to represent a documented codebase. A `Project` aggregates multiple\nmodules and provides access to them through a unified interface.\n\n---\n\nNotes:\n    - Modules are keyed by their dotted import path.\n    - Objects are renderer-agnostic; the same model feeds every renderer.\n\n---",
         "members": {
-          "Iterable": {
-            "name": "Iterable",
-            "kind": "alias",
-            "path": "docforge.models.project.Iterable",
-            "signature": "<bound method Alias.signature of Alias('Iterable', 'collections.abc.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')>",
+            "signature": "Module(path: str, docstring: str | None = None)",
             "docstring": "Representation of a documented Python module or package.\n\nA `Module` stores metadata about the module itself and maintains a\ncollection of top-level documentation objects discovered during\nintrospection.\n\nAttributes:\n    path (str):\n        Dotted import path of the module.\n\n    docstring (str | None):\n        Module-level documentation string, if present.\n\n    members (dict[str, DocObject]):\n        Mapping of object names to their corresponding `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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": "add_object(obj: DocObject)",
                 "docstring": "Add a documented object to the module.\n\nArgs:\n    obj (DocObject):\n        Documentation object to register as a top-level member of the module."
               },
               "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')>",
+                "signature": "get_object(name: str)",
                 "docstring": "Retrieve a documented object by name.\n\nArgs:\n    name (str):\n        Name of the object to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If no object with the given name exists."
               },
               "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')>",
+                "signature": "get_all_objects()",
                 "docstring": "Return all top-level documentation objects in the module.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing the module's public members."
               }
             }
@@ -474,7 +453,7 @@
             "name": "Project",
             "kind": "class",
             "path": "docforge.models.project.Project",
-            "signature": "<bound method Class.signature of Class('Project', 24, 104)>",
+            "signature": "Project(name: str)",
             "docstring": "Representation of a documentation project.\n\nA `Project` serves as the root container for all modules discovered during\nintrospection. Each module is stored by its dotted import path.\n\nAttributes:\n    name (str):\n        Name of the project.\n\n    modules (dict[str, Module]):\n        Mapping of module paths to `Module` instances.",
             "members": {
               "name": {
@@ -495,28 +474,28 @@
                 "name": "add_module",
                 "kind": "function",
                 "path": "docforge.models.project.Project.add_module",
-                "signature": "<bound method Function.signature of Function('add_module', 58, 66)>",
+                "signature": "add_module(module: Module) -> None",
                 "docstring": "Register a module in the project.\n\nArgs:\n    module (Module):\n        Module instance to add to the project."
               },
               "get_module": {
                 "name": "get_module",
                 "kind": "function",
                 "path": "docforge.models.project.Project.get_module",
-                "signature": "<bound method Function.signature of Function('get_module', 68, 84)>",
+                "signature": "get_module(path: str) -> Module",
                 "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path (str):\n        Fully qualified dotted module path (for example `pkg.module`).\n\nReturns:\n    Module:\n        The corresponding `Module` instance.\n\nRaises:\n    KeyError:\n        If the module does not exist in the project."
               },
               "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', 86, 94)>",
+                "signature": "get_all_modules() -> Iterable[Module]",
                 "docstring": "Return all modules contained in the project.\n\nReturns:\n    Iterable[Module]:\n        An iterable of `Module` instances."
               },
               "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', 96, 104)>",
+                "signature": "get_module_list() -> list[str]",
                 "docstring": "Return the list of module import paths.\n\nReturns:\n    list[str]:\n        A list containing the dotted paths of all modules in the project."
               }
             }

docs/mcp/modules/docforge.models.module.json

@@ -4,81 +4,74 @@
     "path": "docforge.models.module",
     "docstring": "# Summary\n\nDocumentation model representing a Python module or package.\n\nThis module defines the `Module` class used in the doc-forge documentation\nmodel. A `Module` acts as a container for top-level documented objects\n(classes, functions, variables, and other members) discovered during\nintrospection.\n\n---\n\nNotes:\n    - Only public members are stored; private names are filtered by the loader.\n\n---",
     "objects": {
-      "Iterable": {
-        "name": "Iterable",
-        "kind": "alias",
-        "path": "docforge.models.module.Iterable",
-        "signature": "<bound method Alias.signature of Alias('Iterable', 'collections.abc.Iterable')>",
-        "docstring": null
-      },
       "DocObject": {
         "name": "DocObject",
         "kind": "class",
         "path": "docforge.models.module.DocObject",
-        "signature": "<bound method Alias.signature of Alias('DocObject', 'docforge.models.object.DocObject')>",
+        "signature": "DocObject(name: str, kind: str, path: str, signature: str | None = None, docstring: str | None = None)",
         "docstring": "Representation of a documented Python object.\n\nA `DocObject` models a single Python entity discovered during\nintrospection. Objects may contain nested members, allowing the structure\nof modules, classes, and other containers to be represented recursively.\n\nAttributes:\n    name (str):\n        Local name of the object.\n\n    kind (str):\n        Type of object (for example `class`, `function`, `method`, or `attribute`).\n\n    path (str):\n        Fully qualified dotted path to the object.\n\n    signature (str | None):\n        Callable signature if the object represents a callable.\n\n    docstring (str | None):\n        Raw docstring text extracted from the source code.\n\n    members (dict[str, DocObject]):\n        Mapping of member names to child `DocObject` instances.",
         "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "add_member(obj: DocObject)",
             "docstring": "Add a child documentation object.\n\nThis is typically used when attaching methods to classes or\nnested objects to their parent containers.\n\nArgs:\n    obj (DocObject):\n        Documentation object to add as a member."
           },
           "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')>",
+            "signature": "get_member(name: str)",
             "docstring": "Retrieve a member object by name.\n\nArgs:\n    name (str):\n        Name of the member to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If the member does not exist."
           },
           "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')>",
+            "signature": "get_all_members()",
             "docstring": "Return all child members of the object.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing nested members."
           }
         }
@@ -87,7 +80,7 @@
         "name": "Module",
         "kind": "class",
         "path": "docforge.models.module.Module",
-        "signature": "<bound method Class.signature of Class('Module', 24, 98)>",
+        "signature": "Module(path: str, docstring: str | None = None)",
         "docstring": "Representation of a documented Python module or package.\n\nA `Module` stores metadata about the module itself and maintains a\ncollection of top-level documentation objects discovered during\nintrospection.\n\nAttributes:\n    path (str):\n        Dotted import path of the module.\n\n    docstring (str | None):\n        Module-level documentation string, if present.\n\n    members (dict[str, DocObject]):\n        Mapping of object names to their corresponding `DocObject` representations.",
         "members": {
           "path": {
@@ -115,21 +108,21 @@
             "name": "add_object",
             "kind": "function",
             "path": "docforge.models.module.Module.add_object",
-            "signature": "<bound method Function.signature of Function('add_object', 62, 70)>",
+            "signature": "add_object(obj: DocObject) -> None",
             "docstring": "Add a documented object to the module.\n\nArgs:\n    obj (DocObject):\n        Documentation object to register as a top-level member of the module."
           },
           "get_object": {
             "name": "get_object",
             "kind": "function",
             "path": "docforge.models.module.Module.get_object",
-            "signature": "<bound method Function.signature of Function('get_object', 72, 88)>",
+            "signature": "get_object(name: str) -> DocObject",
             "docstring": "Retrieve a documented object by name.\n\nArgs:\n    name (str):\n        Name of the object to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If no object with the given name exists."
           },
           "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', 90, 98)>",
+            "signature": "get_all_objects() -> Iterable[DocObject]",
             "docstring": "Return all top-level documentation objects in the module.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing the module's public members."
           }
         }

docs/mcp/modules/docforge.models.object.json

@@ -4,18 +4,11 @@
     "path": "docforge.models.object",
     "docstring": "# Summary\n\nDocumentation model representing individual Python objects.\n\nThis module defines the `DocObject` class, the fundamental recursive unit of\nthe doc-forge documentation model. Each `DocObject` represents a Python\nentity such as a class, function, method, or attribute, and may contain nested\nmembers that form a hierarchical documentation structure.\n\n---\n\nNotes:\n    - `DocObject` instances form a tree mirroring the Python import hierarchy.\n    - Objects are renderer-agnostic and may be consumed by any renderer.\n\n---",
     "objects": {
-      "Iterable": {
-        "name": "Iterable",
-        "kind": "alias",
-        "path": "docforge.models.object.Iterable",
-        "signature": "<bound method Alias.signature of Alias('Iterable', 'collections.abc.Iterable')>",
-        "docstring": null
-      },
       "DocObject": {
         "name": "DocObject",
         "kind": "class",
         "path": "docforge.models.object.DocObject",
-        "signature": "<bound method Class.signature of Class('DocObject', 23, 124)>",
+        "signature": "DocObject(name: str, kind: str, path: str, signature: str | None = None, docstring: str | None = None)",
         "docstring": "Representation of a documented Python object.\n\nA `DocObject` models a single Python entity discovered during\nintrospection. Objects may contain nested members, allowing the structure\nof modules, classes, and other containers to be represented recursively.\n\nAttributes:\n    name (str):\n        Local name of the object.\n\n    kind (str):\n        Type of object (for example `class`, `function`, `method`, or `attribute`).\n\n    path (str):\n        Fully qualified dotted path to the object.\n\n    signature (str | None):\n        Callable signature if the object represents a callable.\n\n    docstring (str | None):\n        Raw docstring text extracted from the source code.\n\n    members (dict[str, DocObject]):\n        Mapping of member names to child `DocObject` instances.",
         "members": {
           "name": {
@@ -64,21 +57,21 @@
             "name": "add_member",
             "kind": "function",
             "path": "docforge.models.object.DocObject.add_member",
-            "signature": "<bound method Function.signature of Function('add_member', 85, 96)>",
+            "signature": "add_member(obj: DocObject) -> None",
             "docstring": "Add a child documentation object.\n\nThis is typically used when attaching methods to classes or\nnested objects to their parent containers.\n\nArgs:\n    obj (DocObject):\n        Documentation object to add as a member."
           },
           "get_member": {
             "name": "get_member",
             "kind": "function",
             "path": "docforge.models.object.DocObject.get_member",
-            "signature": "<bound method Function.signature of Function('get_member', 98, 114)>",
+            "signature": "get_member(name: str) -> DocObject",
             "docstring": "Retrieve a member object by name.\n\nArgs:\n    name (str):\n        Name of the member to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If the member does not exist."
           },
           "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', 116, 124)>",
+            "signature": "get_all_members() -> Iterable[DocObject]",
             "docstring": "Return all child members of the object.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing nested members."
           }
         }

docs/mcp/modules/docforge.models.project.json

@@ -4,60 +4,53 @@
     "path": "docforge.models.project",
     "docstring": "# Summary\n\nDocumentation model representing a project.\n\nThis module defines the `Project` class, the top-level container used by\ndoc-forge to represent a documented codebase. A `Project` aggregates multiple\nmodules and provides access to them through a unified interface.\n\n---\n\nNotes:\n    - Modules are keyed by their dotted import path.\n    - Objects are renderer-agnostic; the same model feeds every renderer.\n\n---",
     "objects": {
-      "Iterable": {
-        "name": "Iterable",
-        "kind": "alias",
-        "path": "docforge.models.project.Iterable",
-        "signature": "<bound method Alias.signature of Alias('Iterable', 'collections.abc.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')>",
+        "signature": "Module(path: str, docstring: str | None = None)",
         "docstring": "Representation of a documented Python module or package.\n\nA `Module` stores metadata about the module itself and maintains a\ncollection of top-level documentation objects discovered during\nintrospection.\n\nAttributes:\n    path (str):\n        Dotted import path of the module.\n\n    docstring (str | None):\n        Module-level documentation string, if present.\n\n    members (dict[str, DocObject]):\n        Mapping of object names to their corresponding `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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "add_object(obj: DocObject)",
             "docstring": "Add a documented object to the module.\n\nArgs:\n    obj (DocObject):\n        Documentation object to register as a top-level member of the module."
           },
           "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')>",
+            "signature": "get_object(name: str)",
             "docstring": "Retrieve a documented object by name.\n\nArgs:\n    name (str):\n        Name of the object to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If no object with the given name exists."
           },
           "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')>",
+            "signature": "get_all_objects()",
             "docstring": "Return all top-level documentation objects in the module.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing the module's public members."
           }
         }
@@ -66,7 +59,7 @@
         "name": "Project",
         "kind": "class",
         "path": "docforge.models.project.Project",
-        "signature": "<bound method Class.signature of Class('Project', 24, 104)>",
+        "signature": "Project(name: str)",
         "docstring": "Representation of a documentation project.\n\nA `Project` serves as the root container for all modules discovered during\nintrospection. Each module is stored by its dotted import path.\n\nAttributes:\n    name (str):\n        Name of the project.\n\n    modules (dict[str, Module]):\n        Mapping of module paths to `Module` instances.",
         "members": {
           "name": {
@@ -87,28 +80,28 @@
             "name": "add_module",
             "kind": "function",
             "path": "docforge.models.project.Project.add_module",
-            "signature": "<bound method Function.signature of Function('add_module', 58, 66)>",
+            "signature": "add_module(module: Module) -> None",
             "docstring": "Register a module in the project.\n\nArgs:\n    module (Module):\n        Module instance to add to the project."
           },
           "get_module": {
             "name": "get_module",
             "kind": "function",
             "path": "docforge.models.project.Project.get_module",
-            "signature": "<bound method Function.signature of Function('get_module', 68, 84)>",
+            "signature": "get_module(path: str) -> Module",
             "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path (str):\n        Fully qualified dotted module path (for example `pkg.module`).\n\nReturns:\n    Module:\n        The corresponding `Module` instance.\n\nRaises:\n    KeyError:\n        If the module does not exist in the project."
           },
           "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', 86, 94)>",
+            "signature": "get_all_modules() -> Iterable[Module]",
             "docstring": "Return all modules contained in the project.\n\nReturns:\n    Iterable[Module]:\n        An iterable of `Module` instances."
           },
           "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', 96, 104)>",
+            "signature": "get_module_list() -> list[str]",
             "docstring": "Return the list of module import paths.\n\nReturns:\n    list[str]:\n        A list containing the dotted paths of all modules in the project."
           }
         }

docs/mcp/modules/docforge.nav.json

@@ -8,42 +8,42 @@
         "name": "NavSpec",
         "kind": "class",
         "path": "docforge.nav.NavSpec",
-        "signature": "<bound method Alias.signature of Alias('NavSpec', 'docforge.nav.spec.NavSpec')>",
+        "signature": "NavSpec(home: str | None, groups: dict[str, list[str]], icon: dict[str, str] | None = None)",
         "docstring": "Parsed representation of a navigation specification.\n\nA ``NavSpec`` describes the intended documentation navigation layout before\nit is resolved against the filesystem.\n\nAttributes:\n    home: Relative path to the documentation home page (for example\n        ``index.md``).\n    groups: Mapping of navigation group titles to lists of file patterns\n        or glob expressions.\n    icon: Optional mapping of theme icon entries (for example\n        ``{\"logo\": \"material/code-tags\"}``) injected into the MkDocs\n        theme as ``theme.icon``.",
         "members": {
           "home": {
             "name": "home",
             "kind": "attribute",
             "path": "docforge.nav.NavSpec.home",
-            "signature": "<bound method Alias.signature of Alias('home', 'docforge.nav.spec.NavSpec.home')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "docstring": null
           },
           "icon": {
             "name": "icon",
             "kind": "attribute",
             "path": "docforge.nav.NavSpec.icon",
-            "signature": "<bound method Alias.signature of Alias('icon', 'docforge.nav.spec.NavSpec.icon')>",
+            "signature": null,
             "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')>",
+            "signature": "load(path: Path)",
             "docstring": "Load a navigation specification from a YAML file.\n\nArgs:\n    path (Path):\n        Filesystem path to the navigation specification file.\n\nReturns:\n    NavSpec:\n        A ``NavSpec`` instance representing the parsed configuration.\n\nRaises:\n    FileNotFoundError: If the specified file does not exist.\n    ValueError: If the file contents are not a valid navigation\n        specification."
           },
           "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')>",
+            "signature": "all_patterns()",
             "docstring": "Return all path patterns referenced by the specification.\n\nReturns:\n    list[str]:\n        A list containing the home document (if defined) and all\n        group pattern entries."
           }
         }
@@ -52,35 +52,35 @@
         "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')>",
+        "signature": "load_nav_spec(path: Path)",
         "docstring": "Load a navigation specification file.\n\nThis helper function reads a YAML navigation file and constructs a\ncorresponding ``NavSpec`` instance.\n\nArgs:\n    path (Path):\n        Path to the navigation specification file.\n\nReturns:\n    NavSpec:\n        A ``NavSpec`` instance representing the parsed specification.\n\nRaises:\n    FileNotFoundError: If the specification file does not exist.\n    ValueError: If the YAML structure is invalid."
       },
       "ResolvedNav": {
         "name": "ResolvedNav",
         "kind": "class",
         "path": "docforge.nav.ResolvedNav",
-        "signature": "<bound method Alias.signature of Alias('ResolvedNav', 'docforge.nav.resolver.ResolvedNav')>",
+        "signature": "ResolvedNav(home: str | None, groups: dict[str, list[Path]], docs_root: Path | None = None)",
         "docstring": "Resolved navigation structure.\n\nA ``ResolvedNav`` represents navigation data after glob patterns have been\nexpanded and paths validated against the filesystem.\n\nAttributes:\n    home: Relative path to the documentation home page.\n    groups: Mapping of navigation group titles to lists of resolved\n        documentation file paths.",
         "members": {
           "home": {
             "name": "home",
             "kind": "attribute",
             "path": "docforge.nav.ResolvedNav.home",
-            "signature": "<bound method Alias.signature of Alias('home', 'docforge.nav.resolver.ResolvedNav.home')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "all_files()",
             "docstring": "Iterate over all files referenced by the navigation structure.\n\nYields:\n    Path:\n        A documentation file referenced by the navigation, including\n        the home page when defined.\n\nRaises:\n    RuntimeError: If the home page is defined but the documentation\n        root is not available for resolution."
           }
         }
@@ -89,21 +89,21 @@
         "name": "resolve_nav",
         "kind": "function",
         "path": "docforge.nav.resolve_nav",
-        "signature": "<bound method Alias.signature of Alias('resolve_nav', 'docforge.nav.resolver.resolve_nav')>",
+        "signature": "resolve_nav(spec: NavSpec, docs_root: Path)",
         "docstring": "Resolve a navigation specification against the filesystem.\n\nThe function expands glob patterns defined in a ``NavSpec`` and verifies\nthat referenced documentation files exist within the documentation root.\n\nArgs:\n    spec (NavSpec):\n        Navigation specification describing documentation layout.\n    docs_root (Path):\n        Root directory containing documentation Markdown files.\n\nReturns:\n    ResolvedNav:\n        A `ResolvedNav` instance containing validated navigation paths.\n\nRaises:\n    FileNotFoundError: If the documentation root does not exist or a\n        navigation pattern does not match any files."
       },
       "MkDocsNavEmitter": {
         "name": "MkDocsNavEmitter",
         "kind": "class",
         "path": "docforge.nav.MkDocsNavEmitter",
-        "signature": "<bound method Alias.signature of Alias('MkDocsNavEmitter', 'docforge.nav.mkdocs.MkDocsNavEmitter')>",
+        "signature": null,
         "docstring": "Emit MkDocs navigation structures from resolved navigation data.\n\nThe emitter transforms a ``ResolvedNav`` object into the YAML-compatible\nlist structure expected by the MkDocs ``nav`` configuration field.",
         "members": {
           "emit": {
             "name": "emit",
             "kind": "function",
             "path": "docforge.nav.MkDocsNavEmitter.emit",
-            "signature": "<bound method Alias.signature of Alias('emit', 'docforge.nav.mkdocs.MkDocsNavEmitter.emit')>",
+            "signature": "emit(nav: ResolvedNav)",
             "docstring": "Generate a navigation structure for ``mkdocs.yml``.\n\nArgs:\n    nav (ResolvedNav):\n        Resolved navigation data describing documentation groups\n        and their associated Markdown files.\n\nReturns:\n    list[dict[str, Any]]:\n        A list of dictionaries representing the MkDocs navigation layout.\n        Each dictionary maps a navigation label to a page or a list of\n        pages."
           }
         }
@@ -112,7 +112,7 @@
         "name": "build_wiki_nav",
         "kind": "function",
         "path": "docforge.nav.build_wiki_nav",
-        "signature": "<bound method Alias.signature of Alias('build_wiki_nav', 'docforge.nav.wiki.build_wiki_nav')>",
+        "signature": "build_wiki_nav(wiki_dir: Path)",
         "docstring": "Derive an MkDocs navigation block from a wiki directory.\n\nReturned paths are relative to the parent of ``wiki_dir`` and carry the\nwiki directory name as their leading component (for example\n``wiki/01_overview.md`` when the wiki lives at ``docs/wiki``). This makes\nthe result directly usable in an MkDocs ``nav`` block with\n\n- ``index.md`` at the wiki root becomes the ``Home`` entry.\n- Page labels are derived from filenames: numeric order prefixes such as\n  ``01_`` or ``02-`` are stripped, separators are replaced with spaces, and\n  names are title-cased (``01_overview.md`` becomes ``Overview``).\n- Subdirectories become nested navigation groups. A nested ``index.md`` is\n  rendered as the section root placed first inside the group.\n- Only ``.md`` files are considered; hidden entries are ignored.\n\nArgs:\n    wiki_dir (Path):\n        Path to the hand-written wiki directory, for example ``docs/wiki``.\n\nReturns:\n    list[dict[str, Any]]:\n        Navigation entries compatible with the MkDocs ``nav`` configuration.\n        The list is empty if the wiki contains no Markdown files.\n\nRaises:\n    FileNotFoundError:\n        If the wiki directory does not exist."
       },
       "mkdocs": {
@@ -122,46 +122,32 @@
         "signature": null,
         "docstring": "MkDocs navigation emitter.\n\nThis module provides the ``MkDocsNavEmitter`` class, which converts a\n``ResolvedNav`` instance into the navigation structure required by the\nMkDocs ``nav`` configuration.\n\n---\n\nNotes:\n    - The emitted structure is a list of dictionaries, one per top-level nav\n      entry, matching the MkDocs ``nav`` YAML format.\n\n---",
         "members": {
-          "Path": {
-            "name": "Path",
-            "kind": "alias",
-            "path": "docforge.nav.mkdocs.Path",
-            "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
-            "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')>",
+            "signature": "ResolvedNav(home: str | None, groups: dict[str, list[Path]], docs_root: Path | None = None)",
             "docstring": "Resolved navigation structure.\n\nA ``ResolvedNav`` represents navigation data after glob patterns have been\nexpanded and paths validated against the filesystem.\n\nAttributes:\n    home: Relative path to the documentation home page.\n    groups: Mapping of navigation group titles to lists of resolved\n        documentation file paths.",
             "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": "all_files()",
                 "docstring": "Iterate over all files referenced by the navigation structure.\n\nYields:\n    Path:\n        A documentation file referenced by the navigation, including\n        the home page when defined.\n\nRaises:\n    RuntimeError: If the home page is defined but the documentation\n        root is not available for resolution."
               }
             }
@@ -170,14 +156,14 @@
             "name": "MkDocsNavEmitter",
             "kind": "class",
             "path": "docforge.nav.mkdocs.MkDocsNavEmitter",
-            "signature": "<bound method Class.signature of Class('MkDocsNavEmitter', 23, 94)>",
+            "signature": null,
             "docstring": "Emit MkDocs navigation structures from resolved navigation data.\n\nThe emitter transforms a ``ResolvedNav`` object into the YAML-compatible\nlist structure expected by the MkDocs ``nav`` configuration field.",
             "members": {
               "emit": {
                 "name": "emit",
                 "kind": "function",
                 "path": "docforge.nav.mkdocs.MkDocsNavEmitter.emit",
-                "signature": "<bound method Function.signature of Function('emit', 31, 61)>",
+                "signature": "emit(nav: ResolvedNav) -> list[dict[str, Any]]",
                 "docstring": "Generate a navigation structure for ``mkdocs.yml``.\n\nArgs:\n    nav (ResolvedNav):\n        Resolved navigation data describing documentation groups\n        and their associated Markdown files.\n\nReturns:\n    list[dict[str, Any]]:\n        A list of dictionaries representing the MkDocs navigation layout.\n        Each dictionary maps a navigation label to a page or a list of\n        pages."
               }
             }
@@ -191,67 +177,46 @@
         "signature": null,
         "docstring": "Navigation resolution utilities.\n\nThis module resolves a ``NavSpec`` against the filesystem by expanding glob\npatterns and validating that referenced documentation files exist.\n\n---\n\nNotes:\n    - Glob resolution is recursive and returns paths in sorted order.\n    - Unmatched patterns raise ``FileNotFoundError`` to fail fast on typos.\n\n---",
         "members": {
-          "glob": {
-            "name": "glob",
-            "kind": "alias",
-            "path": "docforge.nav.resolver.glob",
-            "signature": "<bound method Alias.signature of Alias('glob', 'glob')>",
-            "docstring": null
-          },
-          "Iterable": {
-            "name": "Iterable",
-            "kind": "alias",
-            "path": "docforge.nav.resolver.Iterable",
-            "signature": "<bound method Alias.signature of Alias('Iterable', 'collections.abc.Iterable')>",
-            "docstring": null
-          },
-          "Path": {
-            "name": "Path",
-            "kind": "alias",
-            "path": "docforge.nav.resolver.Path",
-            "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
-            "docstring": null
-          },
           "NavSpec": {
             "name": "NavSpec",
             "kind": "class",
             "path": "docforge.nav.resolver.NavSpec",
-            "signature": "<bound method Alias.signature of Alias('NavSpec', 'docforge.nav.spec.NavSpec')>",
+            "signature": "NavSpec(home: str | None, groups: dict[str, list[str]], icon: dict[str, str] | None = None)",
             "docstring": "Parsed representation of a navigation specification.\n\nA ``NavSpec`` describes the intended documentation navigation layout before\nit is resolved against the filesystem.\n\nAttributes:\n    home: Relative path to the documentation home page (for example\n        ``index.md``).\n    groups: Mapping of navigation group titles to lists of file patterns\n        or glob expressions.\n    icon: Optional mapping of theme icon entries (for example\n        ``{\"logo\": \"material/code-tags\"}``) injected into the MkDocs\n        theme as ``theme.icon``.",
             "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "docstring": null
               },
               "icon": {
                 "name": "icon",
                 "kind": "attribute",
                 "path": "docforge.nav.resolver.NavSpec.icon",
-                "signature": "<bound method Alias.signature of Alias('icon', 'docforge.nav.spec.NavSpec.icon')>",
+                "signature": null,
                 "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')>",
+                "signature": "load(path: Path)",
                 "docstring": "Load a navigation specification from a YAML file.\n\nArgs:\n    path (Path):\n        Filesystem path to the navigation specification file.\n\nReturns:\n    NavSpec:\n        A ``NavSpec`` instance representing the parsed configuration.\n\nRaises:\n    FileNotFoundError: If the specified file does not exist.\n    ValueError: If the file contents are not a valid navigation\n        specification."
               },
               "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')>",
+                "signature": "all_patterns()",
                 "docstring": "Return all path patterns referenced by the specification.\n\nReturns:\n    list[str]:\n        A list containing the home document (if defined) and all\n        group pattern entries."
               }
             }
@@ -260,7 +225,7 @@
             "name": "ResolvedNav",
             "kind": "class",
             "path": "docforge.nav.resolver.ResolvedNav",
-            "signature": "<bound method Class.signature of Class('ResolvedNav', 23, 76)>",
+            "signature": "ResolvedNav(home: str | None, groups: dict[str, list[Path]], docs_root: Path | None = None)",
             "docstring": "Resolved navigation structure.\n\nA ``ResolvedNav`` represents navigation data after glob patterns have been\nexpanded and paths validated against the filesystem.\n\nAttributes:\n    home: Relative path to the documentation home page.\n    groups: Mapping of navigation group titles to lists of resolved\n        documentation file paths.",
             "members": {
               "home": {
@@ -281,7 +246,7 @@
                 "name": "all_files",
                 "kind": "function",
                 "path": "docforge.nav.resolver.ResolvedNav.all_files",
-                "signature": "<bound method Function.signature of Function('all_files', 57, 76)>",
+                "signature": "all_files() -> Iterable[Path]",
                 "docstring": "Iterate over all files referenced by the navigation structure.\n\nYields:\n    Path:\n        A documentation file referenced by the navigation, including\n        the home page when defined.\n\nRaises:\n    RuntimeError: If the home page is defined but the documentation\n        root is not available for resolution."
               }
             }
@@ -290,7 +255,7 @@
             "name": "resolve_nav",
             "kind": "function",
             "path": "docforge.nav.resolver.resolve_nav",
-            "signature": "<bound method Function.signature of Function('resolve_nav', 79, 150)>",
+            "signature": "resolve_nav(spec: NavSpec, docs_root: Path) -> ResolvedNav",
             "docstring": "Resolve a navigation specification against the filesystem.\n\nThe function expands glob patterns defined in a ``NavSpec`` and verifies\nthat referenced documentation files exist within the documentation root.\n\nArgs:\n    spec (NavSpec):\n        Navigation specification describing documentation layout.\n    docs_root (Path):\n        Root directory containing documentation Markdown files.\n\nReturns:\n    ResolvedNav:\n        A `ResolvedNav` instance containing validated navigation paths.\n\nRaises:\n    FileNotFoundError: If the documentation root does not exist or a\n        navigation pattern does not match any files."
           }
         }
@@ -302,32 +267,11 @@
         "signature": null,
         "docstring": "Navigation specification model.\n\nThis module defines the ``NavSpec`` class, which represents the navigation\nstructure defined by the user in the doc-forge navigation specification\n(typically ``docforge.nav.yml``).\n\n---\n\nNotes:\n    - The spec file supports an optional ``icon`` mapping for MkDocs theme\n      customization.\n    - All file references in ``groups`` are relative to the documentation root.\n\n---",
         "members": {
-          "annotations": {
-            "name": "annotations",
-            "kind": "alias",
-            "path": "docforge.nav.spec.annotations",
-            "signature": "<bound method Alias.signature of Alias('annotations', '__future__.annotations')>",
-            "docstring": null
-          },
-          "Path": {
-            "name": "Path",
-            "kind": "alias",
-            "path": "docforge.nav.spec.Path",
-            "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
-            "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', 25, 136)>",
+            "signature": "NavSpec(home: str | None, groups: dict[str, list[str]], icon: dict[str, str] | None = None)",
             "docstring": "Parsed representation of a navigation specification.\n\nA ``NavSpec`` describes the intended documentation navigation layout before\nit is resolved against the filesystem.\n\nAttributes:\n    home: Relative path to the documentation home page (for example\n        ``index.md``).\n    groups: Mapping of navigation group titles to lists of file patterns\n        or glob expressions.\n    icon: Optional mapping of theme icon entries (for example\n        ``{\"logo\": \"material/code-tags\"}``) injected into the MkDocs\n        theme as ``theme.icon``.",
             "members": {
               "home": {
@@ -355,14 +299,14 @@
                 "name": "load",
                 "kind": "function",
                 "path": "docforge.nav.spec.NavSpec.load",
-                "signature": "<bound method Function.signature of Function('load', 65, 117)>",
+                "signature": "load(path: Path) -> NavSpec",
                 "docstring": "Load a navigation specification from a YAML file.\n\nArgs:\n    path (Path):\n        Filesystem path to the navigation specification file.\n\nReturns:\n    NavSpec:\n        A ``NavSpec`` instance representing the parsed configuration.\n\nRaises:\n    FileNotFoundError: If the specified file does not exist.\n    ValueError: If the file contents are not a valid navigation\n        specification."
               },
               "all_patterns": {
                 "name": "all_patterns",
                 "kind": "function",
                 "path": "docforge.nav.spec.NavSpec.all_patterns",
-                "signature": "<bound method Function.signature of Function('all_patterns', 119, 136)>",
+                "signature": "all_patterns() -> list[str]",
                 "docstring": "Return all path patterns referenced by the specification.\n\nReturns:\n    list[str]:\n        A list containing the home document (if defined) and all\n        group pattern entries."
               }
             }
@@ -371,7 +315,7 @@
             "name": "load_nav_spec",
             "kind": "function",
             "path": "docforge.nav.spec.load_nav_spec",
-            "signature": "<bound method Function.signature of Function('load_nav_spec', 139, 170)>",
+            "signature": "load_nav_spec(path: Path) -> NavSpec",
             "docstring": "Load a navigation specification file.\n\nThis helper function reads a YAML navigation file and constructs a\ncorresponding ``NavSpec`` instance.\n\nArgs:\n    path (Path):\n        Path to the navigation specification file.\n\nReturns:\n    NavSpec:\n        A ``NavSpec`` instance representing the parsed specification.\n\nRaises:\n    FileNotFoundError: If the specification file does not exist.\n    ValueError: If the YAML structure is invalid."
           }
         }
@@ -383,39 +327,11 @@
         "signature": null,
         "docstring": "# Summary\n\nWiki navigation derivation.\n\nThis module provides ``build_wiki_nav``, which derives an MkDocs-ready\nnavigation block from the file structure of a hand-written wiki directory\n(typically ``docs/wiki``). wiki content is authored by hand and is never\nmodified by doc-forge; only the navigation layout is inferred.\n\n# Notes\n\n- ``index.md`` at the wiki root becomes the ``Home`` entry.\n- Page labels are derived from filenames: numeric order prefixes such as\n  ``01_`` or ``02-`` are stripped, separators are replaced with spaces, and\n  names are title-cased (``01_overview.md`` becomes ``Overview``).\n- Subdirectories become nested navigation groups. A nested ``index.md`` is\n  rendered as the section root placed first inside the group.\n- Only ``.md`` files are considered; hidden entries are ignored.",
         "members": {
-          "re": {
-            "name": "re",
-            "kind": "alias",
-            "path": "docforge.nav.wiki.re",
-            "signature": "<bound method Alias.signature of Alias('re', 're')>",
-            "docstring": null
-          },
-          "Callable": {
-            "name": "Callable",
-            "kind": "alias",
-            "path": "docforge.nav.wiki.Callable",
-            "signature": "<bound method Alias.signature of Alias('Callable', 'collections.abc.Callable')>",
-            "docstring": null
-          },
-          "Path": {
-            "name": "Path",
-            "kind": "alias",
-            "path": "docforge.nav.wiki.Path",
-            "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
-            "docstring": null
-          },
-          "Any": {
-            "name": "Any",
-            "kind": "alias",
-            "path": "docforge.nav.wiki.Any",
-            "signature": "<bound method Alias.signature of Alias('Any', 'typing.Any')>",
-            "docstring": null
-          },
           "build_wiki_nav": {
             "name": "build_wiki_nav",
             "kind": "function",
             "path": "docforge.nav.wiki.build_wiki_nav",
-            "signature": "<bound method Function.signature of Function('build_wiki_nav', 28, 76)>",
+            "signature": "build_wiki_nav(wiki_dir: Path) -> list[dict[str, Any]]",
             "docstring": "Derive an MkDocs navigation block from a wiki directory.\n\nReturned paths are relative to the parent of ``wiki_dir`` and carry the\nwiki directory name as their leading component (for example\n``wiki/01_overview.md`` when the wiki lives at ``docs/wiki``). This makes\nthe result directly usable in an MkDocs ``nav`` block with\n\n- ``index.md`` at the wiki root becomes the ``Home`` entry.\n- Page labels are derived from filenames: numeric order prefixes such as\n  ``01_`` or ``02-`` are stripped, separators are replaced with spaces, and\n  names are title-cased (``01_overview.md`` becomes ``Overview``).\n- Subdirectories become nested navigation groups. A nested ``index.md`` is\n  rendered as the section root placed first inside the group.\n- Only ``.md`` files are considered; hidden entries are ignored.\n\nArgs:\n    wiki_dir (Path):\n        Path to the hand-written wiki directory, for example ``docs/wiki``.\n\nReturns:\n    list[dict[str, Any]]:\n        Navigation entries compatible with the MkDocs ``nav`` configuration.\n        The list is empty if the wiki contains no Markdown files.\n\nRaises:\n    FileNotFoundError:\n        If the wiki directory does not exist."
           }
         }

docs/mcp/modules/docforge.nav.mkdocs.json

@@ -4,46 +4,32 @@
     "path": "docforge.nav.mkdocs",
     "docstring": "MkDocs navigation emitter.\n\nThis module provides the ``MkDocsNavEmitter`` class, which converts a\n``ResolvedNav`` instance into the navigation structure required by the\nMkDocs ``nav`` configuration.\n\n---\n\nNotes:\n    - The emitted structure is a list of dictionaries, one per top-level nav\n      entry, matching the MkDocs ``nav`` YAML format.\n\n---",
     "objects": {
-      "Path": {
-        "name": "Path",
-        "kind": "alias",
-        "path": "docforge.nav.mkdocs.Path",
-        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
-        "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')>",
+        "signature": "ResolvedNav(home: str | None, groups: dict[str, list[Path]], docs_root: Path | None = None)",
         "docstring": "Resolved navigation structure.\n\nA ``ResolvedNav`` represents navigation data after glob patterns have been\nexpanded and paths validated against the filesystem.\n\nAttributes:\n    home: Relative path to the documentation home page.\n    groups: Mapping of navigation group titles to lists of resolved\n        documentation file paths.",
         "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "all_files()",
             "docstring": "Iterate over all files referenced by the navigation structure.\n\nYields:\n    Path:\n        A documentation file referenced by the navigation, including\n        the home page when defined.\n\nRaises:\n    RuntimeError: If the home page is defined but the documentation\n        root is not available for resolution."
           }
         }
@@ -52,14 +38,14 @@
         "name": "MkDocsNavEmitter",
         "kind": "class",
         "path": "docforge.nav.mkdocs.MkDocsNavEmitter",
-        "signature": "<bound method Class.signature of Class('MkDocsNavEmitter', 23, 94)>",
+        "signature": null,
         "docstring": "Emit MkDocs navigation structures from resolved navigation data.\n\nThe emitter transforms a ``ResolvedNav`` object into the YAML-compatible\nlist structure expected by the MkDocs ``nav`` configuration field.",
         "members": {
           "emit": {
             "name": "emit",
             "kind": "function",
             "path": "docforge.nav.mkdocs.MkDocsNavEmitter.emit",
-            "signature": "<bound method Function.signature of Function('emit', 31, 61)>",
+            "signature": "emit(nav: ResolvedNav) -> list[dict[str, Any]]",
             "docstring": "Generate a navigation structure for ``mkdocs.yml``.\n\nArgs:\n    nav (ResolvedNav):\n        Resolved navigation data describing documentation groups\n        and their associated Markdown files.\n\nReturns:\n    list[dict[str, Any]]:\n        A list of dictionaries representing the MkDocs navigation layout.\n        Each dictionary maps a navigation label to a page or a list of\n        pages."
           }
         }

docs/mcp/modules/docforge.nav.resolver.json

@@ -4,67 +4,46 @@
     "path": "docforge.nav.resolver",
     "docstring": "Navigation resolution utilities.\n\nThis module resolves a ``NavSpec`` against the filesystem by expanding glob\npatterns and validating that referenced documentation files exist.\n\n---\n\nNotes:\n    - Glob resolution is recursive and returns paths in sorted order.\n    - Unmatched patterns raise ``FileNotFoundError`` to fail fast on typos.\n\n---",
     "objects": {
-      "glob": {
-        "name": "glob",
-        "kind": "alias",
-        "path": "docforge.nav.resolver.glob",
-        "signature": "<bound method Alias.signature of Alias('glob', 'glob')>",
-        "docstring": null
-      },
-      "Iterable": {
-        "name": "Iterable",
-        "kind": "alias",
-        "path": "docforge.nav.resolver.Iterable",
-        "signature": "<bound method Alias.signature of Alias('Iterable', 'collections.abc.Iterable')>",
-        "docstring": null
-      },
-      "Path": {
-        "name": "Path",
-        "kind": "alias",
-        "path": "docforge.nav.resolver.Path",
-        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
-        "docstring": null
-      },
       "NavSpec": {
         "name": "NavSpec",
         "kind": "class",
         "path": "docforge.nav.resolver.NavSpec",
-        "signature": "<bound method Alias.signature of Alias('NavSpec', 'docforge.nav.spec.NavSpec')>",
+        "signature": "NavSpec(home: str | None, groups: dict[str, list[str]], icon: dict[str, str] | None = None)",
         "docstring": "Parsed representation of a navigation specification.\n\nA ``NavSpec`` describes the intended documentation navigation layout before\nit is resolved against the filesystem.\n\nAttributes:\n    home: Relative path to the documentation home page (for example\n        ``index.md``).\n    groups: Mapping of navigation group titles to lists of file patterns\n        or glob expressions.\n    icon: Optional mapping of theme icon entries (for example\n        ``{\"logo\": \"material/code-tags\"}``) injected into the MkDocs\n        theme as ``theme.icon``.",
         "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "docstring": null
           },
           "icon": {
             "name": "icon",
             "kind": "attribute",
             "path": "docforge.nav.resolver.NavSpec.icon",
-            "signature": "<bound method Alias.signature of Alias('icon', 'docforge.nav.spec.NavSpec.icon')>",
+            "signature": null,
             "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')>",
+            "signature": "load(path: Path)",
             "docstring": "Load a navigation specification from a YAML file.\n\nArgs:\n    path (Path):\n        Filesystem path to the navigation specification file.\n\nReturns:\n    NavSpec:\n        A ``NavSpec`` instance representing the parsed configuration.\n\nRaises:\n    FileNotFoundError: If the specified file does not exist.\n    ValueError: If the file contents are not a valid navigation\n        specification."
           },
           "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')>",
+            "signature": "all_patterns()",
             "docstring": "Return all path patterns referenced by the specification.\n\nReturns:\n    list[str]:\n        A list containing the home document (if defined) and all\n        group pattern entries."
           }
         }
@@ -73,7 +52,7 @@
         "name": "ResolvedNav",
         "kind": "class",
         "path": "docforge.nav.resolver.ResolvedNav",
-        "signature": "<bound method Class.signature of Class('ResolvedNav', 23, 76)>",
+        "signature": "ResolvedNav(home: str | None, groups: dict[str, list[Path]], docs_root: Path | None = None)",
         "docstring": "Resolved navigation structure.\n\nA ``ResolvedNav`` represents navigation data after glob patterns have been\nexpanded and paths validated against the filesystem.\n\nAttributes:\n    home: Relative path to the documentation home page.\n    groups: Mapping of navigation group titles to lists of resolved\n        documentation file paths.",
         "members": {
           "home": {
@@ -94,7 +73,7 @@
             "name": "all_files",
             "kind": "function",
             "path": "docforge.nav.resolver.ResolvedNav.all_files",
-            "signature": "<bound method Function.signature of Function('all_files', 57, 76)>",
+            "signature": "all_files() -> Iterable[Path]",
             "docstring": "Iterate over all files referenced by the navigation structure.\n\nYields:\n    Path:\n        A documentation file referenced by the navigation, including\n        the home page when defined.\n\nRaises:\n    RuntimeError: If the home page is defined but the documentation\n        root is not available for resolution."
           }
         }
@@ -103,7 +82,7 @@
         "name": "resolve_nav",
         "kind": "function",
         "path": "docforge.nav.resolver.resolve_nav",
-        "signature": "<bound method Function.signature of Function('resolve_nav', 79, 150)>",
+        "signature": "resolve_nav(spec: NavSpec, docs_root: Path) -> ResolvedNav",
         "docstring": "Resolve a navigation specification against the filesystem.\n\nThe function expands glob patterns defined in a ``NavSpec`` and verifies\nthat referenced documentation files exist within the documentation root.\n\nArgs:\n    spec (NavSpec):\n        Navigation specification describing documentation layout.\n    docs_root (Path):\n        Root directory containing documentation Markdown files.\n\nReturns:\n    ResolvedNav:\n        A `ResolvedNav` instance containing validated navigation paths.\n\nRaises:\n    FileNotFoundError: If the documentation root does not exist or a\n        navigation pattern does not match any files."
       }
     }

docs/mcp/modules/docforge.nav.spec.json

@@ -4,32 +4,11 @@
     "path": "docforge.nav.spec",
     "docstring": "Navigation specification model.\n\nThis module defines the ``NavSpec`` class, which represents the navigation\nstructure defined by the user in the doc-forge navigation specification\n(typically ``docforge.nav.yml``).\n\n---\n\nNotes:\n    - The spec file supports an optional ``icon`` mapping for MkDocs theme\n      customization.\n    - All file references in ``groups`` are relative to the documentation root.\n\n---",
     "objects": {
-      "annotations": {
-        "name": "annotations",
-        "kind": "alias",
-        "path": "docforge.nav.spec.annotations",
-        "signature": "<bound method Alias.signature of Alias('annotations', '__future__.annotations')>",
-        "docstring": null
-      },
-      "Path": {
-        "name": "Path",
-        "kind": "alias",
-        "path": "docforge.nav.spec.Path",
-        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
-        "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', 25, 136)>",
+        "signature": "NavSpec(home: str | None, groups: dict[str, list[str]], icon: dict[str, str] | None = None)",
         "docstring": "Parsed representation of a navigation specification.\n\nA ``NavSpec`` describes the intended documentation navigation layout before\nit is resolved against the filesystem.\n\nAttributes:\n    home: Relative path to the documentation home page (for example\n        ``index.md``).\n    groups: Mapping of navigation group titles to lists of file patterns\n        or glob expressions.\n    icon: Optional mapping of theme icon entries (for example\n        ``{\"logo\": \"material/code-tags\"}``) injected into the MkDocs\n        theme as ``theme.icon``.",
         "members": {
           "home": {
@@ -57,14 +36,14 @@
             "name": "load",
             "kind": "function",
             "path": "docforge.nav.spec.NavSpec.load",
-            "signature": "<bound method Function.signature of Function('load', 65, 117)>",
+            "signature": "load(path: Path) -> NavSpec",
             "docstring": "Load a navigation specification from a YAML file.\n\nArgs:\n    path (Path):\n        Filesystem path to the navigation specification file.\n\nReturns:\n    NavSpec:\n        A ``NavSpec`` instance representing the parsed configuration.\n\nRaises:\n    FileNotFoundError: If the specified file does not exist.\n    ValueError: If the file contents are not a valid navigation\n        specification."
           },
           "all_patterns": {
             "name": "all_patterns",
             "kind": "function",
             "path": "docforge.nav.spec.NavSpec.all_patterns",
-            "signature": "<bound method Function.signature of Function('all_patterns', 119, 136)>",
+            "signature": "all_patterns() -> list[str]",
             "docstring": "Return all path patterns referenced by the specification.\n\nReturns:\n    list[str]:\n        A list containing the home document (if defined) and all\n        group pattern entries."
           }
         }
@@ -73,7 +52,7 @@
         "name": "load_nav_spec",
         "kind": "function",
         "path": "docforge.nav.spec.load_nav_spec",
-        "signature": "<bound method Function.signature of Function('load_nav_spec', 139, 170)>",
+        "signature": "load_nav_spec(path: Path) -> NavSpec",
         "docstring": "Load a navigation specification file.\n\nThis helper function reads a YAML navigation file and constructs a\ncorresponding ``NavSpec`` instance.\n\nArgs:\n    path (Path):\n        Path to the navigation specification file.\n\nReturns:\n    NavSpec:\n        A ``NavSpec`` instance representing the parsed specification.\n\nRaises:\n    FileNotFoundError: If the specification file does not exist.\n    ValueError: If the YAML structure is invalid."
       }
     }

docs/mcp/modules/docforge.nav.wiki.json

@@ -4,39 +4,11 @@
     "path": "docforge.nav.wiki",
     "docstring": "# Summary\n\nWiki navigation derivation.\n\nThis module provides ``build_wiki_nav``, which derives an MkDocs-ready\nnavigation block from the file structure of a hand-written wiki directory\n(typically ``docs/wiki``). wiki content is authored by hand and is never\nmodified by doc-forge; only the navigation layout is inferred.\n\n# Notes\n\n- ``index.md`` at the wiki root becomes the ``Home`` entry.\n- Page labels are derived from filenames: numeric order prefixes such as\n  ``01_`` or ``02-`` are stripped, separators are replaced with spaces, and\n  names are title-cased (``01_overview.md`` becomes ``Overview``).\n- Subdirectories become nested navigation groups. A nested ``index.md`` is\n  rendered as the section root placed first inside the group.\n- Only ``.md`` files are considered; hidden entries are ignored.",
     "objects": {
-      "re": {
-        "name": "re",
-        "kind": "alias",
-        "path": "docforge.nav.wiki.re",
-        "signature": "<bound method Alias.signature of Alias('re', 're')>",
-        "docstring": null
-      },
-      "Callable": {
-        "name": "Callable",
-        "kind": "alias",
-        "path": "docforge.nav.wiki.Callable",
-        "signature": "<bound method Alias.signature of Alias('Callable', 'collections.abc.Callable')>",
-        "docstring": null
-      },
-      "Path": {
-        "name": "Path",
-        "kind": "alias",
-        "path": "docforge.nav.wiki.Path",
-        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
-        "docstring": null
-      },
-      "Any": {
-        "name": "Any",
-        "kind": "alias",
-        "path": "docforge.nav.wiki.Any",
-        "signature": "<bound method Alias.signature of Alias('Any', 'typing.Any')>",
-        "docstring": null
-      },
       "build_wiki_nav": {
         "name": "build_wiki_nav",
         "kind": "function",
         "path": "docforge.nav.wiki.build_wiki_nav",
-        "signature": "<bound method Function.signature of Function('build_wiki_nav', 28, 76)>",
+        "signature": "build_wiki_nav(wiki_dir: Path) -> list[dict[str, Any]]",
         "docstring": "Derive an MkDocs navigation block from a wiki directory.\n\nReturned paths are relative to the parent of ``wiki_dir`` and carry the\nwiki directory name as their leading component (for example\n``wiki/01_overview.md`` when the wiki lives at ``docs/wiki``). This makes\nthe result directly usable in an MkDocs ``nav`` block with\n\n- ``index.md`` at the wiki root becomes the ``Home`` entry.\n- Page labels are derived from filenames: numeric order prefixes such as\n  ``01_`` or ``02-`` are stripped, separators are replaced with spaces, and\n  names are title-cased (``01_overview.md`` becomes ``Overview``).\n- Subdirectories become nested navigation groups. A nested ``index.md`` is\n  rendered as the section root placed first inside the group.\n- Only ``.md`` files are considered; hidden entries are ignored.\n\nArgs:\n    wiki_dir (Path):\n        Path to the hand-written wiki directory, for example ``docs/wiki``.\n\nReturns:\n    list[dict[str, Any]]:\n        Navigation entries compatible with the MkDocs ``nav`` configuration.\n        The list is empty if the wiki contains no Markdown files.\n\nRaises:\n    FileNotFoundError:\n        If the wiki directory does not exist."
       }
     }

docs/mcp/modules/docforge.renderers.base.json

@@ -4,67 +4,53 @@
     "path": "docforge.renderers.base",
     "docstring": "# Summary\n\nRenderer base interfaces and configuration models.\n\nThis module defines the base protocol and configuration container used by\ndoc-forge renderers. Concrete renderer implementations should implement the\n`DocRenderer` 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')>",
+        "signature": "Project(name: str)",
         "docstring": "Representation of a documentation project.\n\nA `Project` serves as the root container for all modules discovered during\nintrospection. Each module is stored by its dotted import path.\n\nAttributes:\n    name (str):\n        Name of the project.\n\n    modules (dict[str, Module]):\n        Mapping of 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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "add_module(module: Module)",
             "docstring": "Register a module in the project.\n\nArgs:\n    module (Module):\n        Module instance to add to the project."
           },
           "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')>",
+            "signature": "get_module(path: str)",
             "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path (str):\n        Fully qualified dotted module path (for example `pkg.module`).\n\nReturns:\n    Module:\n        The corresponding `Module` instance.\n\nRaises:\n    KeyError:\n        If the module does not exist in the project."
           },
           "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')>",
+            "signature": "get_all_modules()",
             "docstring": "Return all modules contained in the project.\n\nReturns:\n    Iterable[Module]:\n        An iterable of `Module` instances."
           },
           "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')>",
+            "signature": "get_module_list()",
             "docstring": "Return the list of module import paths.\n\nReturns:\n    list[str]:\n        A list containing the dotted paths of all modules in the project."
           }
         }
@@ -73,7 +59,7 @@
         "name": "RendererConfig",
         "kind": "class",
         "path": "docforge.renderers.base.RendererConfig",
-        "signature": "<bound method Class.signature of Class('RendererConfig', 17, 44)>",
+        "signature": "RendererConfig(out_dir: Path, project: Project)",
         "docstring": "Configuration container for documentation renderers.\n\nA `RendererConfig` instance groups together the project model and the\noutput directory used during rendering.\n\nAttributes:\n    out_dir (Path):\n        Directory where generated documentation files will be written.\n\n    project (Project):\n        Documentation project model to be rendered.",
         "members": {
           "out_dir": {
@@ -96,7 +82,7 @@
         "name": "DocRenderer",
         "kind": "class",
         "path": "docforge.renderers.base.DocRenderer",
-        "signature": "<bound method Class.signature of Class('DocRenderer', 47, 72)>",
+        "signature": null,
         "docstring": "Protocol defining the interface for documentation renderers.\n\nImplementations of this protocol are responsible for transforming a\n`Project` model into renderer-specific documentation sources.",
         "members": {
           "name": {
@@ -110,7 +96,7 @@
             "name": "generate_sources",
             "kind": "function",
             "path": "docforge.renderers.base.DocRenderer.generate_sources",
-            "signature": "<bound method Function.signature of Function('generate_sources', 57, 72)>",
+            "signature": "generate_sources(project: Project, out_dir: Path) -> None",
             "docstring": "Generate renderer-specific documentation sources.\n\nArgs:\n    project (Project):\n        Project model containing modules and documentation objects.\n\n    out_dir (Path):\n        Directory where generated documentation sources should be written."
           }
         }

docs/mcp/modules/docforge.renderers.json

@@ -8,28 +8,28 @@
         "name": "MkDocsRenderer",
         "kind": "class",
         "path": "docforge.renderers.MkDocsRenderer",
-        "signature": "<bound method Alias.signature of Alias('MkDocsRenderer', 'docforge.renderers.mkdocs_renderer.MkDocsRenderer')>",
+        "signature": null,
         "docstring": "Renderer that produces Markdown documentation for MkDocs.\n\nGenerated pages use mkdocstrings directives to reference Python modules,\nallowing MkDocs to render API documentation dynamically.",
         "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')>",
+            "signature": null,
             "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')>",
+            "signature": "generate_sources(project: Project, out_dir: Path, module_is_source: bool | None = None)",
             "docstring": "Generate Markdown documentation files for a project.\n\nThis method renders a documentation structure from the provided\nproject model and writes the resulting Markdown files to the\nspecified output directory.\n\nArgs:\n    project (Project):\n        Project model containing modules to document.\n\n    out_dir (Path):\n        Directory where generated Markdown files will be written.\n\n    module_is_source (bool | None):\n        If True, treat the specified module as the documentation root\n        rather than nesting it inside a folder."
           },
           "generate_readme": {
             "name": "generate_readme",
             "kind": "function",
             "path": "docforge.renderers.MkDocsRenderer.generate_readme",
-            "signature": "<bound method Alias.signature of Alias('generate_readme', 'docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_readme')>",
+            "signature": "generate_readme(project: Project, docs_dir: Path, module_is_source: bool | None = None, readme_dir: Path | None = None)",
             "docstring": "Generate a `README.md` file from the root module docstring.\n\nNotes:\n    - If `module_is_source` is True, `README.md` is written to the\n      project root directory.\n    - If False, README generation is currently not implemented.\n\nArgs:\n    project (Project):\n        Project model containing documentation metadata.\n\n    docs_dir (Path):\n        Directory containing generated documentation sources.\n\n    module_is_source (bool | None):\n        Whether the module is treated as the project source root.\n\n    readme_dir (Path | None):\n        Directory where the generated README.md should be written.\n        Defaults to the parent of `docs_dir`."
           }
         }
@@ -38,21 +38,21 @@
         "name": "MCPRenderer",
         "kind": "class",
         "path": "docforge.renderers.MCPRenderer",
-        "signature": "<bound method Alias.signature of Alias('MCPRenderer', 'docforge.renderers.mcp_renderer.MCPRenderer')>",
+        "signature": null,
         "docstring": "Renderer that generates MCP-compatible documentation resources.\n\nThis renderer converts doc-forge project models into structured JSON\nresources suitable for consumption by systems implementing the Model\nContext Protocol (MCP).",
         "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')>",
+            "signature": null,
             "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')>",
+            "signature": "generate_sources(project: Project, out_dir: Path)",
             "docstring": "Generate MCP documentation resources for a project.\n\nThe renderer serializes each module into a JSON resource and produces\nsupporting metadata files such as `nav.json` and `index.json`.\n\nArgs:\n    project (Project):\n        Documentation project model to render.\n\n    out_dir (Path):\n        Directory where MCP resources will be written."
           }
         }
@@ -64,67 +64,53 @@
         "signature": null,
         "docstring": "# Summary\n\nRenderer base interfaces and configuration models.\n\nThis module defines the base protocol and configuration container used by\ndoc-forge renderers. Concrete renderer implementations should implement the\n`DocRenderer` 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')>",
+            "signature": "Project(name: str)",
             "docstring": "Representation of a documentation project.\n\nA `Project` serves as the root container for all modules discovered during\nintrospection. Each module is stored by its dotted import path.\n\nAttributes:\n    name (str):\n        Name of the project.\n\n    modules (dict[str, Module]):\n        Mapping of 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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": "add_module(module: Module)",
                 "docstring": "Register a module in the project.\n\nArgs:\n    module (Module):\n        Module instance to add to the project."
               },
               "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')>",
+                "signature": "get_module(path: str)",
                 "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path (str):\n        Fully qualified dotted module path (for example `pkg.module`).\n\nReturns:\n    Module:\n        The corresponding `Module` instance.\n\nRaises:\n    KeyError:\n        If the module does not exist in the project."
               },
               "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')>",
+                "signature": "get_all_modules()",
                 "docstring": "Return all modules contained in the project.\n\nReturns:\n    Iterable[Module]:\n        An iterable of `Module` instances."
               },
               "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')>",
+                "signature": "get_module_list()",
                 "docstring": "Return the list of module import paths.\n\nReturns:\n    list[str]:\n        A list containing the dotted paths of all modules in the project."
               }
             }
@@ -133,7 +119,7 @@
             "name": "RendererConfig",
             "kind": "class",
             "path": "docforge.renderers.base.RendererConfig",
-            "signature": "<bound method Class.signature of Class('RendererConfig', 17, 44)>",
+            "signature": "RendererConfig(out_dir: Path, project: Project)",
             "docstring": "Configuration container for documentation renderers.\n\nA `RendererConfig` instance groups together the project model and the\noutput directory used during rendering.\n\nAttributes:\n    out_dir (Path):\n        Directory where generated documentation files will be written.\n\n    project (Project):\n        Documentation project model to be rendered.",
             "members": {
               "out_dir": {
@@ -156,7 +142,7 @@
             "name": "DocRenderer",
             "kind": "class",
             "path": "docforge.renderers.base.DocRenderer",
-            "signature": "<bound method Class.signature of Class('DocRenderer', 47, 72)>",
+            "signature": null,
             "docstring": "Protocol defining the interface for documentation renderers.\n\nImplementations of this protocol are responsible for transforming a\n`Project` model into renderer-specific documentation sources.",
             "members": {
               "name": {
@@ -170,7 +156,7 @@
                 "name": "generate_sources",
                 "kind": "function",
                 "path": "docforge.renderers.base.DocRenderer.generate_sources",
-                "signature": "<bound method Function.signature of Function('generate_sources', 57, 72)>",
+                "signature": "generate_sources(project: Project, out_dir: Path) -> None",
                 "docstring": "Generate renderer-specific documentation sources.\n\nArgs:\n    project (Project):\n        Project model containing modules and documentation objects.\n\n    out_dir (Path):\n        Directory where generated documentation sources should be written."
               }
             }
@@ -184,88 +170,74 @@
         "signature": null,
         "docstring": "# Summary\n\nMCP renderer implementation.\n\nThis module defines the `MCPRenderer` class, which generates documentation\nresources compatible with the Model Context Protocol (MCP).",
         "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
-          },
           "DocObject": {
             "name": "DocObject",
             "kind": "class",
             "path": "docforge.renderers.mcp_renderer.DocObject",
-            "signature": "<bound method Alias.signature of Alias('DocObject', 'docforge.models.DocObject')>",
+            "signature": "DocObject(name: str, kind: str, path: str, signature: str | None = None, docstring: str | None = None)",
             "docstring": "Representation of a documented Python object.\n\nA `DocObject` models a single Python entity discovered during\nintrospection. Objects may contain nested members, allowing the structure\nof modules, classes, and other containers to be represented recursively.\n\nAttributes:\n    name (str):\n        Local name of the object.\n\n    kind (str):\n        Type of object (for example `class`, `function`, `method`, or `attribute`).\n\n    path (str):\n        Fully qualified dotted path to the object.\n\n    signature (str | None):\n        Callable signature if the object represents a callable.\n\n    docstring (str | None):\n        Raw docstring text extracted from the source code.\n\n    members (dict[str, DocObject]):\n        Mapping of member names to child `DocObject` instances.",
             "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": "add_member(obj: DocObject)",
                 "docstring": "Add a child documentation object.\n\nThis is typically used when attaching methods to classes or\nnested objects to their parent containers.\n\nArgs:\n    obj (DocObject):\n        Documentation object to add as a member."
               },
               "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')>",
+                "signature": "get_member(name: str)",
                 "docstring": "Retrieve a member object by name.\n\nArgs:\n    name (str):\n        Name of the member to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If the member does not exist."
               },
               "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')>",
+                "signature": "get_all_members()",
                 "docstring": "Return all child members of the object.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing nested members."
               }
             }
@@ -274,49 +246,49 @@
             "name": "Module",
             "kind": "class",
             "path": "docforge.renderers.mcp_renderer.Module",
-            "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.Module')>",
+            "signature": "Module(path: str, docstring: str | None = None)",
             "docstring": "Representation of a documented Python module or package.\n\nA `Module` stores metadata about the module itself and maintains a\ncollection of top-level documentation objects discovered during\nintrospection.\n\nAttributes:\n    path (str):\n        Dotted import path of the module.\n\n    docstring (str | None):\n        Module-level documentation string, if present.\n\n    members (dict[str, DocObject]):\n        Mapping of object names to their corresponding `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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": "add_object(obj: DocObject)",
                 "docstring": "Add a documented object to the module.\n\nArgs:\n    obj (DocObject):\n        Documentation object to register as a top-level member of the module."
               },
               "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')>",
+                "signature": "get_object(name: str)",
                 "docstring": "Retrieve a documented object by name.\n\nArgs:\n    name (str):\n        Name of the object to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If no object with the given name exists."
               },
               "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')>",
+                "signature": "get_all_objects()",
                 "docstring": "Return all top-level documentation objects in the module.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing the module's public members."
               }
             }
@@ -325,49 +297,49 @@
             "name": "Project",
             "kind": "class",
             "path": "docforge.renderers.mcp_renderer.Project",
-            "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.Project')>",
+            "signature": "Project(name: str)",
             "docstring": "Representation of a documentation project.\n\nA `Project` serves as the root container for all modules discovered during\nintrospection. Each module is stored by its dotted import path.\n\nAttributes:\n    name (str):\n        Name of the project.\n\n    modules (dict[str, Module]):\n        Mapping of 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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": "add_module(module: Module)",
                 "docstring": "Register a module in the project.\n\nArgs:\n    module (Module):\n        Module instance to add to the project."
               },
               "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')>",
+                "signature": "get_module(path: str)",
                 "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path (str):\n        Fully qualified dotted module path (for example `pkg.module`).\n\nReturns:\n    Module:\n        The corresponding `Module` instance.\n\nRaises:\n    KeyError:\n        If the module does not exist in the project."
               },
               "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')>",
+                "signature": "get_all_modules()",
                 "docstring": "Return all modules contained in the project.\n\nReturns:\n    Iterable[Module]:\n        An iterable of `Module` instances."
               },
               "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')>",
+                "signature": "get_module_list()",
                 "docstring": "Return the list of module import paths.\n\nReturns:\n    list[str]:\n        A list containing the dotted paths of all modules in the project."
               }
             }
@@ -376,7 +348,7 @@
             "name": "MCPRenderer",
             "kind": "class",
             "path": "docforge.renderers.mcp_renderer.MCPRenderer",
-            "signature": "<bound method Class.signature of Class('MCPRenderer', 16, 159)>",
+            "signature": null,
             "docstring": "Renderer that generates MCP-compatible documentation resources.\n\nThis renderer converts doc-forge project models into structured JSON\nresources suitable for consumption by systems implementing the Model\nContext Protocol (MCP).",
             "members": {
               "name": {
@@ -390,17 +362,10 @@
                 "name": "generate_sources",
                 "kind": "function",
                 "path": "docforge.renderers.mcp_renderer.MCPRenderer.generate_sources",
-                "signature": "<bound method Function.signature of Function('generate_sources', 27, 73)>",
+                "signature": "generate_sources(project: Project, out_dir: Path) -> None",
                 "docstring": "Generate MCP documentation resources for a project.\n\nThe renderer serializes each module into a JSON resource and produces\nsupporting metadata files such as `nav.json` and `index.json`.\n\nArgs:\n    project (Project):\n        Documentation project model to render.\n\n    out_dir (Path):\n        Directory where MCP resources will be written."
               }
             }
-          },
-          "Any": {
-            "name": "Any",
-            "kind": "alias",
-            "path": "docforge.renderers.mcp_renderer.Any",
-            "signature": "<bound method Alias.signature of Alias('Any', 'typing.Any')>",
-            "docstring": null
           }
         }
       },
@@ -411,60 +376,53 @@
         "signature": null,
         "docstring": "# Summary\n\nMkDocs renderer implementation.\n\nThis module defines the `MkDocsRenderer` class, which generates Markdown\ndocumentation sources compatible with MkDocs Material and the mkdocstrings\nplugin.\n\nThe renderer ensures a consistent documentation structure by:\n\n- Creating a root `index.md` if one does not exist\n- Generating package index pages automatically\n- Linking child modules within parent package pages\n- Optionally generating `README.md` from the root package docstring",
         "members": {
-          "Path": {
-            "name": "Path",
-            "kind": "alias",
-            "path": "docforge.renderers.mkdocs_renderer.Path",
-            "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
-            "docstring": null
-          },
           "Module": {
             "name": "Module",
             "kind": "class",
             "path": "docforge.renderers.mkdocs_renderer.Module",
-            "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.Module')>",
+            "signature": "Module(path: str, docstring: str | None = None)",
             "docstring": "Representation of a documented Python module or package.\n\nA `Module` stores metadata about the module itself and maintains a\ncollection of top-level documentation objects discovered during\nintrospection.\n\nAttributes:\n    path (str):\n        Dotted import path of the module.\n\n    docstring (str | None):\n        Module-level documentation string, if present.\n\n    members (dict[str, DocObject]):\n        Mapping of object names to their corresponding `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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": "add_object(obj: DocObject)",
                 "docstring": "Add a documented object to the module.\n\nArgs:\n    obj (DocObject):\n        Documentation object to register as a top-level member of the module."
               },
               "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')>",
+                "signature": "get_object(name: str)",
                 "docstring": "Retrieve a documented object by name.\n\nArgs:\n    name (str):\n        Name of the object to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If no object with the given name exists."
               },
               "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')>",
+                "signature": "get_all_objects()",
                 "docstring": "Return all top-level documentation objects in the module.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing the module's public members."
               }
             }
@@ -473,49 +431,49 @@
             "name": "Project",
             "kind": "class",
             "path": "docforge.renderers.mkdocs_renderer.Project",
-            "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.Project')>",
+            "signature": "Project(name: str)",
             "docstring": "Representation of a documentation project.\n\nA `Project` serves as the root container for all modules discovered during\nintrospection. Each module is stored by its dotted import path.\n\nAttributes:\n    name (str):\n        Name of the project.\n\n    modules (dict[str, Module]):\n        Mapping of 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')>",
+                "signature": null,
                 "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')>",
+                "signature": null,
                 "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')>",
+                "signature": "add_module(module: Module)",
                 "docstring": "Register a module in the project.\n\nArgs:\n    module (Module):\n        Module instance to add to the project."
               },
               "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')>",
+                "signature": "get_module(path: str)",
                 "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path (str):\n        Fully qualified dotted module path (for example `pkg.module`).\n\nReturns:\n    Module:\n        The corresponding `Module` instance.\n\nRaises:\n    KeyError:\n        If the module does not exist in the project."
               },
               "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')>",
+                "signature": "get_all_modules()",
                 "docstring": "Return all modules contained in the project.\n\nReturns:\n    Iterable[Module]:\n        An iterable of `Module` instances."
               },
               "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')>",
+                "signature": "get_module_list()",
                 "docstring": "Return the list of module import paths.\n\nReturns:\n    list[str]:\n        A list containing the dotted paths of all modules in the project."
               }
             }
@@ -524,7 +482,7 @@
             "name": "MkDocsRenderer",
             "kind": "class",
             "path": "docforge.renderers.mkdocs_renderer.MkDocsRenderer",
-            "signature": "<bound method Class.signature of Class('MkDocsRenderer', 23, 306)>",
+            "signature": null,
             "docstring": "Renderer that produces Markdown documentation for MkDocs.\n\nGenerated pages use mkdocstrings directives to reference Python modules,\nallowing MkDocs to render API documentation dynamically.",
             "members": {
               "name": {
@@ -538,14 +496,14 @@
                 "name": "generate_sources",
                 "kind": "function",
                 "path": "docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_sources",
-                "signature": "<bound method Function.signature of Function('generate_sources', 37, 78)>",
+                "signature": "generate_sources(project: Project, out_dir: Path, module_is_source: bool | None = None) -> None",
                 "docstring": "Generate Markdown documentation files for a project.\n\nThis method renders a documentation structure from the provided\nproject model and writes the resulting Markdown files to the\nspecified output directory.\n\nArgs:\n    project (Project):\n        Project model containing modules to document.\n\n    out_dir (Path):\n        Directory where generated Markdown files will be written.\n\n    module_is_source (bool | None):\n        If True, treat the specified module as the documentation root\n        rather than nesting it inside a folder."
               },
               "generate_readme": {
                 "name": "generate_readme",
                 "kind": "function",
                 "path": "docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_readme",
-                "signature": "<bound method Function.signature of Function('generate_readme', 80, 144)>",
+                "signature": "generate_readme(project: Project, docs_dir: Path, module_is_source: bool | None = None, readme_dir: Path | None = None) -> None",
                 "docstring": "Generate a `README.md` file from the root module docstring.\n\nNotes:\n    - If `module_is_source` is True, `README.md` is written to the\n      project root directory.\n    - If False, README generation is currently not implemented.\n\nArgs:\n    project (Project):\n        Project model containing documentation metadata.\n\n    docs_dir (Path):\n        Directory containing generated documentation sources.\n\n    module_is_source (bool | None):\n        Whether the module is treated as the project source root.\n\n    readme_dir (Path | None):\n        Directory where the generated README.md should be written.\n        Defaults to the parent of `docs_dir`."
               }
             }

docs/mcp/modules/docforge.renderers.mcp_renderer.json

@@ -4,88 +4,74 @@
     "path": "docforge.renderers.mcp_renderer",
     "docstring": "# Summary\n\nMCP renderer implementation.\n\nThis module defines the `MCPRenderer` class, which generates documentation\nresources compatible with the Model Context Protocol (MCP).",
     "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
-      },
       "DocObject": {
         "name": "DocObject",
         "kind": "class",
         "path": "docforge.renderers.mcp_renderer.DocObject",
-        "signature": "<bound method Alias.signature of Alias('DocObject', 'docforge.models.DocObject')>",
+        "signature": "DocObject(name: str, kind: str, path: str, signature: str | None = None, docstring: str | None = None)",
         "docstring": "Representation of a documented Python object.\n\nA `DocObject` models a single Python entity discovered during\nintrospection. Objects may contain nested members, allowing the structure\nof modules, classes, and other containers to be represented recursively.\n\nAttributes:\n    name (str):\n        Local name of the object.\n\n    kind (str):\n        Type of object (for example `class`, `function`, `method`, or `attribute`).\n\n    path (str):\n        Fully qualified dotted path to the object.\n\n    signature (str | None):\n        Callable signature if the object represents a callable.\n\n    docstring (str | None):\n        Raw docstring text extracted from the source code.\n\n    members (dict[str, DocObject]):\n        Mapping of member names to child `DocObject` instances.",
         "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "add_member(obj: DocObject)",
             "docstring": "Add a child documentation object.\n\nThis is typically used when attaching methods to classes or\nnested objects to their parent containers.\n\nArgs:\n    obj (DocObject):\n        Documentation object to add as a member."
           },
           "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')>",
+            "signature": "get_member(name: str)",
             "docstring": "Retrieve a member object by name.\n\nArgs:\n    name (str):\n        Name of the member to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If the member does not exist."
           },
           "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')>",
+            "signature": "get_all_members()",
             "docstring": "Return all child members of the object.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing nested members."
           }
         }
@@ -94,49 +80,49 @@
         "name": "Module",
         "kind": "class",
         "path": "docforge.renderers.mcp_renderer.Module",
-        "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.Module')>",
+        "signature": "Module(path: str, docstring: str | None = None)",
         "docstring": "Representation of a documented Python module or package.\n\nA `Module` stores metadata about the module itself and maintains a\ncollection of top-level documentation objects discovered during\nintrospection.\n\nAttributes:\n    path (str):\n        Dotted import path of the module.\n\n    docstring (str | None):\n        Module-level documentation string, if present.\n\n    members (dict[str, DocObject]):\n        Mapping of object names to their corresponding `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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "add_object(obj: DocObject)",
             "docstring": "Add a documented object to the module.\n\nArgs:\n    obj (DocObject):\n        Documentation object to register as a top-level member of the module."
           },
           "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')>",
+            "signature": "get_object(name: str)",
             "docstring": "Retrieve a documented object by name.\n\nArgs:\n    name (str):\n        Name of the object to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If no object with the given name exists."
           },
           "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')>",
+            "signature": "get_all_objects()",
             "docstring": "Return all top-level documentation objects in the module.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing the module's public members."
           }
         }
@@ -145,49 +131,49 @@
         "name": "Project",
         "kind": "class",
         "path": "docforge.renderers.mcp_renderer.Project",
-        "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.Project')>",
+        "signature": "Project(name: str)",
         "docstring": "Representation of a documentation project.\n\nA `Project` serves as the root container for all modules discovered during\nintrospection. Each module is stored by its dotted import path.\n\nAttributes:\n    name (str):\n        Name of the project.\n\n    modules (dict[str, Module]):\n        Mapping of 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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "add_module(module: Module)",
             "docstring": "Register a module in the project.\n\nArgs:\n    module (Module):\n        Module instance to add to the project."
           },
           "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')>",
+            "signature": "get_module(path: str)",
             "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path (str):\n        Fully qualified dotted module path (for example `pkg.module`).\n\nReturns:\n    Module:\n        The corresponding `Module` instance.\n\nRaises:\n    KeyError:\n        If the module does not exist in the project."
           },
           "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')>",
+            "signature": "get_all_modules()",
             "docstring": "Return all modules contained in the project.\n\nReturns:\n    Iterable[Module]:\n        An iterable of `Module` instances."
           },
           "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')>",
+            "signature": "get_module_list()",
             "docstring": "Return the list of module import paths.\n\nReturns:\n    list[str]:\n        A list containing the dotted paths of all modules in the project."
           }
         }
@@ -196,7 +182,7 @@
         "name": "MCPRenderer",
         "kind": "class",
         "path": "docforge.renderers.mcp_renderer.MCPRenderer",
-        "signature": "<bound method Class.signature of Class('MCPRenderer', 16, 159)>",
+        "signature": null,
         "docstring": "Renderer that generates MCP-compatible documentation resources.\n\nThis renderer converts doc-forge project models into structured JSON\nresources suitable for consumption by systems implementing the Model\nContext Protocol (MCP).",
         "members": {
           "name": {
@@ -210,17 +196,10 @@
             "name": "generate_sources",
             "kind": "function",
             "path": "docforge.renderers.mcp_renderer.MCPRenderer.generate_sources",
-            "signature": "<bound method Function.signature of Function('generate_sources', 27, 73)>",
+            "signature": "generate_sources(project: Project, out_dir: Path) -> None",
             "docstring": "Generate MCP documentation resources for a project.\n\nThe renderer serializes each module into a JSON resource and produces\nsupporting metadata files such as `nav.json` and `index.json`.\n\nArgs:\n    project (Project):\n        Documentation project model to render.\n\n    out_dir (Path):\n        Directory where MCP resources will be written."
           }
         }
-      },
-      "Any": {
-        "name": "Any",
-        "kind": "alias",
-        "path": "docforge.renderers.mcp_renderer.Any",
-        "signature": "<bound method Alias.signature of Alias('Any', 'typing.Any')>",
-        "docstring": null
       }
     }
   }

docs/mcp/modules/docforge.renderers.mkdocs_renderer.json

@@ -4,60 +4,53 @@
     "path": "docforge.renderers.mkdocs_renderer",
     "docstring": "# Summary\n\nMkDocs renderer implementation.\n\nThis module defines the `MkDocsRenderer` class, which generates Markdown\ndocumentation sources compatible with MkDocs Material and the mkdocstrings\nplugin.\n\nThe renderer ensures a consistent documentation structure by:\n\n- Creating a root `index.md` if one does not exist\n- Generating package index pages automatically\n- Linking child modules within parent package pages\n- Optionally generating `README.md` from the root package docstring",
     "objects": {
-      "Path": {
-        "name": "Path",
-        "kind": "alias",
-        "path": "docforge.renderers.mkdocs_renderer.Path",
-        "signature": "<bound method Alias.signature of Alias('Path', 'pathlib.Path')>",
-        "docstring": null
-      },
       "Module": {
         "name": "Module",
         "kind": "class",
         "path": "docforge.renderers.mkdocs_renderer.Module",
-        "signature": "<bound method Alias.signature of Alias('Module', 'docforge.models.Module')>",
+        "signature": "Module(path: str, docstring: str | None = None)",
         "docstring": "Representation of a documented Python module or package.\n\nA `Module` stores metadata about the module itself and maintains a\ncollection of top-level documentation objects discovered during\nintrospection.\n\nAttributes:\n    path (str):\n        Dotted import path of the module.\n\n    docstring (str | None):\n        Module-level documentation string, if present.\n\n    members (dict[str, DocObject]):\n        Mapping of object names to their corresponding `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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "add_object(obj: DocObject)",
             "docstring": "Add a documented object to the module.\n\nArgs:\n    obj (DocObject):\n        Documentation object to register as a top-level member of the module."
           },
           "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')>",
+            "signature": "get_object(name: str)",
             "docstring": "Retrieve a documented object by name.\n\nArgs:\n    name (str):\n        Name of the object to retrieve.\n\nReturns:\n    DocObject:\n        The corresponding `DocObject` instance.\n\nRaises:\n    KeyError:\n        If no object with the given name exists."
           },
           "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')>",
+            "signature": "get_all_objects()",
             "docstring": "Return all top-level documentation objects in the module.\n\nReturns:\n    Iterable[DocObject]:\n        An iterable of `DocObject` instances representing the module's public members."
           }
         }
@@ -66,49 +59,49 @@
         "name": "Project",
         "kind": "class",
         "path": "docforge.renderers.mkdocs_renderer.Project",
-        "signature": "<bound method Alias.signature of Alias('Project', 'docforge.models.Project')>",
+        "signature": "Project(name: str)",
         "docstring": "Representation of a documentation project.\n\nA `Project` serves as the root container for all modules discovered during\nintrospection. Each module is stored by its dotted import path.\n\nAttributes:\n    name (str):\n        Name of the project.\n\n    modules (dict[str, Module]):\n        Mapping of 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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "add_module(module: Module)",
             "docstring": "Register a module in the project.\n\nArgs:\n    module (Module):\n        Module instance to add to the project."
           },
           "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')>",
+            "signature": "get_module(path: str)",
             "docstring": "Retrieve a module by its dotted path.\n\nArgs:\n    path (str):\n        Fully qualified dotted module path (for example `pkg.module`).\n\nReturns:\n    Module:\n        The corresponding `Module` instance.\n\nRaises:\n    KeyError:\n        If the module does not exist in the project."
           },
           "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')>",
+            "signature": "get_all_modules()",
             "docstring": "Return all modules contained in the project.\n\nReturns:\n    Iterable[Module]:\n        An iterable of `Module` instances."
           },
           "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')>",
+            "signature": "get_module_list()",
             "docstring": "Return the list of module import paths.\n\nReturns:\n    list[str]:\n        A list containing the dotted paths of all modules in the project."
           }
         }
@@ -117,7 +110,7 @@
         "name": "MkDocsRenderer",
         "kind": "class",
         "path": "docforge.renderers.mkdocs_renderer.MkDocsRenderer",
-        "signature": "<bound method Class.signature of Class('MkDocsRenderer', 23, 306)>",
+        "signature": null,
         "docstring": "Renderer that produces Markdown documentation for MkDocs.\n\nGenerated pages use mkdocstrings directives to reference Python modules,\nallowing MkDocs to render API documentation dynamically.",
         "members": {
           "name": {
@@ -131,14 +124,14 @@
             "name": "generate_sources",
             "kind": "function",
             "path": "docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_sources",
-            "signature": "<bound method Function.signature of Function('generate_sources', 37, 78)>",
+            "signature": "generate_sources(project: Project, out_dir: Path, module_is_source: bool | None = None) -> None",
             "docstring": "Generate Markdown documentation files for a project.\n\nThis method renders a documentation structure from the provided\nproject model and writes the resulting Markdown files to the\nspecified output directory.\n\nArgs:\n    project (Project):\n        Project model containing modules to document.\n\n    out_dir (Path):\n        Directory where generated Markdown files will be written.\n\n    module_is_source (bool | None):\n        If True, treat the specified module as the documentation root\n        rather than nesting it inside a folder."
           },
           "generate_readme": {
             "name": "generate_readme",
             "kind": "function",
             "path": "docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_readme",
-            "signature": "<bound method Function.signature of Function('generate_readme', 80, 144)>",
+            "signature": "generate_readme(project: Project, docs_dir: Path, module_is_source: bool | None = None, readme_dir: Path | None = None) -> None",
             "docstring": "Generate a `README.md` file from the root module docstring.\n\nNotes:\n    - If `module_is_source` is True, `README.md` is written to the\n      project root directory.\n    - If False, README generation is currently not implemented.\n\nArgs:\n    project (Project):\n        Project model containing documentation metadata.\n\n    docs_dir (Path):\n        Directory containing generated documentation sources.\n\n    module_is_source (bool | None):\n        Whether the module is treated as the project source root.\n\n    readme_dir (Path | None):\n        Directory where the generated README.md should be written.\n        Defaults to the parent of `docs_dir`."
           }
         }

docs/mcp/modules/docforge.servers.json

@@ -8,28 +8,28 @@
         "name": "MCPServer",
         "kind": "class",
         "path": "docforge.servers.MCPServer",
-        "signature": "<bound method Alias.signature of Alias('MCPServer', 'docforge.servers.mcp_server.MCPServer')>",
+        "signature": "MCPServer(mcp_root: Path, name: str)",
         "docstring": "MCP server for serving a pre-generated documentation bundle.\n\nThe server exposes documentation resources and diagnostic tools through\nMCP endpoints backed by JSON files generated by the MCP renderer.\n\nAttributes:\n    mcp_root (Path):\n        Directory containing the generated MCP documentation bundle.\n\n    app (FastMCP):\n        Underlying FastMCP application instance that registers resources\n        and tools.",
         "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')>",
+            "signature": null,
             "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')>",
+            "signature": null,
             "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')>",
+            "signature": "run(transport: Literal['stdio', 'sse', 'streamable-http'] = 'streamable-http')",
             "docstring": "Start the MCP server.\n\nArgs:\n    transport (Literal[\"stdio\", \"sse\", \"streamable-http\"]):\n        Transport mechanism used by the MCP server. Supported options\n        include `stdio`, `sse`, and `streamable-http`."
           }
         }
@@ -41,53 +41,11 @@
         "signature": null,
         "docstring": "# Summary\n\nMCP server implementation.\n\nThis module defines the `MCPServer` class, which serves pre-generated\ndocumentation bundles through the Model Context Protocol (MCP).\n\n---\n\nNotes:\n    - The served bundle is generated offline by `MCPRenderer`.\n    - Missing resources are reported as structured error dictionaries rather\n      than raising exceptions.\n    - The server exposes read-only resources and a single health-check tool.\n\n---",
         "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', 29, 152)>",
+            "signature": "MCPServer(mcp_root: Path, name: str)",
             "docstring": "MCP server for serving a pre-generated documentation bundle.\n\nThe server exposes documentation resources and diagnostic tools through\nMCP endpoints backed by JSON files generated by the MCP renderer.\n\nAttributes:\n    mcp_root (Path):\n        Directory containing the generated MCP documentation bundle.\n\n    app (FastMCP):\n        Underlying FastMCP application instance that registers resources\n        and tools.",
             "members": {
               "mcp_root": {
@@ -108,7 +66,7 @@
                 "name": "run",
                 "kind": "function",
                 "path": "docforge.servers.mcp_server.MCPServer.run",
-                "signature": "<bound method Function.signature of Function('run', 140, 152)>",
+                "signature": "run(transport: Literal['stdio', 'sse', 'streamable-http'] = 'streamable-http') -> None",
                 "docstring": "Start the MCP server.\n\nArgs:\n    transport (Literal[\"stdio\", \"sse\", \"streamable-http\"]):\n        Transport mechanism used by the MCP server. Supported options\n        include `stdio`, `sse`, and `streamable-http`."
               }
             }

docs/mcp/modules/docforge.servers.mcp_server.json

@@ -4,53 +4,11 @@
     "path": "docforge.servers.mcp_server",
     "docstring": "# Summary\n\nMCP server implementation.\n\nThis module defines the `MCPServer` class, which serves pre-generated\ndocumentation bundles through the Model Context Protocol (MCP).\n\n---\n\nNotes:\n    - The served bundle is generated offline by `MCPRenderer`.\n    - Missing resources are reported as structured error dictionaries rather\n      than raising exceptions.\n    - The server exposes read-only resources and a single health-check tool.\n\n---",
     "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', 29, 152)>",
+        "signature": "MCPServer(mcp_root: Path, name: str)",
         "docstring": "MCP server for serving a pre-generated documentation bundle.\n\nThe server exposes documentation resources and diagnostic tools through\nMCP endpoints backed by JSON files generated by the MCP renderer.\n\nAttributes:\n    mcp_root (Path):\n        Directory containing the generated MCP documentation bundle.\n\n    app (FastMCP):\n        Underlying FastMCP application instance that registers resources\n        and tools.",
         "members": {
           "mcp_root": {
@@ -71,7 +29,7 @@
             "name": "run",
             "kind": "function",
             "path": "docforge.servers.mcp_server.MCPServer.run",
-            "signature": "<bound method Function.signature of Function('run', 140, 152)>",
+            "signature": "run(transport: Literal['stdio', 'sse', 'streamable-http'] = 'streamable-http') -> None",
             "docstring": "Start the MCP server.\n\nArgs:\n    transport (Literal[\"stdio\", \"sse\", \"streamable-http\"]):\n        Transport mechanism used by the MCP server. Supported options\n        include `stdio`, `sse`, and `streamable-http`."
           }
         }

docs/mkdocs.wiki.yml

@@ -56,18 +56,19 @@ extra_css:
 - https://unpkg.com/dracula-prism/dist/css/dracula-prism.css
 plugins:
 - search
+- docforge-linkfix
 site_name: doc-forge
 docs_dir: wiki
 site_dir: ../site/wiki
 nav:
 - Home: index.md
 - Overview: 01_overview.md
-- Architecture: 02_architecture.md
+- Components: 02_components.md
 - Conventions: 03_conventions.md
 - Iterative Workflow: 04_iterative_workflow.md
 - Development:
   - Environment: 05_development/01_environment.md
   - Quality Gates: 05_development/02_quality_gates.md
-  - Gsdfc Guide: 05_development/03_gsdfc_guide.md
+  - GSDFC Guide: 05_development/03_gsdfc_guide.md
-  - Mcp Guide: 05_development/04_mcp_guide.md
+  - MCP Guide: 05_development/04_mcp_guide.md
-  - Mkdocs Configs: 05_development/05_mkdocs_configs.md
+  - MkDocs Configs: 05_development/05_mkdocs_configs.md

docs/wiki/01_overview.md

@@ -1,10 +1,12 @@
-# Overview
+# Library Overview
 
 `docforge` turns GSDFC-compliant Python docstrings into maintainable reference
 documentation. It never edits source docstrings; it reads them, renders them,
 and assembles documentation sites from all available material.
 
-## What it generates
+---
+
+## 🧭 Which Build Should You Use?
 
 | Kind      | Source                     | Output                          |
 |-----------|----------------------------|---------------------------------|
@@ -13,7 +15,9 @@ and assembles documentation sites from all available material.
 | `wiki`    | Hand-written markdown      | `docs/wiki/**` (unchanged)      |
 | `mcp`     | GSDFC docstrings + renderers | `docs/mcp/**` structured JSON |
 
-## Per-kind MkDocs builds
+---
+
+## 🏗️ Architecture
 
 Each enabled site kind produces its own MkDocs configuration and build:
 
@@ -25,8 +29,15 @@ Every site is self-contained (own theme assets and search index) with
 navigation derived or scoped to that kind. Hand-written wiki content is never
 overwritten or regenerated — only its navigation is derived automatically.
 
-## MCP bundle
+---
+
+## 🔄 Lifecycle Rules
 
 `docs/mcp/**` is a self-contained, machine-readable reference generated from
 docforge's own GSDFC docstrings. `doc-forge serve --mcp --module docforge`
-serves it over MCP. See the [MCP Guide](05_development/04_mcp_guide.md).
+serves it over MCP. See the [MCP Guide](05_development/04_mcp_guide.md).
+
+---
+
+## ➡️ Read Next
+- [02 – Components](02_components.md) · [03 – Conventions](03_conventions.md)

docs/wiki/02_components.md

@@ -1,35 +1,45 @@
-# Architecture
+# Components
 
 `docforge` is split into four horizontal layers. Everything flows top to
 bottom through the CLI.
 
-## Loaders → Models
+---
+
+## 1. Loaders & Models
 
 The `docforge/loaders` package wraps `griffe` to extract modules, functions,
 classes, and Google-style docstring sections. Loaded data is normalized into
 the object model under `docforge/models` (`Project`, `Module`, `DocObject`).
 
-## Navigation
+---
+
+## 2. Navigation
 
 `docforge/nav` parses `docforge.nav.yml` specs (`NavSpec`, `Resolver`, and the
 MkDocs nav emitter) and, since the wiki kind, derives wiki navigation from the
 file structure via `build_wiki_nav`.
 
-## Renderers
+---
+
+## 3. Renderers
 
 `docforge/renderers` turn model data into artifacts:
 
 - `MkDocsRenderer` → `docs/lib/**` reference markdown
 - `MCPRenderer` → `docs/mcp/**` structured documentation
 
-## Servers
+---
+
+## 4. Servers
 
 `docforge/servers` serves generated artifacts over live protocols:
 
 - `MCPServer` → serves a pre-generated `docs/mcp/**` bundle through MCP
   resources (`docs://index`, `docs://nav`, `docs://modules/{module}`)
 
-## CLI
+---
+
+## 5. CLI
 
 `docforge/cli` wires it all together:
 
@@ -37,4 +47,9 @@ file structure via `build_wiki_nav`.
   / `--mcp` modes
 - `mkdocs_utils.py` — per-kind config generation (`docs/mkdocs.{lib,api,wiki}.yml`)
   with navigation re-rooted to each kind's `docs_dir`
-- `api_utils.py` — OpenAPI loading and API docs generation
+- `api_utils.py` — OpenAPI loading and API docs generation
+
+---
+
+## Related
+- [01 – Overview](01_overview.md) · [03 – Conventions](03_conventions.md)

docs/wiki/03_conventions.md

@@ -1,5 +1,7 @@
 # Conventions
 
+---
+
 ## GSDFC docstrings
 
 All documented source uses the Google-Styled Doc-Forge Convention (GSDFC):
@@ -12,31 +14,45 @@ package docstring, which is exported verbatim into
 
 Key rules:
 
-- Use parenthesized types in prose entries (`name (Type):`) that match the
+1. Use parenthesized types in prose entries (`name (Type):`) that match the
-  signature types.
+   signature types.
-- Use `# Summary`, `# Examples`, and `# Notes` sections at module level.
+2. Use `# Summary`, `# Examples`, and `# Notes` sections at module level.
-- Use `Args:`, `Returns:`, `Raises:`, `Yields:`, `Notes:`, and `Example:`
+3. Use `Args:`, `Returns:`, `Raises:`, `Yields:`, `Notes:`, and `Example:`
-  sections at function and method level.
+   sections at function and method level.
-- Always update the matching `.pyi` stub alongside the `.py` implementation.
+4. Always update the matching `.pyi` stub alongside the `.py` implementation.
+5. Every distributable package ships a `py.typed` marker so type checkers
+   consume the authored signatures instead of `Any`.
 
-## `.pyi` stubs
+---
+
+## `.pyi` stubs and `py.typed`
 
 Every module ships a matching `.pyi` stub kept in sync with the `.py`
-implementation. When signatures change, update both files.
+implementation. When signatures change, update both files. Packages expose a
+`py.typed` marker so consumers and type checkers use the authored signatures.
+
+---
 
 ## Wiki pages
 
-- Hand-written markdown lives in `docs/wiki/**` and is never generated.
+1. Hand-written markdown lives in `docs/wiki/**` and is never generated.
-- File names use a numeric prefix: `01_overview.md`, `02_architecture.md`.
+2. File names use a numeric prefix: `01_overview.md`, `02_components.md`.
-- Nested directories become nested navigation groups:
+3. Nested directories become nested navigation groups:
-  `05_development/01_environment.md` → group *Development*.
+   `05_development/01_environment.md` → group *Development*.
-- `index.md` is the site `Home` at the root, and a section root inside a
+4. `index.md` is the site `Home` at the root, and a section root inside a
-  directory.
+   directory.
-- Navigation labels are derived by stripping the numeric prefix and applying
+5. Navigation labels are derived by stripping the numeric prefix and applying
-  title case on the remaining words.
+   title case on the remaining words.
+
+---
 
 ## Templates
 
 MkDocs config fragments live in `docforge/templates`. The `mkdocs.wiki.yml`
 fragment carries only the `search` plugin, since wiki pages contain no
-mkdocstrings directives.
+mkdocstrings directives.
+
+---
+
+## Related
+- [02 – Components](02_components.md) · [04 – Iterative Workflow](04_iterative_workflow.md)

docs/wiki/04_iterative_workflow.md

@@ -2,7 +2,9 @@
 
 A docs build runs through the CLI in a single pass.
 
-## Build commands
+---
+
+## 🚀 Build commands
 
 ```bash
 # Library reference only
@@ -18,7 +20,9 @@ doc-forge build --wiki --site-name docforge
 doc-forge build --mcp --module docforge
 ```
 
-## What a build does
+---
+
+## 🔄 What a build does
 
 1. Validates the requested modes (`--mkdocs`, `--api`, `--wiki`, `--mcp`).
 2. Generates library sources under `docs/lib/**` with `MkDocsRenderer`.
@@ -29,7 +33,9 @@ doc-forge build --mcp --module docforge
 6. Runs `mkdocs build` once per config, emitting self-contained sites
    `site/lib/`, `site/api/`, and `site/wiki/`.
 
-## Explore the sites
+---
+
+## 🧭 Explore the sites
 
 ```bash
 doc-forge build --wiki --mkdocs --module docforge
@@ -40,9 +46,16 @@ doc-forge serve --api
 doc-forge serve --mkdocs --mkdocs-yml docs/mkdocs.wiki.yml
 ```
 
-## Serve the MCP bundle
+---
+
+## 📦 Serve the MCP bundle
 
 ```bash
 doc-forge build --mcp --module docforge
 doc-forge serve --mcp --module docforge
-```
+```
+
+---
+
+## Related
+- [03 – Conventions](03_conventions.md) · [01 – Environment](05_development/01_environment.md)

docs/wiki/05_development/01_environment.md

@@ -1,6 +1,8 @@
 # Environment Setup
 
-## Create the environment
+---
+
+## 🚀 Create the environment
 
 ```bash
 python -m venv .venv
@@ -10,7 +12,9 @@ pip install -e .
 
 Requires Python 3.10+ (per `pyproject.toml`).
 
-## Dependencies
+---
+
+## 📦 Dependencies
 
 Development extras include:
 
@@ -18,4 +22,9 @@ Development extras include:
 - `ruff` — lint and format checking
 - `black` — auto-formatting
 - `mypy` — strict typing checks
-- `pydoclint` — docstring ↔ signature consistency checks
+- `pydoclint` — docstring ↔ signature consistency checks
+
+---
+
+## Related
+- [04 – Iterative Workflow](../04_iterative_workflow.md) · [02 – Quality Gates](02_quality_gates.md)

docs/wiki/05_development/02_quality_gates.md

@@ -2,6 +2,10 @@
 
 Run all checks before pushing:
 
+---
+
+## 🚀 Commands
+
 ```bash
 .venv\Scripts\python.exe -m pytest
 .venv\Scripts\python.exe -m ruff check docforge tests
@@ -10,7 +14,9 @@ Run all checks before pushing:
 .venv\Scripts\pydoclint.exe docforge
 ```
 
-## Test layout
+---
+
+## 📁 Test layout
 
 | Path                     | Covers                             |
 |--------------------------|------------------------------------|
@@ -20,4 +26,9 @@ Run all checks before pushing:
 
 CLI tests use the `cli_runner` fixture with `mock_mkdocs_build` and
 `mock_mkdocs_load_config` so they exercise the full flow without invoking a
-real MkDocs build.
+real MkDocs build.
+
+---
+
+## Related
+- [01 – Environment](01_environment.md) · [03 – GSDFC Guide](03_gsdfc_guide.md)

docs/wiki/05_development/03_gsdfc_guide.md

@@ -5,7 +5,9 @@ in the `docforge/__init__.py` package docstring. It describes how to write
 docstrings that render correctly in MkDocs and stay machine-parseable by
 doc-forge, MkDocs, and MCP clients.
 
-## Overview
+---
+
+## 🧭 Overview
 
 - Docstrings are the single source of truth.
 - `doc-forge` compiles docstrings but never rewrites them.
@@ -13,7 +15,9 @@ doc-forge, MkDocs, and MCP clients.
 - Type hints live in signatures; prose entries repeat the type in
   parentheses and must match the signature.
 
-## Module docstrings
+---
+
+## 📦 Module docstrings
 
 Modules use Markdown headings and `---` separators.
 
@@ -23,7 +27,9 @@ Recommended sections:
 - `# Examples` — a representative usage snippet
 - `# Notes` — guarantees, lifecycle, and thread-safety notes
 
-## Class docstrings
+---
+
+## 📦 Class docstrings
 
 Recommended sections, in order:
 
@@ -32,7 +38,9 @@ Recommended sections, in order:
 - `Notes:` — grouped subsections such as **Guarantees**, **Lifecycle**
 - `Example:` — indented `python` code block
 
-## Function and method docstrings
+---
+
+## 📦 Function and method docstrings
 
 Recommended section order:
 
@@ -53,12 +61,16 @@ Formatting rules:
 - Fenced `python` blocks are allowed inside `Example:` sections, indented
   four spaces.
 
-## Property docstrings
+---
+
+## 📦 Property docstrings
 
 Properties document their return values with a `Returns:` section and, when
 meaningful, an `Example:`.
 
-## Example
+---
+
+## 🚀 Example
 
 ```python
 def process(foo: Foo, multiplier: int) -> int:
@@ -90,13 +102,17 @@ def process(foo: Foo, multiplier: int) -> int:
     """
 ```
 
-## Keeping stubs in sync
+---
+
+## 🔄 Keeping stubs in sync
 
 Every `.py` module ships a matching `.pyi` stub. When a signature or a public
 symbol changes, update both files. Signature annotations in the stub must
 match the implementation.
 
-## Enforcement
+---
+
+## 🛡️ Enforcement
 
 `pydoclint` (Google style) runs in CI and verifies that `Args:`/`Returns:`
 sections match function signatures, including types.
@@ -105,4 +121,9 @@ sections match function signatures, including types.
 - `skip-checking-raises = true` — `Raises:` sections are descriptive and are
   not required to map to literal `raise` statements.
 - `check-class-attributes = false` — `Attributes:` sections document instance
-  attributes without class-level annotations.
+  attributes without class-level annotations.
+
+---
+
+## Related
+- [02 – Quality Gates](02_quality_gates.md) · [04 – MCP Guide](04_mcp_guide.md)

docs/wiki/05_development/04_mcp_guide.md

@@ -5,7 +5,9 @@ GSDFC docstrings and serve that bundle over the Model Context Protocol (MCP).
 The bundle is self-contained: readers can derive the full API reference —
 signatures, docstrings, and structure — for the documented project.
 
-## Building the bundle
+---
+
+## 🚀 Building the bundle
 
 ```bash
 doc-forge build --mcp --module docforge
@@ -17,7 +19,9 @@ This writes structured JSON into `docs/mcp/`:
 - `nav.json` — module list with `docs://modules/{module}` resource URIs
 - `modules/{dotted.path}.json` — per-module serialized documentation
 
-## Serving the bundle
+---
+
+## 🚀 Serving the bundle
 
 ```bash
 doc-forge serve --mcp --module docforge
@@ -36,7 +40,9 @@ Missing resources are returned as structured error dictionaries rather than
 exceptions. The default transport is `streamable-http`; `stdio` and `sse` are
 supported via `MCPServer.run`.
 
-## Bundle contents
+---
+
+## 📦 Bundle contents
 
 Each module resource contains:
 
@@ -48,4 +54,9 @@ Each module resource contains:
 Because the bundle is generated from docstrings, the quality of the bundle
 equals the quality of the project's GSDFC docstrings. For docforge itself,
 the GSDFC specification is carried in `modules/docforge.json` via the
-`docforge/__init__.py` package docstring, making the bundle self-documenting.
+`docforge/__init__.py` package docstring, making the bundle self-documenting.
+
+---
+
+## Related
+- [03 – GSDFC Guide](03_gsdfc_guide.md) · [05 – MkDocs Configs](05_mkdocs_configs.md)

docs/wiki/05_development/05_mkdocs_configs.md

@@ -5,7 +5,9 @@ repo that documents kind `{kind}` carries a config at `docs/mkdocs.{kind}.yml`
 that sets `docs_dir` to the kind's source directory and `site_dir` to
 `../site/{kind}`.
 
-## File wins
+---
+
+## 📄 File wins
 
 `docs/mkdocs.{kind}.yml` is a repo-owned file, not a build byproduct:
 
@@ -19,7 +21,9 @@ that sets `docs_dir` to the kind's source directory and `site_dir` to
 Because a present file is never rewritten, rerunning a build is a no-op for
 versioned configs: the working tree stays clean.
 
-## Templates
+---
+
+## 🧩 Templates
 
 The built-in defaults live in `docforge/templates/`:
 
@@ -36,7 +40,9 @@ kind fragment, then filling in generation-time values (`site_name`,
 theme `icon` from `docforge.nav.yml`). Pass `--template <path>` to replace the
 built-in templates entirely.
 
-## Supported layouts
+---
+
+## 🏗️ Supported layouts
 
 - **Per-kind config** — the standard layout; each kind builds to
   `site/{kind}` and is served under `/<repo>/{kind}/`.
@@ -45,4 +51,24 @@ built-in templates entirely.
   doc-forge never reads or writes root `mkdocs.yml`; the docs service maps the
   kind to the root `site/` dir in this case.
 
-Commit `docs/mkdocs.{kind}.yml` so served docs are reproducible from source.
+Commit `docs/mkdocs.{kind}.yml` so served docs are reproducible from source.
+
+---
+
+## 🔗 Cross-kind links
+
+Kinds are separate MkDocs sites served side by side under `/<repo>/<kind>/`,
+so a wiki page may link to the library reference with a source-relative path
+such as `../lib/13_library_registry/`. MkDocs only rewrites links that point
+inside `docs_dir`; anything reaching a sibling kind is emitted verbatim and,
+under `use_directory_urls`, resolves into `<kind>/<kind>/` and breaks.
+
+The `docforge-linkfix` plugin (part of doc-forge, enabled in the wiki
+template) fixes this at render time: it rewrites `../lib/`, `../api/`, and
+`../wiki/` links to climb to the repository root, so they resolve correctly
+however deeply the page is nested.
+
+---
+
+## Related
+- [04 – MCP Guide](04_mcp_guide.md)

docs/wiki/index.md

@@ -1,9 +1,10 @@
-# 🔨 docforge — Docstring-Driven Documentation Forge
+# 🧩 docforge — Docstring-Driven Documentation Forge
 
-`docforge` is an internal documentation tool that generates reference
+`docforge` is an internal documentation tool that generates reference documentation from Google-Styled Doc-Forge Convention (GSDFC) docstrings and assembles it into per-kind MkDocs sites, alongside hand-written wiki pages and OpenAPI-based API docs.
-documentation from Google-Styled Doc-Forge Convention (GSDFC) docstrings and
+
-assembles it into per-kind MkDocs sites, alongside hand-written wiki pages and
+> **Doc model:** this wiki is written for humans — how‑to guides, examples,
-OpenAPI-based API docs.
+> and testing recipes. The authoritative API contracts live in the code
+> (docstrings) and the machine‑readable bundle under `docs/mcp/`.
 
 ---
 
@@ -17,17 +18,28 @@ OpenAPI-based API docs.
 
 ---
 
+## 📦 Installation
+
+```bash
+# Internal PyPI (TBD)
+pip install docforge
+```
+
+---
+
 ## 📁 Documentation Structure
 
 | Section                                      | Description                                        |
 |----------------------------------------------| -------------------------------------------------- |
 | [Overview](01_overview.md)                   | What docforge is and how it fits the pipeline      |
-| [Architecture](02_architecture.md)           | Loaders, models, nav, renderers, CLI, servers     |
+| [Components](02_components.md)           | Loaders, models, nav, renderers, CLI, servers     |
 | [Conventions](03_conventions.md)             | GSDFC, `.pyi` stubs, and template conventions      |
 | [Iterative Workflow](04_iterative_workflow.md) | How a docs build runs end to end                  |
-| [Development](05_development/01_environment.md) | Environment setup and quality gates              |
+| [Environment](05_development/01_environment.md) | Environment setup                              |
-| [Docstring Guide](05_development/03_gsdfc_guide.md) | How to write GSDFC-conformant docstrings        |
+| [Quality Gates](05_development/02_quality_gates.md) | Test layout and quality checks             |
+| [GSDFC Guide](05_development/03_gsdfc_guide.md) | How to write GSDFC-conformant docstrings        |
 | [MCP Guide](05_development/04_mcp_guide.md)  | Building, serving, and consuming the MCP bundle   |
+| [MkDocs Configs](05_development/05_mkdocs_configs.md) | MkDocs config generation and templates             |
 
 ---
 
@@ -35,14 +47,19 @@ OpenAPI-based API docs.
 
 - **Source Code:** the `doc-forge` repository
 - **MCP Bundle:** generated by `doc-forge build --mcp --module docforge` into `docs/mcp/`
-- **Wiki Kind:** hand-written content lives in `docs/wiki/` or use the prompt mentioned below
+- **Wiki Kind:** hand-written content lives in `docs/wiki/`; use the prompt in the
+  wiki-related resource below
 ````markdown
 # AGENTS.md — Wiki Authoring Guide (Aetoskia)
 
 This file instructs AI agents how to create, extend, and maintain the wiki
-(`docs/wiki/**`) for any Aetoskia repository. The reference implementation is
+(`docs/wiki/**`) for any Aetoskia repository.
-`mongo-ops` — its wiki went through several revisions to reach the structure
+
-below and should be treated as the canonical example.
+> **Workflow:** this prompt covers **phase 2 only**. Phase 1 — writing GSDFC docstrings
+> (plus `.pyi` stubs and `py.typed`) — is done by the agent using the doc-forge MCP
+> bundle: `doc://modules/docforge` carries the full GSDFC spec. Write the wiki only
+> after docstrings exist and `doc-forge build --mcp --module <pkg>` produced the
+> repo's own bundle.
 
 ---
 
@@ -249,6 +266,10 @@ Variants:
 - Keep pages focused: one recipe/purpose per page. If a page balloons past
   ~10 KB, split it (add a numbered deep-dive page instead).
 - Match tone of existing pages in the repo before writing new ones.
+- Ground every `## 🚀 Example`, `💡 Tips`, and `📦 What's New?` row in the
+  library's actual source, tests, and its `docs/mcp` bundle — never invent
+  APIs or behavior. Signatures and exceptions come from the code; gotchas
+  come from the tests.
 
 ---
 
@@ -301,4 +322,4 @@ Verification checklist:
 ````
 ---
 
-© Aetoskia Internal
+© Aetoskia Internal — `docforge` 1.0

pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "doc-forge"
-version = "0.0.6"
+version = "0.0.8"
 description = "A renderer-agnostic Python documentation compiler"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -56,6 +56,9 @@ dependencies = [
 [project.scripts]
 doc-forge = "docforge.cli.main:main"
 
+[project.entry-points."mkdocs.plugins"]
+docforge-linkfix = "docforge.mkdocs_links:LinkFixPlugin"
+
 [project.optional-dependencies]
 mkdocs = [
     "mkdocs==1.6.1",
@@ -87,6 +90,7 @@ dev = [
     "build>=1.0.0",
     "twine>=4.0.0",
     "pre-commit>=3.4.0",
+    "doc-forge[mkdocs,mcp]",
 ]
 docs = [
     "doc-forge[mkdocs]",

tests/cli/test_mkdocs_links.py

@@ -0,0 +1,55 @@
+from types import SimpleNamespace
+
+from docforge.mkdocs_links import LinkFixPlugin
+
+
+def _page(dest_uri: str):
+    return SimpleNamespace(file=SimpleNamespace(dest_uri=dest_uri))
+
+
+def _fix(markdown: str, dest_uri: str) -> str:
+    return LinkFixPlugin().on_page_markdown(
+        markdown,
+        page=_page(dest_uri),
+        config=SimpleNamespace(),
+        files=SimpleNamespace(),
+    )
+
+
+def test_root_page_keeps_single_parent():
+    src = "[lib](../lib/pkg/index.md)"
+    assert _fix(src, "index.html") == src
+
+
+def test_nested_page_adds_directory_depth():
+    assert _fix("[lib](../lib/pkg/index.md)", "01_overview/index.html") == (
+        "[lib](../../lib/pkg/index.md)"
+    )
+
+
+def test_deeply_nested_page_adds_two_levels():
+    src = "[lib](../lib/pkg/index.md)"
+    got = _fix(src, "04_development/02_releasing/index.html")
+    assert got == "[lib](../../../lib/pkg/index.md)"
+
+
+def test_multiple_cross_kind_links_are_rebased():
+    src = "See [a](../lib/a) and [b](../api/b)."
+    got = _fix(src, "01_overview/index.html")
+    assert got == "See [a](../../lib/a) and [b](../../api/b)."
+
+
+def test_wiki_kind_is_rebased():
+    assert _fix("[w](../wiki/index.md)", "01_overview/index.html") == (
+        "[w](../../wiki/index.md)"
+    )
+
+
+def test_relative_within_kind_untouched():
+    src = "[next](02_install.md) and [prev](../index.md)"
+    assert _fix(src, "01_overview/index.html") == src
+
+
+def test_absolute_and_url_links_untouched():
+    src = "[site](https://example.com/lib/x) and [root](/lib/x) and [r](lib/x)"
+    assert _fix(src, "a/index.html") == src

tests/renderers/mcp/test_mcp_signatures.py

@@ -0,0 +1,73 @@
+import json
+from pathlib import Path
+
+from docforge import MCPRenderer
+from docforge.loaders import GriffeLoader, discover_module_paths
+
+
+def _load_docforge_bundle(tmp_path: Path) -> Path:
+    project_root = Path(__file__).resolve().parents[3]
+    loader = GriffeLoader()
+    paths = discover_module_paths("docforge", project_root=project_root)
+    project = loader.load_project(paths)
+
+    out_dir = tmp_path / "mcp"
+    MCPRenderer().generate_sources(project, out_dir)
+    return out_dir
+
+
+def test_mcp_signatures_are_clean(tmp_path: Path) -> None:
+    out_dir = _load_docforge_bundle(tmp_path)
+
+    object_payload = json.loads(
+        (out_dir / "modules" / "docforge.models.object.json").read_text(
+            encoding="utf-8"
+        )
+    )
+
+    cls = object_payload["content"]["objects"]["DocObject"]
+    assert isinstance(cls["signature"], str)
+    assert "bound method" not in cls["signature"]
+    assert cls["signature"].startswith("DocObject(")
+
+    renderer_payload = json.loads(
+        (out_dir / "modules" / "docforge.renderers.mcp_renderer.json").read_text(
+            encoding="utf-8"
+        )
+    )
+
+    method = renderer_payload["content"]["objects"]["MCPRenderer"]["members"][
+        "generate_sources"
+    ]
+    assert isinstance(method["signature"], str)
+    assert "bound method" not in method["signature"]
+    assert method["signature"].startswith("generate_sources(")
+
+
+def test_mcp_skips_unresolvable_import_aliases(tmp_path: Path) -> None:
+    out_dir = _load_docforge_bundle(tmp_path)
+
+    renderer_payload = json.loads(
+        (out_dir / "modules" / "docforge.renderers.mcp_renderer.json").read_text(
+            encoding="utf-8"
+        )
+    )
+
+    object_names = set(renderer_payload["content"]["objects"])
+    assert "json" not in object_names
+    assert "Path" not in object_names
+
+
+def test_mcp_keeps_resolvable_package_reexports(tmp_path: Path) -> None:
+    out_dir = _load_docforge_bundle(tmp_path)
+
+    root_payload = json.loads(
+        (out_dir / "modules" / "docforge.json").read_text(encoding="utf-8")
+    )
+
+    discover = root_payload["content"]["objects"]["discover_module_paths"]
+    assert discover["name"] == "discover_module_paths"
+    assert isinstance(discover["signature"], str)
+    assert "bound method" not in discover["signature"]
+    assert discover["signature"].startswith("discover_module_paths(")
+    assert discover["docstring"] is not None