chore(release): 0.0.7

Squash-merge lib-standardisation: adopt repo standards across packaging,
tooling, docs, and CI.

- standardize pyproject.toml (canonical packaging, lint config, extras, GSDFC pydoclint)
- add py.typed marker, modernize type hints and Google-style docstrings
- nest generated docs under docs/lib and docs/mcp; add hand-written wiki
- adopt standard Type A PyPI CI pipeline (tag==version guard + quality gate)
- promote generated CHANGELOG.md; bump version to 0.0.7

tests/cli/test_build_api.py

@@ -0,0 +1,142 @@
+import json
+from pathlib import Path
+
+from docforge.cli.main import cli
+
+
+def _write_spec(cwd, title="Aetoskia Auth Server", description="Auth docs"):
+    spec = {
+        "openapi": "3.1.0",
+        "info": {
+            "title": title,
+            "description": description,
+            "contact": {
+                "name": "Aetoskia Dev Team",
+                "email": "dev@aetoskia.com",
+            },
+            "version": "0.0.5",
+        },
+        "paths": {},
+    }
+    path = cwd / "openapi.json"
+    path.write_text(json.dumps(spec), encoding="utf-8")
+    return path
+
+
+def test_api_build_full_flow(
+    cli_runner,
+    mock_mkdocs_build,
+    mock_mkdocs_load_config,
+):
+    with cli_runner.isolated_filesystem():
+        cwd = Path.cwd()
+
+        spec_path = _write_spec(cwd)
+
+        nav_file = cwd / "docforge.nav.yml"
+        nav_file.write_text(
+            "home: api/index.md\ngroups: {}\n"
+            "icon:\n"
+            "  logo: material/database\n"
+            "  repo: fontawesome/brands/github\n",
+            encoding="utf-8",
+        )
+
+        result = cli_runner.invoke(
+            cli,
+            ["build", "--api", "--openapi-spec", str(spec_path)],
+        )
+
+        assert result.exit_code == 0, result.output
+        assert mock_mkdocs_build() is True
+
+        api_dir = cwd / "docs" / "api"
+        assert (api_dir / "openapi.json").exists()
+        index = (api_dir / "index.md").read_text(encoding="utf-8")
+        assert '<swagger-ui src="openapi.json"/>' in index
+
+        config = (cwd / "docs" / "mkdocs.api.yml").read_text(encoding="utf-8")
+        assert "docs_dir: api" in config
+        assert "site_dir: ../site/api" in config
+        assert "- API Reference: index.md" in config
+        assert "site_name: Aetoskia Auth Server" in config
+        assert "site_description: Auth docs" in config
+        assert "site_author: Aetoskia Dev Team" in config
+        assert "swagger-ui-tag" in config
+        assert "logo: material/database" in config
+        assert "repo: fontawesome/brands/github" in config
+
+
+def test_api_build_missing_spec_fails(cli_runner):
+    result = cli_runner.invoke(cli, ["build", "--api"])
+    assert result.exit_code != 0
+    assert "--openapi-spec is required" in result.output
+
+
+def test_api_build_spec_not_found(cli_runner):
+    result = cli_runner.invoke(cli, ["build", "--api", "--openapi-spec", "nope.json"])
+    assert result.exit_code != 0
+    assert "OpenAPI spec not found" in result.output
+
+
+def test_api_build_rejects_site_name_override(cli_runner):
+    with cli_runner.isolated_filesystem():
+        cwd = Path.cwd()
+        spec_path = _write_spec(cwd)
+
+        result = cli_runner.invoke(
+            cli,
+            ["build", "--api", "--openapi-spec", str(spec_path), "--site-name", "X"],
+        )
+        assert result.exit_code != 0
+        assert "cannot be overridden" in result.output
+
+
+def test_api_build_combined_with_mkdocs_emits_separate_configs(
+    cli_runner, mock_mkdocs_build, mock_mkdocs_load_config
+):
+    with cli_runner.isolated_filesystem():
+        cwd = Path.cwd()
+
+        pkg = cwd / "testpkg"
+        pkg.mkdir()
+        (pkg / "__init__.py").write_text("")
+        (pkg / "mod.py").write_text("def f(): ...\n")
+
+        spec_path = _write_spec(cwd)
+
+        nav_file = cwd / "docforge.nav.yml"
+        nav_file.write_text("home: lib/testpkg/index.md\ngroups: {}\n")
+
+        result = cli_runner.invoke(
+            cli,
+            [
+                "build",
+                "--mkdocs",
+                "--api",
+                "--module",
+                "testpkg",
+                "--openapi-spec",
+                str(spec_path),
+            ],
+        )
+
+        assert result.exit_code == 0, result.output
+
+        lib_config = cwd / "docs" / "mkdocs.lib.yml"
+        api_config = cwd / "docs" / "mkdocs.api.yml"
+        assert lib_config.exists()
+        assert api_config.exists()
+
+        lib_text = lib_config.read_text(encoding="utf-8")
+        assert "docs_dir: lib" in lib_text
+        assert "site_dir: ../site/lib" in lib_text
+        assert "Home: testpkg/index.md" in lib_text
+
+        api_text = api_config.read_text(encoding="utf-8")
+        assert "docs_dir: api" in api_text
+        assert "site_dir: ../site/api" in api_text
+        assert "- API Reference: index.md" in api_text
+        assert "site_name: Aetoskia Auth Server" in api_text
+        assert "swagger-ui-tag" in api_text
+        assert "mkdocstrings" in lib_text

