docs(standards): mirror doc-forge wiki style; mermaid + copyable build prompt

- move templates into src/templates; renumber wiki pages; add app-components page

- embed agentic build prompt as a copyable markdown block; add mermaid diagrams

- build.py writes <name>/mcp; config static bundle -> standards/mcp

- registry reads libraries.json as bytes (committed file was UTF-16LE); normalize to UTF-8

- Dockerfile: drop stale blog copy; per-repo <name>/mcp copies

- drop nested standards/mcp/standards duplicate and empty root mcp/
This commit is contained in:
2026-10-12 00:21:41 +05:30
parent 9929f05334
commit 06ff5bce6e
80 changed files with 2009 additions and 829 deletions

View File

@@ -7,7 +7,7 @@ hub. Any top-level folder with ``src/mkdocs.*.yml`` gets, for each config:
1. a MkDocs HTML build into the target dir the config declares
(e.g. ``standards/src/mkdocs.wiki.yml`` -> ``standards/wiki/``), and
2. a doc-forge-shaped MCP bundle under ``mcp/<name>/``
2. a doc-forge-shaped MCP bundle under ``<name>/mcp/``
(``index.json``, ``nav.json``, ``modules/*.json``), regenerated from the
lib pages (``src/lib/*.md``) so the bundle mirrors the lib site.
@@ -100,7 +100,7 @@ def _read_title(path: Path) -> str:
def build_bundle(folder: Path, dry_run: bool = False) -> None:
"""Regenerate ``mcp/<name>`` from ``folder/src/lib`` markdown.
"""Regenerate ``<name>/mcp`` from ``folder/src/lib`` markdown.
The bundle mirrors the lib site (in the same way doc-forge's MCP output
mirrors its lib documentation). Writes ``index.json``, ``nav.json`` and
@@ -115,7 +115,7 @@ def build_bundle(folder: Path, dry_run: bool = False) -> None:
lib = folder / "src" / "lib"
if not lib.is_dir():
return
out_dir = ROOT / "mcp" / name
out_dir = folder / "mcp"
modules_dir = out_dir / "modules"
if dry_run:
print(f"[MCP] {name} {lib.relative_to(ROOT)}/*.md "