Vishesh 'ironeagle' Bangotra
5370a7faa2
- Add MCPRenderer to generate MCP-native JSON bundles (index.json, nav.json, modules/*.json) - Expose MCPRenderer via public API and CLI (`generate-mcp` command) - Replace Markdown-based MCP output with structured JSON resources - Update MCP renderer type stubs to match new JSON-based implementation - Refactor MCP tests to validate JSON content, bundle structure, and navigation - Fix MCP module coverage test to use explicit project_root for reliable discovery
105 lines
2.0 KiB
Python
105 lines
2.0 KiB
Python
from typing import Sequence
|
|
from pathlib import Path
|
|
|
|
import click
|
|
|
|
|
|
@click.group()
|
|
def cli() -> None:
|
|
"""doc-forge command-line interface."""
|
|
|
|
|
|
@cli.command()
|
|
@click.option(
|
|
"--modules",
|
|
multiple=True,
|
|
help="Python module import paths to introspect",
|
|
)
|
|
@click.option(
|
|
"--project-name",
|
|
help="Project name (defaults to first module)",
|
|
)
|
|
def tree(
|
|
modules: Sequence[str],
|
|
project_name: str | None,
|
|
) -> None:
|
|
"""Show introspection tree."""
|
|
|
|
|
|
@cli.command()
|
|
@click.option(
|
|
"--module",
|
|
help="Python module import paths to document",
|
|
)
|
|
@click.option(
|
|
"--project-name",
|
|
help="Project name (defaults to first module)",
|
|
)
|
|
@click.option(
|
|
"--docs-dir",
|
|
type=click.Path(path_type=Path),
|
|
default=Path("docs"),
|
|
)
|
|
def generate(
|
|
module: str,
|
|
project_name: str | None,
|
|
docs_dir: Path,
|
|
) -> None:
|
|
"""Generate documentation source files using MkDocs renderer."""
|
|
|
|
@cli.command(name="generate-mcp")
|
|
@click.option(
|
|
"--module",
|
|
required=True,
|
|
help="Python module import path to document",
|
|
)
|
|
@click.option(
|
|
"--project-name",
|
|
help="Project name (defaults to first module)",
|
|
)
|
|
@click.option(
|
|
"--out-dir",
|
|
type=click.Path(path_type=Path),
|
|
default=Path("mcp_docs"),
|
|
)
|
|
def generate_mcp(
|
|
module: str,
|
|
project_name: str | None,
|
|
out_dir: Path,
|
|
) -> None:
|
|
"""
|
|
Generate MCP-compatible documentation resources for the specified module.
|
|
|
|
Args:
|
|
module: The primary module path to document.
|
|
project_name: Optional project name override.
|
|
out_dir: Directory where MCP resources will be written.
|
|
"""
|
|
|
|
@cli.command()
|
|
@click.option(
|
|
"--mkdocs-yml",
|
|
type=click.Path(path_type=Path),
|
|
default=Path("mkdocs.yml"),
|
|
)
|
|
def build(
|
|
mkdocs_yml: Path,
|
|
) -> None:
|
|
"""Build documentation using MkDocs."""
|
|
|
|
|
|
@cli.command()
|
|
@click.option(
|
|
"--mkdocs-yml",
|
|
type=click.Path(path_type=Path),
|
|
default=Path("mkdocs.yml"),
|
|
)
|
|
def serve(
|
|
mkdocs_yml: Path,
|
|
) -> None:
|
|
"""Serve documentation using MkDocs."""
|
|
|
|
|
|
def main() -> None:
|
|
"""CLI entry point."""
|