tests/cli/test_build_mcp.py

@@ -1,6 +1,8 @@
 from pathlib import Path
+
 from docforge.cli.main import cli
 
+
 def test_mcp_build(cli_runner):
     with cli_runner.isolated_filesystem():
         cwd = Path.cwd()
@@ -9,7 +11,7 @@ def test_mcp_build(cli_runner):
         (pkg / "__init__.py").write_text("")
         (pkg / "mod.py").write_text("def f(): ...\n")
 
-        out_dir = cwd / "mcp_docs"
+        out_dir = cwd / "docs" / "mcp"
 
         result = cli_runner.invoke(
             cli,
@@ -18,8 +20,6 @@ def test_mcp_build(cli_runner):
                 "--mcp",
                 "--module",
                 "testpkg",
-                "--out-dir",
-                str(out_dir),
             ],
         )
 

tests/cli/test_build_mkdocs.py

@@ -1,6 +1,8 @@
 from pathlib import Path
+
 from docforge.cli.main import cli
 
+
 def test_mkdocs_build_full_flow(
     cli_runner,
     mock_mkdocs_build,
@@ -16,12 +18,8 @@ def test_mkdocs_build_full_flow(
         (pkg / "mod.py").write_text("def f(): ...\n")
 
         nav_file = cwd / "docforge.nav.yml"
-        nav_file.write_text("home: testpkg/index.md\ngroups: {}\n")
-        
-        # We need to create a dummy testpkg/index.md for nav resolution if it's there
-        # But generate_sources will create it. 
-        # Wait, the current logic runs generate_sources first, THEN generate_config.
-        
+        nav_file.write_text("home: lib/testpkg/index.md\ngroups: {}\n")
+
         result = cli_runner.invoke(
             cli,
             [
@@ -31,23 +29,27 @@ def test_mkdocs_build_full_flow(
                 "testpkg",
                 "--site-name",
                 "Test Site",
-                "--docs-dir",
-                "docs",
-                "--mkdocs-yml",
-                "mkdocs.yml",
             ],
         )
 
         assert result.exit_code == 0
         assert mock_mkdocs_build() is True
-        assert (cwd / "mkdocs.yml").exists()
-        assert (cwd / "docs" / "testpkg" / "mod.md").exists()
+
+        config = cwd / "docs" / "mkdocs.lib.yml"
+        assert config.exists()
+        assert (cwd / "docs" / "lib" / "testpkg" / "mod.md").exists()
+        content = config.read_text(encoding="utf-8")
+        assert "docs_dir: lib" in content
+        assert "site_dir: ../site/lib" in content
+        assert "Home: testpkg/index.md" in content
+
 
 def test_mkdocs_build_missing_module_fails(cli_runner):
     result = cli_runner.invoke(cli, ["build", "--mkdocs", "--site-name", "Test"])
     assert result.exit_code != 0
     assert "--module is required" in result.output
 
+
 def test_mkdocs_build_without_site_name_uses_module_as_default_full_flow(
     cli_runner,
     mock_mkdocs_build,
@@ -63,37 +65,98 @@ def test_mkdocs_build_without_site_name_uses_module_as_default_full_flow(
         (pkg / "__init__.py").write_text("")
         (pkg / "mod.py").write_text("def f(): ...\n")
 
-        # Create nav spec expected by generate_config
+        # Create nav spec expected by build_lib_nav
         nav_file = cwd / "docforge.nav.yml"
         nav_file.write_text(
-            "home: testpkg/index.md\ngroups: {}\n",
+            "home: lib/testpkg/index.md\ngroups: {}\n",
             encoding="utf-8",
         )
 
         result = cli_runner.invoke(
             cli,
-            [
-                "build",
-                "--mkdocs",
-                "--module",
-                "testpkg",
-                "--docs-dir",
-                "docs",
-                "--mkdocs-yml",
-                "mkdocs.yml",
-            ],
+            ["build", "--mkdocs", "--module", "testpkg"],
         )
 
         assert result.exit_code == 0
         assert mock_mkdocs_build() is True
 
-        # MkDocs config must exist
-        mkdocs_yml = cwd / "mkdocs.yml"
-        assert mkdocs_yml.exists()
+        # The per-kind MkDocs config must exist
+        config = cwd / "docs" / "mkdocs.lib.yml"
+        assert config.exists()
 
         # Site name must default to module name
-        content = mkdocs_yml.read_text()
+        content = config.read_text(encoding="utf-8")
         assert "site_name: testpkg" in content
 
-        # Docs must be generated
-        assert (cwd / "docs" / "testpkg" / "mod.md").exists()
+        # Docs must be generated under the nested docs/lib dir
+        assert (cwd / "docs" / "lib" / "testpkg" / "mod.md").exists()
+
+
+def test_existing_lib_config_used_verbatim_without_refresh(
+    cli_runner,
+    mock_mkdocs_build,
+    mock_mkdocs_load_config,
+):
+    with cli_runner.isolated_filesystem():
+        cwd = Path.cwd()
+        pkg = cwd / "testpkg"
+        pkg.mkdir()
+        (pkg / "__init__.py").write_text("")
+        (pkg / "mod.py").write_text("def f(): ...\n")
+
+        nav_file = cwd / "docforge.nav.yml"
+        nav_file.write_text(
+            "home: lib/testpkg/index.md\ngroups: {}\n",
+            encoding="utf-8",
+        )
+
+        config = cwd / "docs" / "mkdocs.lib.yml"
+        config.parent.mkdir(parents=True)
+        sentinel = "site_name: Custom Lib\nnav: []\n"
+        config.write_text(sentinel, encoding="utf-8")
+
+        result = cli_runner.invoke(
+            cli,
+            ["build", "--mkdocs", "--module", "testpkg"],
+        )
+
+        assert result.exit_code == 0, result.output
+        assert mock_mkdocs_build() is True
+        assert config.read_text(encoding="utf-8") == sentinel
+        assert "Using existing MkDocs config" in result.output
+
+
+def test_refresh_rebases_existing_lib_config(
+    cli_runner,
+    mock_mkdocs_build,
+    mock_mkdocs_load_config,
+):
+    with cli_runner.isolated_filesystem():
+        cwd = Path.cwd()
+        pkg = cwd / "testpkg"
+        pkg.mkdir()
+        (pkg / "__init__.py").write_text("")
+        (pkg / "mod.py").write_text("def f(): ...\n")
+
+        nav_file = cwd / "docforge.nav.yml"
+        nav_file.write_text(
+            "home: lib/testpkg/index.md\ngroups: {}\n",
+            encoding="utf-8",
+        )
+
+        config = cwd / "docs" / "mkdocs.lib.yml"
+        config.parent.mkdir(parents=True)
+        config.write_text("site_name: Stale\nnav: []\n", encoding="utf-8")
+
+        result = cli_runner.invoke(
+            cli,
+            ["build", "--mkdocs", "--module", "testpkg", "--refresh"],
+        )
+
+        assert result.exit_code == 0, result.output
+        assert mock_mkdocs_build() is True
+        content = config.read_text(encoding="utf-8")
+        assert "site_name: testpkg" in content
+        assert "docs_dir: lib" in content
+        assert "site_dir: ../site/lib" in content
+        assert "Home: testpkg/index.md" in content

tests/cli/test_build_wiki.py

@@ -0,0 +1,165 @@
+from pathlib import Path
+
+from docforge.cli.main import cli
+
+
+def test_wiki_only_build_requires_no_module(
+    cli_runner,
+    mock_mkdocs_build,
+    mock_mkdocs_load_config,
+):
+    with cli_runner.isolated_filesystem():
+        cwd = Path.cwd()
+
+        wiki = cwd / "docs" / "wiki"
+        wiki.mkdir(parents=True)
+        (wiki / "index.md").write_text("# Home", encoding="utf-8")
+        (wiki / "01_overview.md").write_text("# Overview", encoding="utf-8")
+
+        result = cli_runner.invoke(
+            cli,
+            [
+                "build",
+                "--wiki",
+                "--site-name",
+                "Wiki Site",
+            ],
+        )
+
+        assert result.exit_code == 0, result.output
+        assert mock_mkdocs_build() is True
+        config = cwd / "docs" / "mkdocs.wiki.yml"
+        assert config.exists()
+
+        content = config.read_text(encoding="utf-8")
+        assert "docs_dir: wiki" in content
+        assert "site_dir: ../site/wiki" in content
+        assert "Home: index.md" in content
+        assert "Overview: 01_overview.md" in content
+
+
+def test_wiki_and_mkdocs_emit_separate_configs(
+    cli_runner,
+    mock_mkdocs_build,
+    mock_mkdocs_load_config,
+):
+    with cli_runner.isolated_filesystem():
+        cwd = Path.cwd()
+
+        pkg = cwd / "testpkg"
+        pkg.mkdir()
+        (pkg / "__init__.py").write_text("")
+        (pkg / "mod.py").write_text("def f(): ...\n")
+
+        nav_file = cwd / "docforge.nav.yml"
+        nav_file.write_text(
+            "home: lib/testpkg/index.md\ngroups: {}\n",
+            encoding="utf-8",
+        )
+
+        wiki = cwd / "docs" / "wiki"
+        wiki.mkdir(parents=True)
+        (wiki / "index.md").write_text("# Home", encoding="utf-8")
+
+        result = cli_runner.invoke(
+            cli,
+            [
+                "build",
+                "--mkdocs",
+                "--wiki",
+                "--module",
+                "testpkg",
+                "--site-name",
+                "Split Site",
+            ],
+        )
+
+        assert result.exit_code == 0, result.output
+        assert mock_mkdocs_build() is True
+        assert (cwd / "docs" / "lib" / "testpkg" / "mod.md").exists()
+
+        lib_config = (cwd / "docs" / "mkdocs.lib.yml").read_text(encoding="utf-8")
+        wiki_config = (cwd / "docs" / "mkdocs.wiki.yml").read_text(encoding="utf-8")
+
+        assert "docs_dir: lib" in lib_config
+        assert "site_dir: ../site/lib" in lib_config
+        assert "Home: testpkg/index.md" in lib_config
+
+        assert "docs_dir: wiki" in wiki_config
+        assert "site_dir: ../site/wiki" in wiki_config
+        assert "Home: index.md" in wiki_config
+
+
+def test_wiki_without_module_flag_ok(
+    cli_runner,
+    mock_mkdocs_build,
+    mock_mkdocs_load_config,
+):
+    with cli_runner.isolated_filesystem():
+        cwd = Path.cwd()
+
+        wiki = cwd / "docs" / "wiki"
+        wiki.mkdir(parents=True)
+        (wiki / "index.md").write_text("# Home", encoding="utf-8")
+
+        result = cli_runner.invoke(
+            cli,
+            ["build", "--wiki", "--site-name", "S"],
+        )
+
+        assert result.exit_code == 0, result.output
+        assert mock_mkdocs_build() is True
+
+
+def test_wiki_existing_config_used_verbatim_without_refresh(
+    cli_runner,
+    mock_mkdocs_build,
+    mock_mkdocs_load_config,
+):
+    with cli_runner.isolated_filesystem():
+        cwd = Path.cwd()
+
+        wiki = cwd / "docs" / "wiki"
+        wiki.mkdir(parents=True)
+        (wiki / "index.md").write_text("# Home", encoding="utf-8")
+
+        config = cwd / "docs" / "mkdocs.wiki.yml"
+        sentinel = "site_name: Custom Wiki\nnav: []\n"
+        config.write_text(sentinel, encoding="utf-8")
+
+        result = cli_runner.invoke(
+            cli,
+            ["build", "--wiki", "--site-name", "Wiki Site"],
+        )
+
+        assert result.exit_code == 0, result.output
+        assert mock_mkdocs_build() is True
+        assert config.read_text(encoding="utf-8") == sentinel
+        assert "Using existing MkDocs config" in result.output
+
+
+def test_missing_wiki_dir_errors(cli_runner, mock_mkdocs_build):
+    with cli_runner.isolated_filesystem():
+        cwd = Path.cwd()
+        (cwd / "docs").mkdir()
+
+        result = cli_runner.invoke(
+            cli,
+            [
+                "build",
+                "--wiki",
+                "--site-name",
+                "S",
+                "--wiki-dir",
+                "docs/wiki",
+            ],
+        )
+
+        assert result.exit_code != 0
+        assert "Wiki dir not found" in result.output
+
+
+def test_no_flag_raises_usage_error(cli_runner):
+    result = cli_runner.invoke(cli, ["build"])
+    assert result.exit_code != 0
+    assert "--mcp, --mkdocs, --wiki, or --api" in result.output

tests/cli/test_mkdocs_utils.py

@@ -0,0 +1,79 @@
+import pytest
+from click.exceptions import FileError
+
+from docforge.cli.mkdocs_utils import (
+    _strip_scope,
+    build_lib_nav,
+    build_wiki_nav_block,
+    load_spec_icon,
+)
+
+
+def test_strip_scope_nested_entries():
+    block = [
+        {"Home": "wiki/index.md"},
+        {
+            "Development": [
+                {"Environment": "wiki/05_development/01_environment.md"},
+                "wiki/05_development/02_quality_gates.md",
+            ]
+        },
+    ]
+    stripped = _strip_scope(block, "wiki")
+    assert stripped == [
+        {"Home": "index.md"},
+        {
+            "Development": [
+                {"Environment": "05_development/01_environment.md"},
+                "05_development/02_quality_gates.md",
+            ]
+        },
+    ]
+
+
+def test_strip_scope_leaves_unscoped_paths():
+    block = [{"Other": "static/pages.md"}]
+    assert _strip_scope(block, "lib") == [{"Other": "static/pages.md"}]
+
+
+def test_build_lib_nav_reroots_group_paths(tmp_path):
+    docs = tmp_path / "docs"
+    lib = docs / "lib" / "testpkg"
+    lib.mkdir(parents=True)
+    (lib / "index.md").write_text("# Pkg", encoding="utf-8")
+    (lib / "mod.md").write_text("# Mod", encoding="utf-8")
+
+    nav_file = tmp_path / "docforge.nav.yml"
+    nav_file.write_text(
+        "home: lib/testpkg/index.md\n"
+        "groups:\n"
+        "  Reference:\n"
+        "    - lib/testpkg/mod.md\n",
+        encoding="utf-8",
+    )
+
+    block, icon = build_lib_nav(nav_file, docs)
+    assert block == [{"Home": "testpkg/index.md"}, {"Reference": ["testpkg/mod.md"]}]
+    assert icon is None
+
+
+def test_build_lib_nav_missing_spec_raises(tmp_path):
+    with pytest.raises(FileError):
+        build_lib_nav(tmp_path / "missing.yml", tmp_path)
+
+
+def test_build_wiki_nav_block_reroots_entries(tmp_path):
+    wiki = tmp_path / "docs" / "wiki"
+    wiki.mkdir(parents=True)
+    (wiki / "index.md").write_text("# Home", encoding="utf-8")
+    (wiki / "01_overview.md").write_text("# Overview", encoding="utf-8")
+
+    block = build_wiki_nav_block(wiki)
+    assert block == [{"Home": "index.md"}, {"Overview": "01_overview.md"}]
+
+
+def test_load_spec_icon(tmp_path):
+    nav_file = tmp_path / "docforge.nav.yml"
+    nav_file.write_text("home: index.md\nicon:\n  logo: material/code-tags\n")
+    assert load_spec_icon(nav_file) == {"logo": "material/code-tags"}
+    assert load_spec_icon(tmp_path / "missing.yml") is None

tests/cli/test_serve_mcp.py

@@ -1,5 +1,6 @@
 from docforge.cli.main import cli
 
+
 def test_mcp_serve(
     cli_runner,
     fake_mcp_docs,

tests/cli/test_serve_mkdocs.py

@@ -1,5 +1,6 @@
 from docforge.cli.main import cli
 
+
 def test_mkdocs_serve(
     cli_runner,
     fake_mkdocs_yml,

tests/conftest.py

@@ -1,8 +1,8 @@
-import sys
 import json
-import pytest
+import sys
 from pathlib import Path
 
+import pytest
 from click.testing import CliRunner
 
 
@@ -45,6 +45,7 @@ plugins:
 @pytest.fixture
 def mock_mkdocs_load_config(monkeypatch):
     """Mock mkdocs.config.load_config."""
+
     def fake_load_config(path):
         return object()  # dummy config object
 
@@ -81,6 +82,7 @@ def mock_mkdocs_serve(monkeypatch):
     )
     return lambda: called["value"]
 
+
 @pytest.fixture
 def fake_mcp_docs(tmp_path: Path) -> Path:
     """

tests/introspection/test_alias_safety.py

@@ -2,11 +2,9 @@ from docforge import GriffeLoader
 
 
 def test_alias_does_not_crash(temp_package):
-    (temp_package / "alias.py").write_text(
-        '''from typing import List
+    (temp_package / "alias.py").write_text("""from typing import List
 Alias = List[int]
-'''
-    )
+""")
 
     loader = GriffeLoader()
     project = loader.load_project(["testpkg.alias"])

tests/introspection/test_classes_and_methods.py

@@ -2,15 +2,13 @@ from docforge import GriffeLoader
 
 
 def test_class_and_methods(temp_package):
-    (temp_package / "cls.py").write_text(
-        '''class MyClass:
+    (temp_package / "cls.py").write_text('''class MyClass:
     """Class doc."""
 
     def method(self, x: int) -> int:
         """Method doc."""
         return x
-'''
-    )
+''')
 
     loader = GriffeLoader()
     project = loader.load_project(["testpkg.cls"])

tests/introspection/test_functions_and_signatures.py

@@ -2,12 +2,10 @@ from docforge import GriffeLoader
 
 
 def test_function_signature(temp_package):
-    (temp_package / "fn.py").write_text(
-        '''def add(a: int, b: int = 1) -> int:
+    (temp_package / "fn.py").write_text('''def add(a: int, b: int = 1) -> int:
     """Adds numbers."""
     return a + b
-'''
-    )
+''')
 
     loader = GriffeLoader()
     project = loader.load_project(["testpkg.fn"])

tests/introspection/test_import_failures.py

@@ -1,4 +1,5 @@
 import pytest
+
 from docforge import GriffeLoader
 
 
@@ -6,9 +7,8 @@ def test_load_project_raises_on_missing_module_by_default():
     loader = GriffeLoader()
 
     with pytest.raises(ImportError):
-        loader.load_project(
-            ["nonexistent.module", "sys"]
-        )
+        loader.load_project(["nonexistent.module", "sys"])
+
 
 def test_load_project_skips_missing_modules_when_enabled():
     loader = GriffeLoader()
@@ -18,4 +18,4 @@ def test_load_project_skips_missing_modules_when_enabled():
         skip_import_errors=True,
     )
 
-    assert "sys" in project.modules
+    assert "sys" in project.modules

tests/introspection/test_missing_docstrings.py

@@ -2,9 +2,7 @@ from docforge import GriffeLoader
 
 
 def test_missing_docstrings(temp_package):
-    (temp_package / "nodoc.py").write_text(
-        '''def f(): pass'''
-    )
+    (temp_package / "nodoc.py").write_text("""def f(): pass""")
 
     loader = GriffeLoader()
     project = loader.load_project(["testpkg.nodoc"])

tests/introspection/test_private_members.py

@@ -2,11 +2,9 @@ from docforge import GriffeLoader
 
 
 def test_private_members_excluded(temp_package):
-    (temp_package / "priv.py").write_text(
-        '''def _hidden(): pass
+    (temp_package / "priv.py").write_text("""def _hidden(): pass
 def visible(): pass
-'''
-    )
+""")
 
     loader = GriffeLoader()
     project = loader.load_project(["testpkg.priv"])

tests/introspection/test_single_module.py

@@ -2,13 +2,11 @@ from docforge import GriffeLoader
 
 
 def test_load_single_module(temp_package):
-    (temp_package / "mod.py").write_text(
-        '''"""Module docstring."""\n
+    (temp_package / "mod.py").write_text('''"""Module docstring."""\n
 def foo():
     """Foo docstring."""
     pass
-'''
-    )
+''')
 
     loader = GriffeLoader()
     project = loader.load_project(["testpkg.mod"])

tests/nav/test_mkdocs.py

@@ -1,7 +1,6 @@
 from pathlib import Path
 
-from docforge.nav import ResolvedNav
-from docforge.nav import MkDocsNavEmitter
+from docforge.nav import MkDocsNavEmitter, ResolvedNav
 
 
 def test_emit_mkdocs_nav():

tests/nav/test_resolver.py

@@ -2,8 +2,7 @@ from pathlib import Path
 
 import pytest
 
-from docforge.nav import NavSpec
-from docforge.nav import resolve_nav
+from docforge.nav import NavSpec, resolve_nav
 
 
 def _write_docs(root: Path, paths: list[str]) -> None:

tests/nav/test_wiki.py

@@ -0,0 +1,106 @@
+from pathlib import Path
+
+import pytest
+
+from docforge.nav import build_wiki_nav
+
+
+def _write_wiki(root: Path, files: list[str]) -> None:
+    for rel in files:
+        full = root / rel
+        full.parent.mkdir(parents=True, exist_ok=True)
+        full.write_text(f"# {rel}", encoding="utf-8")
+
+
+def test_missing_wiki_dir_raises(tmp_path: Path):
+    with pytest.raises(FileNotFoundError):
+        build_wiki_nav(tmp_path / "nope")
+
+
+def test_empty_wiki_dir_returns_empty(tmp_path: Path):
+    wiki = tmp_path / "wiki"
+    wiki.mkdir()
+
+    assert build_wiki_nav(wiki) == []
+
+
+def test_index_becomes_home(tmp_path: Path):
+    wiki = tmp_path / "docs" / "wiki"
+    _write_wiki(wiki, ["index.md", "01_overview.md"])
+
+    nav = build_wiki_nav(wiki)
+
+    assert nav[0] == {"Home": "wiki/index.md"}
+    assert {"Overview": "wiki/01_overview.md"} in nav
+
+
+def test_number_prefix_stripped_and_prettified(tmp_path: Path):
+    wiki = tmp_path / "docs" / "wiki"
+    _write_wiki(wiki, ["01_basic_crud.md", "02_custom_repo.md", "10_transactions.md"])
+
+    nav = build_wiki_nav(wiki)
+
+    labels = [list(entry)[0] for entry in nav]
+    assert labels == ["Basic Crud", "Custom Repo", "Transactions"]
+
+
+def test_directory_becomes_nested_group(tmp_path: Path):
+    wiki = tmp_path / "docs" / "wiki"
+    _write_wiki(
+        wiki,
+        [
+            "index.md",
+            "03_use_cases/01_basic_crud.md",
+            "03_use_cases/02_custom_repo.md",
+        ],
+    )
+
+    nav = build_wiki_nav(wiki)
+
+    assert {"Home": "wiki/index.md"} in nav
+    assert {
+        "Use Cases": [
+            {"Basic Crud": "wiki/03_use_cases/01_basic_crud.md"},
+            {"Custom Repo": "wiki/03_use_cases/02_custom_repo.md"},
+        ]
+    } in nav
+
+
+def test_nested_index_is_section_root(tmp_path: Path):
+    wiki = tmp_path / "docs" / "wiki"
+    _write_wiki(
+        wiki,
+        [
+            "guide/index.md",
+            "guide/01_setup.md",
+        ],
+    )
+
+    nav = build_wiki_nav(wiki)
+
+    assert {
+        "Guide": [
+            {"Guide": "wiki/guide/index.md"},
+            {"Setup": "wiki/guide/01_setup.md"},
+        ]
+    } in nav
+
+
+def test_hidden_entries_ignored(tmp_path: Path):
+    wiki = tmp_path / "docs" / "wiki"
+    _write_wiki(wiki, ["index.md", ".draft.md"])
+    (wiki / ".hidden").mkdir()
+
+    nav = build_wiki_nav(wiki)
+
+    assert nav == [{"Home": "wiki/index.md"}]
+
+
+def test_natural_order_for_zero_padded_prefixes(tmp_path: Path):
+    wiki = tmp_path / "docs" / "wiki"
+    _write_wiki(wiki, ["02_b.md", "10_j.md", "01_a.md"])
+
+    nav = build_wiki_nav(wiki)
+
+    labels = [list(entry)[0] for entry in nav if list(entry)[0] in {"A", "B", "J"}]
+    assert labels == ["A", "B", "J"]

tests/renderers/mcp/test_mcp_content.py

@@ -2,7 +2,7 @@ import json
 from pathlib import Path
 
 from docforge import MCPRenderer
-from docforge.models import Project, Module
+from docforge.models import Module, Project
 
 
 def test_mcp_file_content(tmp_path: Path):

tests/renderers/mcp/test_mcp_idempotency.py

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

tests/renderers/mcp/test_mcp_module_coverage.py

@@ -1,7 +1,7 @@
 from pathlib import Path
 
-from docforge.loaders import GriffeLoader, discover_module_paths
 from docforge import MCPRenderer
+from docforge.loaders import GriffeLoader, discover_module_paths
 
 
 def test_mcp_emits_all_modules(tmp_path: Path) -> None:
@@ -22,10 +22,7 @@ def test_mcp_emits_all_modules(tmp_path: Path) -> None:
         for p in (tmp_path / "modules").rglob("*.json")
     }
 
-    expected = {
-        f"modules/{m.path}.json"
-        for m in project.get_all_modules()
-    }
+    expected = {f"modules/{m.path}.json" for m in project.get_all_modules()}
 
     missing = expected - emitted
     assert not missing, f"Missing MCP module JSON files: {missing}"

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

tests/renderers/mcp/test_mcp_structure.py

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

tests/renderers/mkdocs/test_mkdocs_content.py

@@ -1,7 +1,7 @@
 from pathlib import Path
 
 from docforge import MkDocsRenderer
-from docforge.models import Project, Module
+from docforge.models import Module, Project
 
 
 def test_mkdocs_file_content(tmp_path: Path):
@@ -47,4 +47,4 @@ def test_generate_readme_source_root(tmp_path: Path):
     content = readme.read_text()
 
     assert "# testpkg" in content
-    assert "Test package documentation." in content
+    assert "Test package documentation." in content

tests/renderers/mkdocs/test_mkdocs_idempotency.py

@@ -1,7 +1,7 @@
 from pathlib import Path
 
 from docforge import MkDocsRenderer
-from docforge.models import Project, Module
+from docforge.models import Module, Project
 
 
 def test_mkdocs_idempotent(tmp_path: Path):
@@ -50,4 +50,4 @@ def test_generate_readme_idempotent(tmp_path: Path):
 
     second = readme.read_text()
 
-    assert first == second
+    assert first == second

tests/renderers/mkdocs/test_mkdocs_module_coverage.py

@@ -1,7 +1,7 @@
 from pathlib import Path
 
-from docforge.loaders import GriffeLoader, discover_module_paths
 from docforge import MkDocsRenderer
+from docforge.loaders import GriffeLoader, discover_module_paths
 
 
 def test_mkdocs_emits_all_modules(tmp_path: Path) -> None:
@@ -23,10 +23,7 @@ def test_mkdocs_emits_all_modules(tmp_path: Path) -> None:
         module_is_source=True,
     )
 
-    emitted = {
-        p.relative_to(tmp_path).as_posix()
-        for p in tmp_path.rglob("*.md")
-    }
+    emitted = {p.relative_to(tmp_path).as_posix() for p in tmp_path.rglob("*.md")}
 
     module_paths = [m.path for m in project.get_all_modules()]
 
@@ -34,8 +31,7 @@ def test_mkdocs_emits_all_modules(tmp_path: Path) -> None:
     for path in module_paths:
         parts = path.split(".")
         is_package = any(
-            other != path and other.startswith(path + ".")
-            for other in module_paths
+            other != path and other.startswith(path + ".") for other in module_paths
         )
 
         if is_package:

tests/renderers/mkdocs/test_mkdocs_structure.py

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