@x12i/mdreports-docs 0.3.0

package/dist/generated/bundle.js

@@ -0,0 +1,937 @@
+export const catalog = {
+    "roles": [
+        {
+            "id": "developers",
+            "label": "Developers",
+            "tagline": "Ship renders in code",
+            "description": "Engineers wiring the SDK, CLI, HTTP API, or MCP server — packages, options, and integration patterns."
+        },
+        {
+            "id": "builders",
+            "label": "Builders",
+            "tagline": "Shape templates & docs",
+            "description": "Authors and template designers using Playground/Studio and custom HTML+CSS layouts without living in the renderer source."
+        }
+    ],
+    "families": [
+        {
+            "id": "mdreports",
+            "name": "Markdown Reports Studio",
+            "tagline": "Markdown in → branded PDF, DOCX, PPTX, HTML out.",
+            "description": "One rendering engine across SDK, CLI, HTTP API, MCP, Playground, and Studio.",
+            "color": "#1a3a52"
+        }
+    ],
+    "books": [
+        {
+            "id": "00-overview",
+            "familyId": "mdreports",
+            "audiences": [
+                "developers",
+                "builders"
+            ],
+            "status": "available",
+            "kicker": "CASE FILE · MDR-00",
+            "title": "Overview",
+            "subtitle": "What the product is",
+            "blurb": "Surfaces, formats, and the render pipeline — where Markdown Reports Studio fits.",
+            "tags": [
+                "platform",
+                "start-here",
+                "overview"
+            ],
+            "color": "#1a3a52",
+            "dir": "00-overview"
+        },
+        {
+            "id": "01-packages",
+            "familyId": "mdreports",
+            "audiences": [
+                "developers"
+            ],
+            "status": "available",
+            "kicker": "CASE FILE · MDR-01",
+            "title": "Packages",
+            "subtitle": "The @x12i/mdreports-* map",
+            "blurb": "Which npm package to install for SDK, CLI, API, client, MCP, types, and templates.",
+            "tags": [
+                "packages",
+                "npm"
+            ],
+            "color": "#1f6e5c",
+            "dir": "01-packages"
+        },
+        {
+            "id": "02-getting-started",
+            "familyId": "mdreports",
+            "audiences": [
+                "developers",
+                "builders"
+            ],
+            "status": "available",
+            "kicker": "CASE FILE · MDR-02",
+            "title": "Getting Started",
+            "subtitle": "Pick a surface and render",
+            "blurb": "CLI, SDK, HTTP API, or MCP — first successful PDF/DOCX/PPTX in minutes.",
+            "tags": [
+                "getting-started",
+                "quickstart"
+            ],
+            "color": "#a5710f",
+            "dir": "02-getting-started"
+        },
+        {
+            "id": "03-sdk",
+            "familyId": "mdreports",
+            "audiences": [
+                "developers"
+            ],
+            "status": "available",
+            "kicker": "CASE FILE · MDR-03",
+            "title": "SDK",
+            "subtitle": "@x12i/mdreports-core",
+            "blurb": "In-process HTML/PDF/DOCX/PPTX render, TemplateStore, and create-from-image.",
+            "tags": [
+                "sdk",
+                "node",
+                "core"
+            ],
+            "color": "#2d5a87",
+            "dir": "03-sdk"
+        },
+        {
+            "id": "04-cli",
+            "familyId": "mdreports",
+            "audiences": [
+                "developers"
+            ],
+            "status": "available",
+            "kicker": "CASE FILE · MDR-04",
+            "title": "CLI",
+            "subtitle": "mdreports command reference",
+            "blurb": "Render from the shell and manage templates with create-from-html / create-from-image.",
+            "tags": [
+                "cli",
+                "shell"
+            ],
+            "color": "#3d6b4f",
+            "dir": "04-cli"
+        },
+        {
+            "id": "05-api",
+            "familyId": "mdreports",
+            "audiences": [
+                "developers"
+            ],
+            "status": "available",
+            "kicker": "CASE FILE · MDR-05",
+            "title": "HTTP API",
+            "subtitle": "Service + typed client",
+            "blurb": "Run mdreports-api and call it with curl or @x12i/mdreports-api-client.",
+            "tags": [
+                "api",
+                "http",
+                "client"
+            ],
+            "color": "#b14a2c",
+            "dir": "05-api"
+        },
+        {
+            "id": "06-mcp",
+            "familyId": "mdreports",
+            "audiences": [
+                "developers"
+            ],
+            "status": "available",
+            "kicker": "CASE FILE · MDR-06",
+            "title": "MCP",
+            "subtitle": "Agent tools over stdio",
+            "blurb": "Wire @x12i/mdreports-mcp-server into Cursor or Claude for render and template tools.",
+            "tags": [
+                "mcp",
+                "agents"
+            ],
+            "color": "#5b3d8f",
+            "dir": "06-mcp"
+        },
+        {
+            "id": "07-templates",
+            "familyId": "mdreports",
+            "audiences": [
+                "developers",
+                "builders"
+            ],
+            "status": "available",
+            "kicker": "CASE FILE · MDR-07",
+            "title": "Templates",
+            "subtitle": "Built-ins, slots, custom layouts",
+            "blurb": "Template directory contract, built-ins, user store, and PPTX slide rules.",
+            "tags": [
+                "templates",
+                "html",
+                "css"
+            ],
+            "color": "#1a3a52",
+            "dir": "07-templates",
+            "buildersPrimary": true
+        }
+    ]
+};
+export const useCases = {
+    "useCases": [
+        {
+            "id": "orient-mdreports",
+            "title": "Orient on Markdown Reports Studio",
+            "goal": "Understand formats, surfaces, and the one render pipeline before installing anything.",
+            "audiences": [
+                "developers",
+                "builders"
+            ],
+            "tags": [
+                "platform",
+                "start-here"
+            ],
+            "path": [
+                {
+                    "bookId": "00-overview",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-what-it-is",
+                        "2-formats-and-surfaces",
+                        "3-how-rendering-works",
+                        "4-where-to-go-next"
+                    ]
+                }
+            ],
+            "alsoSee": [
+                "00-overview",
+                "02-getting-started"
+            ],
+            "prerequisites": [],
+            "successCriteria": [],
+            "nextUseCases": [],
+            "scenarioIds": [],
+            "guideIds": [],
+            "troubleshooting": []
+        },
+        {
+            "id": "pick-a-surface",
+            "title": "Pick a surface and first render",
+            "goal": "Choose CLI, SDK, API, or MCP and produce a first PDF/DOCX/PPTX.",
+            "audiences": [
+                "developers",
+                "builders"
+            ],
+            "tags": [
+                "getting-started",
+                "quickstart"
+            ],
+            "path": [
+                {
+                    "bookId": "02-getting-started",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-prerequisites",
+                        "2-option-a-cli",
+                        "3-option-b-sdk",
+                        "4-option-c-http-api",
+                        "5-option-d-mcp",
+                        "6-built-in-templates"
+                    ]
+                }
+            ],
+            "alsoSee": [
+                "01-packages",
+                "02-getting-started"
+            ],
+            "prerequisites": [],
+            "successCriteria": [],
+            "nextUseCases": [],
+            "scenarioIds": [],
+            "guideIds": [],
+            "troubleshooting": []
+        },
+        {
+            "id": "map-packages",
+            "title": "Map the @x12i/mdreports-* packages",
+            "goal": "Know which npm package owns core, CLI, API, client, MCP, types, and templates.",
+            "audiences": [
+                "developers"
+            ],
+            "tags": [
+                "packages",
+                "npm"
+            ],
+            "path": [
+                {
+                    "bookId": "01-packages",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-package-table",
+                        "2-dependency-shape",
+                        "3-naming-note"
+                    ]
+                }
+            ],
+            "alsoSee": [
+                "01-packages"
+            ],
+            "prerequisites": [],
+            "successCriteria": [],
+            "nextUseCases": [],
+            "scenarioIds": [],
+            "guideIds": [],
+            "troubleshooting": []
+        },
+        {
+            "id": "render-with-sdk",
+            "title": "Render in-process with the SDK",
+            "goal": "Call renderToHtml/Pdf/Docx/Pptx, shut down Chromium, and use TemplateStore.",
+            "audiences": [
+                "developers"
+            ],
+            "tags": [
+                "sdk",
+                "core"
+            ],
+            "path": [
+                {
+                    "bookId": "03-sdk",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-install",
+                        "2-render",
+                        "3-template-store",
+                        "4-ai-template-from-image"
+                    ]
+                }
+            ],
+            "alsoSee": [
+                "03-sdk",
+                "07-templates"
+            ],
+            "prerequisites": [],
+            "successCriteria": [],
+            "nextUseCases": [],
+            "scenarioIds": [],
+            "guideIds": [],
+            "troubleshooting": []
+        },
+        {
+            "id": "render-with-cli",
+            "title": "Render from the CLI",
+            "goal": "Use mdreports render and templates commands from the shell.",
+            "audiences": [
+                "developers"
+            ],
+            "tags": [
+                "cli"
+            ],
+            "path": [
+                {
+                    "bookId": "04-cli",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-install",
+                        "2-render",
+                        "3-templates"
+                    ]
+                }
+            ],
+            "alsoSee": [
+                "04-cli"
+            ],
+            "prerequisites": [],
+            "successCriteria": [],
+            "nextUseCases": [],
+            "scenarioIds": [],
+            "guideIds": [],
+            "troubleshooting": []
+        },
+        {
+            "id": "call-http-api",
+            "title": "Run and call the HTTP API",
+            "goal": "Start mdreports-api and render via curl or the typed client.",
+            "audiences": [
+                "developers"
+            ],
+            "tags": [
+                "api",
+                "http"
+            ],
+            "path": [
+                {
+                    "bookId": "05-api",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-run",
+                        "2-call-with-curl",
+                        "3-typed-client",
+                        "4-route-summary"
+                    ]
+                }
+            ],
+            "alsoSee": [
+                "05-api"
+            ],
+            "prerequisites": [],
+            "successCriteria": [],
+            "nextUseCases": [],
+            "scenarioIds": [],
+            "guideIds": [],
+            "troubleshooting": []
+        },
+        {
+            "id": "wire-mcp-agents",
+            "title": "Wire MCP tools for agents",
+            "goal": "Install the MCP server and expose render/template tools to Cursor or Claude.",
+            "audiences": [
+                "developers"
+            ],
+            "tags": [
+                "mcp",
+                "agents"
+            ],
+            "path": [
+                {
+                    "bookId": "06-mcp",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-run-configure",
+                        "2-tools"
+                    ]
+                }
+            ],
+            "alsoSee": [
+                "06-mcp"
+            ],
+            "prerequisites": [],
+            "successCriteria": [],
+            "nextUseCases": [],
+            "scenarioIds": [],
+            "guideIds": [],
+            "troubleshooting": []
+        },
+        {
+            "id": "author-templates",
+            "title": "Author and store templates",
+            "goal": "Understand the template directory contract, built-ins, user store, and PPTX rules.",
+            "audiences": [
+                "developers",
+                "builders"
+            ],
+            "tags": [
+                "templates",
+                "studio"
+            ],
+            "path": [
+                {
+                    "bookId": "07-templates",
+                    "audience": "builders",
+                    "chapters": [
+                        "1-built-ins",
+                        "2-layout-contract",
+                        "3-user-templates",
+                        "4-images-in-markdown",
+                        "5-pptx"
+                    ]
+                }
+            ],
+            "alsoSee": [
+                "07-templates"
+            ],
+            "prerequisites": [],
+            "successCriteria": [],
+            "nextUseCases": [],
+            "scenarioIds": [],
+            "guideIds": [],
+            "troubleshooting": []
+        }
+    ]
+};
+export const site = {
+    "product": "mdreports",
+    "brand": "x12i · Markdown Reports Studio",
+    "brandAccent": "mdreports",
+    "siteUrl": "https://docs.mdreports.x12i.com",
+    "knowledgePackage": "@x12i/mdreports-docs",
+    "footer": "Markdown Reports Studio",
+    "accent": "oklch(45% 0.08 230)",
+    "accentAlt": "oklch(55% 0.12 55)",
+    "productUrl": "https://github.com/x12i/markdown-reports-studio",
+    "nav": [
+        {
+            "label": "Getting started",
+            "href": "/getting-started"
+        },
+        {
+            "label": "Use cases",
+            "href": "/use-cases"
+        },
+        {
+            "label": "Catalog",
+            "href": "/catalog"
+        }
+    ],
+    "footerLinks": [
+        {
+            "label": "Docs home",
+            "href": "/docs"
+        },
+        {
+            "label": "Getting started",
+            "href": "/getting-started"
+        },
+        {
+            "label": "Use cases",
+            "href": "/use-cases"
+        },
+        {
+            "label": "Catalog",
+            "href": "/catalog"
+        },
+        {
+            "label": "Agents/SDK",
+            "href": "/agents"
+        },
+        {
+            "label": "GitHub",
+            "href": "https://github.com/x12i/markdown-reports-studio"
+        }
+    ]
+};
+export const manifest = {
+    "version": 1,
+    "product": "mdreports",
+    "site": "https://docs.mdreports.x12i.com",
+    "knowledgePackage": "@x12i/mdreports-docs",
+    "roles": [
+        "developers",
+        "builders"
+    ],
+    "books": [
+        {
+            "id": "00-overview",
+            "audiences": [
+                "developers",
+                "builders"
+            ],
+            "md": {
+                "developers": "downloads/books/00-overview/developers.md",
+                "builders": "downloads/books/00-overview/builders.md"
+            },
+            "pdf": {
+                "developers": null,
+                "builders": null
+            },
+            "chapters": {
+                "developers": "downloads/books/00-overview/developers.chapters.json",
+                "builders": "downloads/books/00-overview/builders.chapters.json"
+            }
+        },
+        {
+            "id": "01-packages",
+            "audiences": [
+                "developers"
+            ],
+            "md": {
+                "developers": "downloads/books/01-packages/developers.md"
+            },
+            "pdf": {
+                "developers": null
+            },
+            "chapters": {
+                "developers": "downloads/books/01-packages/developers.chapters.json"
+            }
+        },
+        {
+            "id": "02-getting-started",
+            "audiences": [
+                "developers",
+                "builders"
+            ],
+            "md": {
+                "developers": "downloads/books/02-getting-started/developers.md",
+                "builders": "downloads/books/02-getting-started/builders.md"
+            },
+            "pdf": {
+                "developers": null,
+                "builders": null
+            },
+            "chapters": {
+                "developers": "downloads/books/02-getting-started/developers.chapters.json",
+                "builders": "downloads/books/02-getting-started/builders.chapters.json"
+            }
+        },
+        {
+            "id": "03-sdk",
+            "audiences": [
+                "developers"
+            ],
+            "md": {
+                "developers": "downloads/books/03-sdk/developers.md"
+            },
+            "pdf": {
+                "developers": null
+            },
+            "chapters": {
+                "developers": "downloads/books/03-sdk/developers.chapters.json"
+            }
+        },
+        {
+            "id": "04-cli",
+            "audiences": [
+                "developers"
+            ],
+            "md": {
+                "developers": "downloads/books/04-cli/developers.md"
+            },
+            "pdf": {
+                "developers": null
+            },
+            "chapters": {
+                "developers": "downloads/books/04-cli/developers.chapters.json"
+            }
+        },
+        {
+            "id": "05-api",
+            "audiences": [
+                "developers"
+            ],
+            "md": {
+                "developers": "downloads/books/05-api/developers.md"
+            },
+            "pdf": {
+                "developers": null
+            },
+            "chapters": {
+                "developers": "downloads/books/05-api/developers.chapters.json"
+            }
+        },
+        {
+            "id": "06-mcp",
+            "audiences": [
+                "developers"
+            ],
+            "md": {
+                "developers": "downloads/books/06-mcp/developers.md"
+            },
+            "pdf": {
+                "developers": null
+            },
+            "chapters": {
+                "developers": "downloads/books/06-mcp/developers.chapters.json"
+            }
+        },
+        {
+            "id": "07-templates",
+            "audiences": [
+                "developers",
+                "builders"
+            ],
+            "md": {
+                "developers": "downloads/books/07-templates/developers.md",
+                "builders": "downloads/books/07-templates/builders.md"
+            },
+            "pdf": {
+                "developers": null,
+                "builders": null
+            },
+            "chapters": {
+                "developers": "downloads/books/07-templates/developers.chapters.json",
+                "builders": "downloads/books/07-templates/builders.chapters.json"
+            }
+        }
+    ],
+    "useCases": [
+        {
+            "id": "orient-mdreports",
+            "title": "Orient on Markdown Reports Studio",
+            "md": "downloads/use-cases/orient-mdreports.md",
+            "path": [
+                {
+                    "bookId": "00-overview",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-what-it-is",
+                        "2-formats-and-surfaces",
+                        "3-how-rendering-works",
+                        "4-where-to-go-next"
+                    ]
+                }
+            ]
+        },
+        {
+            "id": "pick-a-surface",
+            "title": "Pick a surface and first render",
+            "md": "downloads/use-cases/pick-a-surface.md",
+            "path": [
+                {
+                    "bookId": "02-getting-started",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-prerequisites",
+                        "2-option-a-cli",
+                        "3-option-b-sdk",
+                        "4-option-c-http-api",
+                        "5-option-d-mcp",
+                        "6-built-in-templates"
+                    ]
+                }
+            ]
+        },
+        {
+            "id": "map-packages",
+            "title": "Map the @x12i/mdreports-* packages",
+            "md": "downloads/use-cases/map-packages.md",
+            "path": [
+                {
+                    "bookId": "01-packages",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-package-table",
+                        "2-dependency-shape",
+                        "3-naming-note"
+                    ]
+                }
+            ]
+        },
+        {
+            "id": "render-with-sdk",
+            "title": "Render in-process with the SDK",
+            "md": "downloads/use-cases/render-with-sdk.md",
+            "path": [
+                {
+                    "bookId": "03-sdk",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-install",
+                        "2-render",
+                        "3-template-store",
+                        "4-ai-template-from-image"
+                    ]
+                }
+            ]
+        },
+        {
+            "id": "render-with-cli",
+            "title": "Render from the CLI",
+            "md": "downloads/use-cases/render-with-cli.md",
+            "path": [
+                {
+                    "bookId": "04-cli",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-install",
+                        "2-render",
+                        "3-templates"
+                    ]
+                }
+            ]
+        },
+        {
+            "id": "call-http-api",
+            "title": "Run and call the HTTP API",
+            "md": "downloads/use-cases/call-http-api.md",
+            "path": [
+                {
+                    "bookId": "05-api",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-run",
+                        "2-call-with-curl",
+                        "3-typed-client",
+                        "4-route-summary"
+                    ]
+                }
+            ]
+        },
+        {
+            "id": "wire-mcp-agents",
+            "title": "Wire MCP tools for agents",
+            "md": "downloads/use-cases/wire-mcp-agents.md",
+            "path": [
+                {
+                    "bookId": "06-mcp",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-run-configure",
+                        "2-tools"
+                    ]
+                }
+            ]
+        },
+        {
+            "id": "author-templates",
+            "title": "Author and store templates",
+            "md": "downloads/use-cases/author-templates.md",
+            "path": [
+                {
+                    "bookId": "07-templates",
+                    "audience": "builders",
+                    "chapters": [
+                        "1-built-ins",
+                        "2-layout-contract",
+                        "3-user-templates",
+                        "4-images-in-markdown",
+                        "5-pptx"
+                    ]
+                }
+            ]
+        }
+    ],
+    "indexes": {
+        "indexMd": "INDEX.md",
+        "searchJson": "SEARCH.json"
+    },
+    "concepts": [
+        {
+            "id": "render-pipeline",
+            "title": "Render pipeline",
+            "md": "concepts/render-pipeline.md"
+        }
+    ],
+    "guides": [
+        {
+            "id": "pick-a-surface",
+            "title": "Pick a surface",
+            "md": "guides/pick-a-surface.md"
+        }
+    ],
+    "scenarios": [
+        {
+            "id": "choose-integrate-or-ui",
+            "title": "Choose integrate-or-UI path",
+            "md": "scenarios/choose-integrate-or-ui.md"
+        }
+    ],
+    "decisions": [],
+    "glossary": [],
+    "visuals": [],
+    "diagrams": [],
+    "relationships": [],
+    "tutorials": [],
+    "examples": [],
+    "sampleData": [],
+    "uiClients": [],
+    "apis": [],
+    "packs": [
+        {
+            "id": "concept/render-pipeline",
+            "type": "concept",
+            "path": "packs/concept/render-pipeline"
+        },
+        {
+            "id": "guide/pick-a-surface",
+            "type": "guide",
+            "path": "packs/guide/pick-a-surface"
+        },
+        {
+            "id": "scenario/choose-integrate-or-ui",
+            "type": "scenario",
+            "path": "packs/scenario/choose-integrate-or-ui"
+        }
+    ]
+};
+export const files = {
+    "agent/agent-manifest.json": "{\n  \"version\": 1,\n  \"product\": \"mdreports\",\n  \"site\": \"https://docs.mdreports.x12i.com\",\n  \"knowledgePackage\": \"@x12i/mdreports-docs\",\n  \"roles\": [\n    \"developers\",\n    \"builders\"\n  ],\n  \"books\": [\n    {\n      \"id\": \"00-overview\",\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/00-overview/developers.md\",\n        \"builders\": \"downloads/books/00-overview/builders.md\"\n      },\n      \"pdf\": {\n        \"developers\": null,\n        \"builders\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/00-overview/developers.chapters.json\",\n        \"builders\": \"downloads/books/00-overview/builders.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"01-packages\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/01-packages/developers.md\"\n      },\n      \"pdf\": {\n        \"developers\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/01-packages/developers.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"02-getting-started\",\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/02-getting-started/developers.md\",\n        \"builders\": \"downloads/books/02-getting-started/builders.md\"\n      },\n      \"pdf\": {\n        \"developers\": null,\n        \"builders\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/02-getting-started/developers.chapters.json\",\n        \"builders\": \"downloads/books/02-getting-started/builders.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"03-sdk\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/03-sdk/developers.md\"\n      },\n      \"pdf\": {\n        \"developers\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/03-sdk/developers.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"04-cli\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/04-cli/developers.md\"\n      },\n      \"pdf\": {\n        \"developers\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/04-cli/developers.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"05-api\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/05-api/developers.md\"\n      },\n      \"pdf\": {\n        \"developers\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/05-api/developers.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"06-mcp\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/06-mcp/developers.md\"\n      },\n      \"pdf\": {\n        \"developers\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/06-mcp/developers.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"07-templates\",\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/07-templates/developers.md\",\n        \"builders\": \"downloads/books/07-templates/builders.md\"\n      },\n      \"pdf\": {\n        \"developers\": null,\n        \"builders\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/07-templates/developers.chapters.json\",\n        \"builders\": \"downloads/books/07-templates/builders.chapters.json\"\n      }\n    }\n  ],\n  \"useCases\": [\n    {\n      \"id\": \"orient-mdreports\",\n      \"title\": \"Orient on Markdown Reports Studio\",\n      \"md\": \"downloads/use-cases/orient-mdreports.md\",\n      \"path\": [\n        {\n          \"bookId\": \"00-overview\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-what-it-is\",\n            \"2-formats-and-surfaces\",\n            \"3-how-rendering-works\",\n            \"4-where-to-go-next\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"pick-a-surface\",\n      \"title\": \"Pick a surface and first render\",\n      \"md\": \"downloads/use-cases/pick-a-surface.md\",\n      \"path\": [\n        {\n          \"bookId\": \"02-getting-started\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-prerequisites\",\n            \"2-option-a-cli\",\n            \"3-option-b-sdk\",\n            \"4-option-c-http-api\",\n            \"5-option-d-mcp\",\n            \"6-built-in-templates\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"map-packages\",\n      \"title\": \"Map the @x12i/mdreports-* packages\",\n      \"md\": \"downloads/use-cases/map-packages.md\",\n      \"path\": [\n        {\n          \"bookId\": \"01-packages\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-package-table\",\n            \"2-dependency-shape\",\n            \"3-naming-note\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"render-with-sdk\",\n      \"title\": \"Render in-process with the SDK\",\n      \"md\": \"downloads/use-cases/render-with-sdk.md\",\n      \"path\": [\n        {\n          \"bookId\": \"03-sdk\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-install\",\n            \"2-render\",\n            \"3-template-store\",\n            \"4-ai-template-from-image\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"render-with-cli\",\n      \"title\": \"Render from the CLI\",\n      \"md\": \"downloads/use-cases/render-with-cli.md\",\n      \"path\": [\n        {\n          \"bookId\": \"04-cli\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-install\",\n            \"2-render\",\n            \"3-templates\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"call-http-api\",\n      \"title\": \"Run and call the HTTP API\",\n      \"md\": \"downloads/use-cases/call-http-api.md\",\n      \"path\": [\n        {\n          \"bookId\": \"05-api\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-run\",\n            \"2-call-with-curl\",\n            \"3-typed-client\",\n            \"4-route-summary\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"wire-mcp-agents\",\n      \"title\": \"Wire MCP tools for agents\",\n      \"md\": \"downloads/use-cases/wire-mcp-agents.md\",\n      \"path\": [\n        {\n          \"bookId\": \"06-mcp\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-run-configure\",\n            \"2-tools\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"author-templates\",\n      \"title\": \"Author and store templates\",\n      \"md\": \"downloads/use-cases/author-templates.md\",\n      \"path\": [\n        {\n          \"bookId\": \"07-templates\",\n          \"audience\": \"builders\",\n          \"chapters\": [\n            \"1-built-ins\",\n            \"2-layout-contract\",\n            \"3-user-templates\",\n            \"4-images-in-markdown\",\n            \"5-pptx\"\n          ]\n        }\n      ]\n    }\n  ],\n  \"indexes\": {\n    \"indexMd\": \"INDEX.md\",\n    \"searchJson\": \"SEARCH.json\"\n  },\n  \"concepts\": [\n    {\n      \"id\": \"render-pipeline\",\n      \"title\": \"Render pipeline\",\n      \"md\": \"concepts/render-pipeline.md\"\n    }\n  ],\n  \"guides\": [\n    {\n      \"id\": \"pick-a-surface\",\n      \"title\": \"Pick a surface\",\n      \"md\": \"guides/pick-a-surface.md\"\n    }\n  ],\n  \"scenarios\": [\n    {\n      \"id\": \"choose-integrate-or-ui\",\n      \"title\": \"Choose integrate-or-UI path\",\n      \"md\": \"scenarios/choose-integrate-or-ui.md\"\n    }\n  ],\n  \"decisions\": [],\n  \"glossary\": [],\n  \"visuals\": [],\n  \"diagrams\": [],\n  \"relationships\": [],\n  \"tutorials\": [],\n  \"examples\": [],\n  \"sampleData\": [],\n  \"uiClients\": [],\n  \"apis\": [],\n  \"packs\": [\n    {\n      \"id\": \"concept/render-pipeline\",\n      \"type\": \"concept\",\n      \"path\": \"packs/concept/render-pipeline\"\n    },\n    {\n      \"id\": \"guide/pick-a-surface\",\n      \"type\": \"guide\",\n      \"path\": \"packs/guide/pick-a-surface\"\n    },\n    {\n      \"id\": \"scenario/choose-integrate-or-ui\",\n      \"type\": \"scenario\",\n      \"path\": \"packs/scenario/choose-integrate-or-ui\"\n    }\n  ]\n}",
+    "agent/concepts/render-pipeline.md": "---\nid: \"render-pipeline\"\ntype: \"concept\"\ntitle: \"Render pipeline\"\nsummary: \"Markdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine.\"\nproblem: \"Teams reimplement Markdown rendering per surface and drift on templates, slots, and export fidelity.\"\nwhy: \"One core (`@x12i/mdreports-core`) keeps CLI, API, MCP, Playground, and Studio on the same contract.\"\nmentalModel: \"Parse Markdown → load template → inject CSS/slots → emit the requested format.\"\naudiences: [\"developers\", \"builders\"]\nnext: [\"pick-a-surface\"]\n---\n# Render pipeline\n\n# Render pipeline\n\n## Answer\n\nMarkdown Reports Studio is a **render pipeline**: Markdown in, branded document out — not a CMS.\n\n## Problem\n\nWithout a shared engine, PDF/DOCX/HTML exports diverge per tool and templates stop composing.\n\n## Why\n\nSDK, CLI, HTTP API, MCP, Playground, and Studio all call the same core so template ids and frontmatter behave identically.\n\n## Mental model\n\n1. Parse Markdown (YAML frontmatter fills slots).\n2. Load a template (`layout.html` + `styles.css` + `template.json`).\n3. Inject CSS and fill slots (`<!--CONTENT-->`, `<!--TITLE-->`, meta slots).\n4. Emit HTML, PDF (Playwright), DOCX, or PPTX.\n\n## Example\n\n```ts\nimport { renderToPdf, shutdown } from \"@x12i/mdreports-core\";\n\nconst pdf = await renderToPdf(\"# Hello\", \"clean-report\");\nawait shutdown();\n```\n\n## How it works\n\nBuilt-in templates ship in `@x12i/mdreports-templates`. User templates live under `~/.mdreports/templates` (or `MDREPORTS_TEMPLATES_DIR`).\n\n## Next\n\nPick a surface — CLI for shells, SDK for Node, API for services, MCP for agents.",
+    "agent/guides/pick-a-surface.md": "---\nid: \"pick-a-surface\"\ntype: \"guide\"\ntitle: \"Pick a surface\"\nsummary: \"Choose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render.\"\nwhy: \"The same engine backs every surface — install only what your workflow needs.\"\naudiences: [\"developers\", \"builders\"]\nprerequisites: [\"render-pipeline\"]\nconfirmationRequired: false\n---\n# Pick a surface\n\n# Pick a surface\n\n## Use this when\n\nYou know you want Markdown → PDF/DOCX/PPTX/HTML and need the smallest install path.\n\n## Do not use this when\n\nYou are designing template HTML/CSS only — open Studio after a local `pnpm dev` instead.\n\n## Steps\n\n1. **CLI** — `npm i -g @x12i/mdreports-cli` then `mdreports render --in report.md --template clean-report --format pdf`.\n2. **SDK** — `npm i @x12i/mdreports-core` and call `renderToPdf` / `renderToDocx` / `renderToPptx` / `renderToHtml`.\n3. **HTTP API** — `npm i -g @x12i/mdreports-api` → `mdreports-api` on port **6460**; optional `@x12i/mdreports-api-client`.\n4. **MCP** — wire `@x12i/mdreports-mcp-server` into your agent client.\n5. **Playground / Studio** — from this monorepo, `pnpm dev` (:6461 / :6463).\n\nAlways install Chromium once for PDF: `npx playwright install chromium`.\n\n## Verification\n\nYou have a non-empty PDF/DOCX/PPTX/HTML file from the same Markdown + `clean-report` template.\n\n## Recovery\n\nIf PDF fails, reinstall Chromium. If a template is missing, `mdreports templates list` and confirm built-ins or your `MDREPORTS_TEMPLATES_DIR`.",
+    "agent/INDEX.md": "# mdreports — knowledge index\n\nPackage: `@x12i/mdreports-docs`\n\n## How to choose\n\n- **Concept** — what it is and why it exists\n- **Guide** — bounded task procedure\n- **Scenario** — state + evidence → which path\n- **Use case** — end-to-end outcome\n- **Tutorial** — learn by doing\n- **Decision** — options and recommended default\n- **Reference / API** — exact technical detail\n\n## Manifest and search\n\n- `agent-manifest.json`\n- `SEARCH.json`\n\n## Concepts\n\n- `render-pipeline` — **Render pipeline** — Markdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine. — [concepts/render-pipeline.md](concepts/render-pipeline.md)\n\n## Guides\n\n- `pick-a-surface` — **Pick a surface** — Choose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render. — [guides/pick-a-surface.md](guides/pick-a-surface.md)\n\n## Scenarios\n\n- `choose-integrate-or-ui` — **Choose integrate-or-UI path** — Decide whether to embed the engine in code or use the local UIs first. — [scenarios/choose-integrate-or-ui.md](scenarios/choose-integrate-or-ui.md)\n\n## Diagrams\n\n_None authored yet._\n\n## Tutorials\n\n_None authored yet._\n",
+    "agent/indexes/books.json": "{\n  \"version\": 1,\n  \"items\": [\n    {\n      \"id\": \"00-overview\",\n      \"title\": \"Overview\",\n      \"summary\": \"Surfaces, formats, and the render pipeline — where Markdown Reports Studio fits.\",\n      \"path\": \"books/00-overview/\"\n    },\n    {\n      \"id\": \"01-packages\",\n      \"title\": \"Packages\",\n      \"summary\": \"Which npm package to install for SDK, CLI, API, client, MCP, types, and templates.\",\n      \"path\": \"books/01-packages/\"\n    },\n    {\n      \"id\": \"02-getting-started\",\n      \"title\": \"Getting Started\",\n      \"summary\": \"CLI, SDK, HTTP API, or MCP — first successful PDF/DOCX/PPTX in minutes.\",\n      \"path\": \"books/02-getting-started/\"\n    },\n    {\n      \"id\": \"03-sdk\",\n      \"title\": \"SDK\",\n      \"summary\": \"In-process HTML/PDF/DOCX/PPTX render, TemplateStore, and create-from-image.\",\n      \"path\": \"books/03-sdk/\"\n    },\n    {\n      \"id\": \"04-cli\",\n      \"title\": \"CLI\",\n      \"summary\": \"Render from the shell and manage templates with create-from-html / create-from-image.\",\n      \"path\": \"books/04-cli/\"\n    },\n    {\n      \"id\": \"05-api\",\n      \"title\": \"HTTP API\",\n      \"summary\": \"Run mdreports-api and call it with curl or @x12i/mdreports-api-client.\",\n      \"path\": \"books/05-api/\"\n    },\n    {\n      \"id\": \"06-mcp\",\n      \"title\": \"MCP\",\n      \"summary\": \"Wire @x12i/mdreports-mcp-server into Cursor or Claude for render and template tools.\",\n      \"path\": \"books/06-mcp/\"\n    },\n    {\n      \"id\": \"07-templates\",\n      \"title\": \"Templates\",\n      \"summary\": \"Template directory contract, built-ins, user store, and PPTX slide rules.\",\n      \"path\": \"books/07-templates/\"\n    }\n  ]\n}",
+    "agent/indexes/books.md": "# books\n\n- `00-overview` — Overview — Surfaces, formats, and the render pipeline — where Markdown Reports Studio fits.\n- `01-packages` — Packages — Which npm package to install for SDK, CLI, API, client, MCP, types, and templates.\n- `02-getting-started` — Getting Started — CLI, SDK, HTTP API, or MCP — first successful PDF/DOCX/PPTX in minutes.\n- `03-sdk` — SDK — In-process HTML/PDF/DOCX/PPTX render, TemplateStore, and create-from-image.\n- `04-cli` — CLI — Render from the shell and manage templates with create-from-html / create-from-image.\n- `05-api` — HTTP API — Run mdreports-api and call it with curl or @x12i/mdreports-api-client.\n- `06-mcp` — MCP — Wire @x12i/mdreports-mcp-server into Cursor or Claude for render and template tools.\n- `07-templates` — Templates — Template directory contract, built-ins, user store, and PPTX slide rules.\n",
+    "agent/indexes/concepts.json": "{\n  \"version\": 1,\n  \"items\": [\n    {\n      \"id\": \"render-pipeline\",\n      \"title\": \"Render pipeline\",\n      \"summary\": \"Markdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine.\",\n      \"path\": \"concepts/render-pipeline.md\"\n    }\n  ]\n}",
+    "agent/indexes/concepts.md": "# concepts\n\n- `render-pipeline` — Render pipeline — Markdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine.\n",
+    "agent/indexes/diagrams.json": "{\n  \"version\": 1,\n  \"items\": []\n}",
+    "agent/indexes/diagrams.md": "# diagrams\n\n\n",
+    "agent/indexes/guides.json": "{\n  \"version\": 1,\n  \"items\": [\n    {\n      \"id\": \"pick-a-surface\",\n      \"title\": \"Pick a surface\",\n      \"summary\": \"Choose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render.\",\n      \"path\": \"guides/pick-a-surface.md\"\n    }\n  ]\n}",
+    "agent/indexes/guides.md": "# guides\n\n- `pick-a-surface` — Pick a surface — Choose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render.\n",
+    "agent/indexes/scenarios.json": "{\n  \"version\": 1,\n  \"items\": [\n    {\n      \"id\": \"choose-integrate-or-ui\",\n      \"title\": \"Choose integrate-or-UI path\",\n      \"summary\": \"Decide whether to embed the engine in code or use the local UIs first.\",\n      \"path\": \"scenarios/choose-integrate-or-ui.md\"\n    }\n  ]\n}",
+    "agent/indexes/scenarios.md": "# scenarios\n\n- `choose-integrate-or-ui` — Choose integrate-or-UI path — Decide whether to embed the engine in code or use the local UIs first.\n",
+    "agent/indexes/tutorials.json": "{\n  \"version\": 1,\n  \"items\": []\n}",
+    "agent/indexes/tutorials.md": "# tutorials\n\n\n",
+    "agent/indexes/use-cases.json": "{\n  \"version\": 1,\n  \"items\": [\n    {\n      \"id\": \"orient-mdreports\",\n      \"title\": \"Orient on Markdown Reports Studio\",\n      \"summary\": \"Understand formats, surfaces, and the one render pipeline before installing anything.\",\n      \"path\": \"use-cases/orient-mdreports.md\"\n    },\n    {\n      \"id\": \"pick-a-surface\",\n      \"title\": \"Pick a surface and first render\",\n      \"summary\": \"Choose CLI, SDK, API, or MCP and produce a first PDF/DOCX/PPTX.\",\n      \"path\": \"use-cases/pick-a-surface.md\"\n    },\n    {\n      \"id\": \"map-packages\",\n      \"title\": \"Map the @x12i/mdreports-* packages\",\n      \"summary\": \"Know which npm package owns core, CLI, API, client, MCP, types, and templates.\",\n      \"path\": \"use-cases/map-packages.md\"\n    },\n    {\n      \"id\": \"render-with-sdk\",\n      \"title\": \"Render in-process with the SDK\",\n      \"summary\": \"Call renderToHtml/Pdf/Docx/Pptx, shut down Chromium, and use TemplateStore.\",\n      \"path\": \"use-cases/render-with-sdk.md\"\n    },\n    {\n      \"id\": \"render-with-cli\",\n      \"title\": \"Render from the CLI\",\n      \"summary\": \"Use mdreports render and templates commands from the shell.\",\n      \"path\": \"use-cases/render-with-cli.md\"\n    },\n    {\n      \"id\": \"call-http-api\",\n      \"title\": \"Run and call the HTTP API\",\n      \"summary\": \"Start mdreports-api and render via curl or the typed client.\",\n      \"path\": \"use-cases/call-http-api.md\"\n    },\n    {\n      \"id\": \"wire-mcp-agents\",\n      \"title\": \"Wire MCP tools for agents\",\n      \"summary\": \"Install the MCP server and expose render/template tools to Cursor or Claude.\",\n      \"path\": \"use-cases/wire-mcp-agents.md\"\n    },\n    {\n      \"id\": \"author-templates\",\n      \"title\": \"Author and store templates\",\n      \"summary\": \"Understand the template directory contract, built-ins, user store, and PPTX rules.\",\n      \"path\": \"use-cases/author-templates.md\"\n    }\n  ]\n}",
+    "agent/indexes/use-cases.md": "# use-cases\n\n- `orient-mdreports` — Orient on Markdown Reports Studio — Understand formats, surfaces, and the one render pipeline before installing anything.\n- `pick-a-surface` — Pick a surface and first render — Choose CLI, SDK, API, or MCP and produce a first PDF/DOCX/PPTX.\n- `map-packages` — Map the @x12i/mdreports-* packages — Know which npm package owns core, CLI, API, client, MCP, types, and templates.\n- `render-with-sdk` — Render in-process with the SDK — Call renderToHtml/Pdf/Docx/Pptx, shut down Chromium, and use TemplateStore.\n- `render-with-cli` — Render from the CLI — Use mdreports render and templates commands from the shell.\n- `call-http-api` — Run and call the HTTP API — Start mdreports-api and render via curl or the typed client.\n- `wire-mcp-agents` — Wire MCP tools for agents — Install the MCP server and expose render/template tools to Cursor or Claude.\n- `author-templates` — Author and store templates — Understand the template directory contract, built-ins, user store, and PPTX rules.\n",
+    "agent/packs/concept/render-pipeline/pack.json": "{\n  \"id\": \"concept/render-pipeline\",\n  \"type\": \"concept\",\n  \"title\": \"Render pipeline\",\n  \"summary\": \"Markdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine.\",\n  \"markdownPath\": \"concepts/render-pipeline.md\",\n  \"files\": [\n    \"concepts/render-pipeline.md\"\n  ],\n  \"related\": []\n}",
+    "agent/packs/concept/render-pipeline/PACK.md": "---\nid: \"concept/render-pipeline\"\ntype: \"pack\"\ntitle: \"Render pipeline\"\nsummary: \"Markdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine.\"\n---\n# Pack: Render pipeline\n\nMarkdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine.\n\nPrimary markdown: `concepts/render-pipeline.md`\n",
+    "agent/packs/guide/pick-a-surface/pack.json": "{\n  \"id\": \"guide/pick-a-surface\",\n  \"type\": \"guide\",\n  \"title\": \"Pick a surface\",\n  \"summary\": \"Choose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render.\",\n  \"markdownPath\": \"guides/pick-a-surface.md\",\n  \"files\": [\n    \"guides/pick-a-surface.md\"\n  ],\n  \"related\": []\n}",
+    "agent/packs/guide/pick-a-surface/PACK.md": "---\nid: \"guide/pick-a-surface\"\ntype: \"pack\"\ntitle: \"Pick a surface\"\nsummary: \"Choose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render.\"\n---\n# Pack: Pick a surface\n\nChoose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render.\n\nPrimary markdown: `guides/pick-a-surface.md`\n",
+    "agent/packs/scenario/choose-integrate-or-ui/pack.json": "{\n  \"id\": \"scenario/choose-integrate-or-ui\",\n  \"type\": \"scenario\",\n  \"title\": \"Choose integrate-or-UI path\",\n  \"summary\": \"Decide whether to embed the engine in code or use the local UIs first.\",\n  \"markdownPath\": \"scenarios/choose-integrate-or-ui.md\",\n  \"files\": [\n    \"scenarios/choose-integrate-or-ui.md\"\n  ],\n  \"related\": [\n    \"pick-a-surface\"\n  ]\n}",
+    "agent/packs/scenario/choose-integrate-or-ui/PACK.md": "---\nid: \"scenario/choose-integrate-or-ui\"\ntype: \"pack\"\ntitle: \"Choose integrate-or-UI path\"\nsummary: \"Decide whether to embed the engine in code or use the local UIs first.\"\n---\n# Pack: Choose integrate-or-UI path\n\nDecide whether to embed the engine in code or use the local UIs first.\n\nPrimary markdown: `scenarios/choose-integrate-or-ui.md`\n",
+    "agent/scenarios/choose-integrate-or-ui.md": "---\nid: \"choose-integrate-or-ui\"\ntype: \"scenario\"\ntitle: \"Choose integrate-or-UI path\"\nsummary: \"Decide whether to embed the engine in code or use the local UIs first.\"\naudiences: [\"developers\", \"builders\"]\n---\n# Choose integrate-or-UI path\n\n# Choose integrate-or-UI path\n\nStart with **Playground** only if you are iterating on Markdown/template look. Otherwise install the surface that matches how the document will be produced in production.\n\nFollow the Pick a surface guide for install commands.",
+    "agent/SEARCH.json": "{\n  \"version\": 1,\n  \"product\": \"mdreports\",\n  \"generatedAt\": \"2026-07-26T12:49:20.367Z\",\n  \"records\": [\n    {\n      \"id\": \"render-pipeline\",\n      \"type\": \"concept\",\n      \"title\": \"Render pipeline\",\n      \"summary\": \"Markdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [],\n      \"goals\": [],\n      \"path\": \"concepts/render-pipeline.md\",\n      \"webPath\": \"/concepts/render-pipeline\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": [\n        \"concept/render-pipeline\"\n      ]\n    },\n    {\n      \"id\": \"pick-a-surface\",\n      \"type\": \"guide\",\n      \"title\": \"Pick a surface\",\n      \"summary\": \"Choose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [],\n      \"goals\": [],\n      \"path\": \"guides/pick-a-surface.md\",\n      \"webPath\": \"/guides/pick-a-surface\",\n      \"prerequisites\": [\n        \"render-pipeline\"\n      ],\n      \"related\": [],\n      \"packIds\": [\n        \"guide/pick-a-surface\"\n      ]\n    },\n    {\n      \"id\": \"choose-integrate-or-ui\",\n      \"type\": \"scenario\",\n      \"title\": \"Choose integrate-or-UI path\",\n      \"summary\": \"Decide whether to embed the engine in code or use the local UIs first.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [],\n      \"goals\": [\n        \"Should you start in the local UIs or install a package surface?\"\n      ],\n      \"path\": \"scenarios/choose-integrate-or-ui.md\",\n      \"webPath\": \"/scenarios/choose-integrate-or-ui\",\n      \"prerequisites\": [\n        \"render-pipeline\"\n      ],\n      \"related\": [\n        \"pick-a-surface\"\n      ],\n      \"packIds\": [\n        \"scenario/choose-integrate-or-ui\"\n      ]\n    },\n    {\n      \"id\": \"orient-mdreports\",\n      \"type\": \"use-case\",\n      \"title\": \"Orient on Markdown Reports Studio\",\n      \"summary\": \"Understand formats, surfaces, and the one render pipeline before installing anything.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [\n        \"platform\",\n        \"start-here\"\n      ],\n      \"goals\": [\n        \"Understand formats, surfaces, and the one render pipeline before installing anything.\"\n      ],\n      \"path\": \"use-cases/orient-mdreports.md\",\n      \"webPath\": \"/use-cases#orient-mdreports\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"00-overview\",\n        \"02-getting-started\"\n      ],\n      \"packIds\": [\n        \"use-case/orient-mdreports\"\n      ]\n    },\n    {\n      \"id\": \"pick-a-surface\",\n      \"type\": \"use-case\",\n      \"title\": \"Pick a surface and first render\",\n      \"summary\": \"Choose CLI, SDK, API, or MCP and produce a first PDF/DOCX/PPTX.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [\n        \"getting-started\",\n        \"quickstart\"\n      ],\n      \"goals\": [\n        \"Choose CLI, SDK, API, or MCP and produce a first PDF/DOCX/PPTX.\"\n      ],\n      \"path\": \"use-cases/pick-a-surface.md\",\n      \"webPath\": \"/use-cases#pick-a-surface\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"01-packages\",\n        \"02-getting-started\"\n      ],\n      \"packIds\": [\n        \"use-case/pick-a-surface\"\n      ]\n    },\n    {\n      \"id\": \"map-packages\",\n      \"type\": \"use-case\",\n      \"title\": \"Map the @x12i/mdreports-* packages\",\n      \"summary\": \"Know which npm package owns core, CLI, API, client, MCP, types, and templates.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"packages\",\n        \"npm\"\n      ],\n      \"goals\": [\n        \"Know which npm package owns core, CLI, API, client, MCP, types, and templates.\"\n      ],\n      \"path\": \"use-cases/map-packages.md\",\n      \"webPath\": \"/use-cases#map-packages\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"01-packages\"\n      ],\n      \"packIds\": [\n        \"use-case/map-packages\"\n      ]\n    },\n    {\n      \"id\": \"render-with-sdk\",\n      \"type\": \"use-case\",\n      \"title\": \"Render in-process with the SDK\",\n      \"summary\": \"Call renderToHtml/Pdf/Docx/Pptx, shut down Chromium, and use TemplateStore.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"sdk\",\n        \"core\"\n      ],\n      \"goals\": [\n        \"Call renderToHtml/Pdf/Docx/Pptx, shut down Chromium, and use TemplateStore.\"\n      ],\n      \"path\": \"use-cases/render-with-sdk.md\",\n      \"webPath\": \"/use-cases#render-with-sdk\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"03-sdk\",\n        \"07-templates\"\n      ],\n      \"packIds\": [\n        \"use-case/render-with-sdk\"\n      ]\n    },\n    {\n      \"id\": \"render-with-cli\",\n      \"type\": \"use-case\",\n      \"title\": \"Render from the CLI\",\n      \"summary\": \"Use mdreports render and templates commands from the shell.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"cli\"\n      ],\n      \"goals\": [\n        \"Use mdreports render and templates commands from the shell.\"\n      ],\n      \"path\": \"use-cases/render-with-cli.md\",\n      \"webPath\": \"/use-cases#render-with-cli\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"04-cli\"\n      ],\n      \"packIds\": [\n        \"use-case/render-with-cli\"\n      ]\n    },\n    {\n      \"id\": \"call-http-api\",\n      \"type\": \"use-case\",\n      \"title\": \"Run and call the HTTP API\",\n      \"summary\": \"Start mdreports-api and render via curl or the typed client.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"api\",\n        \"http\"\n      ],\n      \"goals\": [\n        \"Start mdreports-api and render via curl or the typed client.\"\n      ],\n      \"path\": \"use-cases/call-http-api.md\",\n      \"webPath\": \"/use-cases#call-http-api\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"05-api\"\n      ],\n      \"packIds\": [\n        \"use-case/call-http-api\"\n      ]\n    },\n    {\n      \"id\": \"wire-mcp-agents\",\n      \"type\": \"use-case\",\n      \"title\": \"Wire MCP tools for agents\",\n      \"summary\": \"Install the MCP server and expose render/template tools to Cursor or Claude.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"mcp\",\n        \"agents\"\n      ],\n      \"goals\": [\n        \"Install the MCP server and expose render/template tools to Cursor or Claude.\"\n      ],\n      \"path\": \"use-cases/wire-mcp-agents.md\",\n      \"webPath\": \"/use-cases#wire-mcp-agents\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"06-mcp\"\n      ],\n      \"packIds\": [\n        \"use-case/wire-mcp-agents\"\n      ]\n    },\n    {\n      \"id\": \"author-templates\",\n      \"type\": \"use-case\",\n      \"title\": \"Author and store templates\",\n      \"summary\": \"Understand the template directory contract, built-ins, user store, and PPTX rules.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [\n        \"templates\",\n        \"studio\"\n      ],\n      \"goals\": [\n        \"Understand the template directory contract, built-ins, user store, and PPTX rules.\"\n      ],\n      \"path\": \"use-cases/author-templates.md\",\n      \"webPath\": \"/use-cases#author-templates\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"07-templates\"\n      ],\n      \"packIds\": [\n        \"use-case/author-templates\"\n      ]\n    },\n    {\n      \"id\": \"00-overview\",\n      \"type\": \"book\",\n      \"title\": \"Overview\",\n      \"summary\": \"Surfaces, formats, and the render pipeline — where Markdown Reports Studio fits.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-00\"\n      ],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [\n        \"platform\",\n        \"start-here\",\n        \"overview\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/00-overview/\",\n      \"webPath\": \"/books/00-overview\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    },\n    {\n      \"id\": \"01-packages\",\n      \"type\": \"book\",\n      \"title\": \"Packages\",\n      \"summary\": \"Which npm package to install for SDK, CLI, API, client, MCP, types, and templates.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-01\"\n      ],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"packages\",\n        \"npm\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/01-packages/\",\n      \"webPath\": \"/books/01-packages\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    },\n    {\n      \"id\": \"02-getting-started\",\n      \"type\": \"book\",\n      \"title\": \"Getting Started\",\n      \"summary\": \"CLI, SDK, HTTP API, or MCP — first successful PDF/DOCX/PPTX in minutes.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-02\"\n      ],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [\n        \"getting-started\",\n        \"quickstart\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/02-getting-started/\",\n      \"webPath\": \"/books/02-getting-started\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    },\n    {\n      \"id\": \"03-sdk\",\n      \"type\": \"book\",\n      \"title\": \"SDK\",\n      \"summary\": \"In-process HTML/PDF/DOCX/PPTX render, TemplateStore, and create-from-image.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-03\"\n      ],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"sdk\",\n        \"node\",\n        \"core\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/03-sdk/\",\n      \"webPath\": \"/books/03-sdk\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    },\n    {\n      \"id\": \"04-cli\",\n      \"type\": \"book\",\n      \"title\": \"CLI\",\n      \"summary\": \"Render from the shell and manage templates with create-from-html / create-from-image.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-04\"\n      ],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"cli\",\n        \"shell\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/04-cli/\",\n      \"webPath\": \"/books/04-cli\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    },\n    {\n      \"id\": \"05-api\",\n      \"type\": \"book\",\n      \"title\": \"HTTP API\",\n      \"summary\": \"Run mdreports-api and call it with curl or @x12i/mdreports-api-client.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-05\"\n      ],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"api\",\n        \"http\",\n        \"client\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/05-api/\",\n      \"webPath\": \"/books/05-api\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    },\n    {\n      \"id\": \"06-mcp\",\n      \"type\": \"book\",\n      \"title\": \"MCP\",\n      \"summary\": \"Wire @x12i/mdreports-mcp-server into Cursor or Claude for render and template tools.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-06\"\n      ],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"mcp\",\n        \"agents\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/06-mcp/\",\n      \"webPath\": \"/books/06-mcp\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    },\n    {\n      \"id\": \"07-templates\",\n      \"type\": \"book\",\n      \"title\": \"Templates\",\n      \"summary\": \"Template directory contract, built-ins, user store, and PPTX slide rules.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-07\"\n      ],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [\n        \"templates\",\n        \"html\",\n        \"css\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/07-templates/\",\n      \"webPath\": \"/books/07-templates\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    }\n  ]\n}",
+    "agent/use-cases/author-templates.md": "# Author and store templates\n\n> **Use case id:** `author-templates`\n> **Goal:** Understand the template directory contract, built-ins, user store, and PPTX rules.\n> **Audiences:** developers, builders\n> **Tags:** templates, studio\n\n## Reading path\n\n1. **Templates** (builders) → chapters: `1-built-ins`, `2-layout-contract`, `3-user-templates`, `4-images-in-markdown`, `5-pptx`\n\n## From: Templates — 1. Built-ins\n\nStart here before inventing a new layout:\n\n| Id | Best for |\n| --- | --- |\n| `clean-report` | Multi-section reports |\n| `letter` | Short correspondence |\n| `technical-doc` | Technical documentation |\n\n---\n\n## From: Templates — 2. Layout contract\n\nA template folder is three files:\n\n| File | Role |\n| --- | --- |\n| `template.json` | Id, name, page/theme/DOCX/PPTX styles, meta slots |\n| `layout.html` | Shell with `</head>` and `<!--CONTENT-->` |\n| `styles.css` | Look-and-feel injected into the shell |\n\nKeep slot names stable; renderers fill them from Markdown and frontmatter.\n\n---\n\n## From: Templates — 3. User templates\n\nYour custom templates live under `~/.mdreports/templates` (or a path your team sets). Built-ins are never overwritten.\n\nCreate from:\n\n- Studio UI (HTML or design screenshot)\n- CLI `create-from-html` / `create-from-image`\n- Asking an agent via MCP when configured\n\nScreenshot drafts need an Anthropic API key.\n\n---\n\n## From: Templates — 4. Images in Markdown\n\nPrefer absolute HTTPS image URLs in source Markdown so HTML and PDF previews stay reliable.\n\n---\n\n## From: Templates — 5. PPTX\n\nSlides are landscape 16:9. Structure decks with `#` headings — one H1 per slide. Put deck title in YAML frontmatter `title` for an opening title slide.\n\n## Also see\n\n- **Templates** (`07-templates`) — Template directory contract, built-ins, user store, and PPTX slide rules.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "agent/use-cases/call-http-api.md": "# Run and call the HTTP API\n\n> **Use case id:** `call-http-api`\n> **Goal:** Start mdreports-api and render via curl or the typed client.\n> **Audiences:** developers\n> **Tags:** api, http\n\n## Reading path\n\n1. **HTTP API** (developers) → chapters: `1-run`, `2-call-with-curl`, `3-typed-client`, `4-route-summary`\n\n## From: HTTP API — 1. Run\n\n```bash\nnpm install -g @x12i/mdreports-api\nnpx playwright install chromium\nmdreports-api\n```\n\nOptional env:\n\n| Variable | Purpose |\n| --- | --- |\n| `MDREPORTS_API_PORT` / `PORT` | Listen port (default **6460**) |\n| `MDREPORTS_API_KEY` | If set, require `Authorization: Bearer <key>` (except `/health`) |\n| `MDREPORTS_TEMPLATES_DIR` | User templates directory |\n\n---\n\n## From: HTTP API — 2. Call with curl\n\n```bash\ncurl -s http://localhost:6460/health\n\ncurl -s http://localhost:6460/templates | jq .\n\ncurl -s -X POST http://localhost:6460/render/html \\\n  -H 'content-type: application/json' \\\n  -d '{\"markdown\":\"# Hello\",\"templateId\":\"clean-report\"}' | jq .\n\ncurl -s -X POST http://localhost:6460/render/pdf \\\n  -H 'content-type: application/json' \\\n  -d '{\"markdown\":\"# Hello\",\"templateId\":\"clean-report\"}' \\\n  --output report.pdf\n\ncurl -s -X POST http://localhost:6460/render/pptx \\\n  -H 'content-type: application/json' \\\n  -d '{\"markdown\":\"# Hello\\n\\nSlide body\",\"templateId\":\"clean-report\"}' \\\n  --output report.pptx\n```\n\n---\n\n## From: HTTP API — 3. Typed client\n\n```bash\nnpm install @x12i/mdreports-api-client\n```\n\n```ts\nimport { ApiClient } from \"@x12i/mdreports-api-client\";\n\nconst client = new ApiClient({\n  baseUrl: \"http://localhost:6460\",\n  apiKey: process.env.MDREPORTS_API_KEY\n});\n\nconst pdf = await client.renderPdf(\"# Hello\", \"clean-report\");\nconst templates = await client.listTemplates();\n```\n\n---\n\n## From: HTTP API — 4. Route summary\n\n| Method | Path | Description |\n| --- | --- |\n| `GET` | `/health` | Liveness (no auth) |\n| `GET` | `/templates` | List templates |\n| `GET` | `/templates/:id` | Get template |\n| `POST` | `/templates/from-html` | Create from HTML + CSS |\n| `POST` | `/templates/from-image` | Create from image (multipart) |\n| `PATCH` | `/templates/:id` | Update user template |\n| `DELETE` | `/templates/:id` | Delete user template |\n| `POST` | `/render/html` | Markdown → HTML JSON |\n| `POST` | `/render/pdf` | Markdown → PDF bytes |\n| `POST` | `/render/docx` | Markdown → DOCX bytes |\n| `POST` | `/render/pptx` | Markdown → PPTX bytes |\n\n## Also see\n\n- **HTTP API** (`05-api`) — Run mdreports-api and call it with curl or @x12i/mdreports-api-client.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "agent/use-cases/map-packages.md": "# Map the @x12i/mdreports-* packages\n\n> **Use case id:** `map-packages`\n> **Goal:** Know which npm package owns core, CLI, API, client, MCP, types, and templates.\n> **Audiences:** developers\n> **Tags:** packages, npm\n\n## Reading path\n\n1. **Packages** (developers) → chapters: `1-package-table`, `2-dependency-shape`, `3-naming-note`\n\n## From: Packages — 1. Package table\n\n| Package | When to install |\n| --- | --- |\n| `@x12i/mdreports-core` | In-process HTML/PDF/DOCX/PPTX + `TemplateStore` |\n| `@x12i/mdreports-cli` | Shell command `mdreports` |\n| `@x12i/mdreports-api` | Network service `mdreports-api` |\n| `@x12i/mdreports-api-client` | Typed `fetch` client for the HTTP API |\n| `@x12i/mdreports-mcp-server` | MCP tools over stdio |\n| `@x12i/mdreports-types` | Shared Zod schemas / TS types |\n| `@x12i/mdreports-templates` | Rarely — pulled in by core |\n\nNot published: `apps/playground`, `apps/studio` (run from this monorepo).\n\nKnowledge for agents/humans: `@x12i/mdreports-docs` (this library) — install as a **devDependency** only.\n\n---\n\n## From: Packages — 2. Dependency shape\n\n```\n@x12i/mdreports-types\n        ↑\n@x12i/mdreports-templates ──→ @x12i/mdreports-core ──→ CLI / API / MCP\n                                   ↓\n                         @x12i/mdreports-api-client  (HTTP → API)\n```\n\nCore formats: **HTML**, **PDF**, **DOCX**, and landscape **PPTX** (H1 = new slide).\n\n---\n\n## From: Packages — 3. Naming note\n\nShort names like `@x12i/core` / `@x12i/cli` are already used by another x12i project on npm, so this product publishes under `@x12i/mdreports-*`.\n\n## Also see\n\n- **Packages** (`01-packages`) — Which npm package to install for SDK, CLI, API, client, MCP, types, and templates.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "agent/use-cases/orient-mdreports.md": "# Orient on Markdown Reports Studio\n\n> **Use case id:** `orient-mdreports`\n> **Goal:** Understand formats, surfaces, and the one render pipeline before installing anything.\n> **Audiences:** developers, builders\n> **Tags:** platform, start-here\n\n## Reading path\n\n1. **Overview** (developers) → chapters: `1-what-it-is`, `2-formats-and-surfaces`, `3-how-rendering-works`, `4-where-to-go-next`\n\n## From: Overview — 1. What it is\n\nTurn Markdown into styled **PDF**, **Word (DOCX)**, **PowerPoint (PPTX)**, and **HTML** using swappable templates.\n\n**Not** a CMS or collaborative editor — a render pipeline: Markdown in, branded document out.\n\nOne engine powers every surface: SDK, CLI, HTTP API, MCP server, Playground UI, and Studio UI.\n\n---\n\n## From: Overview — 2. Formats and surfaces\n\n| Capability | Details |\n| --- | --- |\n| Formats | HTML, PDF (Playwright Chromium), DOCX, PPTX (landscape 16:9) |\n| Templates | Built-ins (`clean-report`, `letter`, `technical-doc`) + your own |\n| Frontmatter | YAML (e.g. `title`) fills template slots |\n| Surfaces | SDK, CLI (`mdreports`), HTTP API, MCP, Playground (`:6461`), Studio (`:6463`) |\n\nAll published packages are public under `@x12i/mdreports-*` on npm.\n\nPDF needs Chromium once per machine: `npx playwright install chromium`. Requires **Node.js 20.11+**.\n\n---\n\n## From: Overview — 3. How rendering works\n\n1. **Parse** Markdown (including YAML frontmatter).\n2. **Load template** by id — built-in or user template from disk.\n3. **Inject** CSS into `layout.html` and fill slots (`<!--CONTENT-->`, `<!--TITLE-->`, meta slots).\n4. **Emit** HTML string, PDF via pooled Chromium, DOCX/PPTX from the Markdown AST.\n\nAlways call `shutdown()` in SDK/long-lived processes so the browser exits cleanly.\n\n### Known limitations\n\n- **HTML/PDF images**: absolute `http(s)` URLs or data URIs only.\n- **DOCX / PPTX images**: local paths and URLs are best-effort; failures become `[image: alt]`.\n- **DOCX / PPTX code blocks**: monospace + shading — no syntax highlighting.\n- **PPTX overflow**: long content under a single H1 is not auto-split (may clip).\n- **Raw HTML in Markdown**: kept for HTML/PDF; dropped for DOCX and PPTX.\n\n---\n\n## From: Overview — 4. Where to go next\n\n| Goal | Book / use case |\n| --- | --- |\n| First successful file | Getting Started · `pick-a-surface` |\n| Which package to install | Packages · `map-packages` |\n| Custom look | Templates · `author-templates` |\n| Agent tools | MCP · `wire-mcp-agents` |\n\n## Also see\n\n- **Overview** (`00-overview`) — Surfaces, formats, and the render pipeline — where Markdown Reports Studio fits.\n- **Getting Started** (`02-getting-started`) — CLI, SDK, HTTP API, or MCP — first successful PDF/DOCX/PPTX in minutes.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "agent/use-cases/pick-a-surface.md": "# Pick a surface and first render\n\n> **Use case id:** `pick-a-surface`\n> **Goal:** Choose CLI, SDK, API, or MCP and produce a first PDF/DOCX/PPTX.\n> **Audiences:** developers, builders\n> **Tags:** getting-started, quickstart\n\n## Reading path\n\n1. **Getting Started** (developers) → chapters: `1-prerequisites`, `2-option-a-cli`, `3-option-b-sdk`, `4-option-c-http-api`, `5-option-d-mcp`, `6-built-in-templates`\n\n## From: Getting Started — 1. Prerequisites\n\n- Node.js **20.11+**\n- Chromium for PDF: `npx playwright install chromium`\n\n---\n\n## From: Getting Started — 2. Option A — CLI\n\n```bash\nnpm install -g @x12i/mdreports-cli\nnpx playwright install chromium\n\nmdreports templates list\nmdreports render --in report.md --template clean-report --format pdf --out report.pdf\nmdreports render --in report.md --template clean-report --format pptx --out report.pptx\n```\n\n---\n\n## From: Getting Started — 3. Option B — SDK\n\n```bash\nnpm install @x12i/mdreports-core\nnpx playwright install chromium\n```\n\n```ts\nimport { renderToPdf, renderToPptx, shutdown } from \"@x12i/mdreports-core\";\nimport { writeFile } from \"node:fs/promises\";\n\nconst pdf = await renderToPdf(\"# Hello\\n\\nWorld\", \"clean-report\");\nawait writeFile(\"report.pdf\", pdf);\n\nconst pptx = await renderToPptx(\"# Hello\\n\\nWorld\", \"clean-report\");\nawait writeFile(\"report.pptx\", pptx);\nawait shutdown();\n```\n\n---\n\n## From: Getting Started — 4. Option C — HTTP API\n\n```bash\nnpm install -g @x12i/mdreports-api\nnpx playwright install chromium\nmdreports-api   # http://localhost:6460\n```\n\n```ts\nimport { ApiClient } from \"@x12i/mdreports-api-client\";\n\nconst client = new ApiClient({ baseUrl: \"http://localhost:6460\" });\nconst pdf = await client.renderPdf(\"# Hello\", \"clean-report\");\n```\n\n---\n\n## From: Getting Started — 5. Option D — MCP\n\n```json\n{\n  \"mcpServers\": {\n    \"mdreports\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@x12i/mdreports-mcp-server\"]\n    }\n  }\n}\n```\n\n---\n\n## From: Getting Started — 6. Built-in templates\n\n- `clean-report` — multi-section reports\n- `letter` — short correspondence\n- `technical-doc` — technical documentation\n\nCreate your own with CLI `templates create-from-html` / `create-from-image`, the SDK, or Studio.\n\n## Also see\n\n- **Packages** (`01-packages`) — Which npm package to install for SDK, CLI, API, client, MCP, types, and templates.\n- **Getting Started** (`02-getting-started`) — CLI, SDK, HTTP API, or MCP — first successful PDF/DOCX/PPTX in minutes.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "agent/use-cases/render-with-cli.md": "# Render from the CLI\n\n> **Use case id:** `render-with-cli`\n> **Goal:** Use mdreports render and templates commands from the shell.\n> **Audiences:** developers\n> **Tags:** cli\n\n## Reading path\n\n1. **CLI** (developers) → chapters: `1-install`, `2-render`, `3-templates`\n\n## From: CLI — 1. Install\n\n```bash\nnpm install -g @x12i/mdreports-cli\nnpx playwright install chromium\n```\n\nBinary name: `mdreports`.\n\n---\n\n## From: CLI — 2. Render\n\n```bash\nmdreports render --in report.md --template clean-report --format pdf --out report.pdf\nmdreports render --in report.md --template letter --format docx\nmdreports render --in report.md --template clean-report --format pptx\nmdreports render --in report.md --template technical-doc --format html\n```\n\n---\n\n## From: CLI — 3. Templates\n\n```bash\nmdreports templates list\nmdreports templates list --json\nmdreports templates show clean-report\nmdreports templates create-from-html --id my-layout --name \"My Layout\" \\\n  --layout layout.html --styles styles.css\nmdreports templates create-from-image --id from-shot --name \"From Shot\" \\\n  --image design.png\nmdreports templates delete my-layout\n```\n\n`--templates-dir` overrides the user templates directory on any command.\n\n## Also see\n\n- **CLI** (`04-cli`) — Render from the shell and manage templates with create-from-html / create-from-image.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "agent/use-cases/render-with-sdk.md": "# Render in-process with the SDK\n\n> **Use case id:** `render-with-sdk`\n> **Goal:** Call renderToHtml/Pdf/Docx/Pptx, shut down Chromium, and use TemplateStore.\n> **Audiences:** developers\n> **Tags:** sdk, core\n\n## Reading path\n\n1. **SDK** (developers) → chapters: `1-install`, `2-render`, `3-template-store`, `4-ai-template-from-image`\n\n## From: SDK — 1. Install\n\n```bash\nnpm install @x12i/mdreports-core\nnpx playwright install chromium\n```\n\n---\n\n## From: SDK — 2. Render\n\n```ts\nimport { renderToHtml, renderToPdf, renderToDocx, renderToPptx, shutdown } from \"@x12i/mdreports-core\";\n\nconst md = `---\ntitle: Q1 Report\n---\n\n# Summary\n\nBody here.\n`;\n\nconst { html, title } = await renderToHtml(md, \"clean-report\");\nconst pdf = await renderToPdf(md, \"clean-report\", {\n  pdf: { format: \"Letter\", landscape: false }\n});\nconst docx = await renderToDocx(md, \"technical-doc\");\nconst pptx = await renderToPptx(md, \"clean-report\"); // landscape 16:9; each H1 = new slide\n\nawait shutdown();\n```\n\nAlways call `shutdown()` when your process is done (or on SIGTERM in long-lived servers) so Playwright exits cleanly.\n\n---\n\n## From: SDK — 3. Template store\n\n```ts\nimport { TemplateStore } from \"@x12i/mdreports-core\";\n\nconst store = new TemplateStore({\n  templatesDir: \"./my-templates\" // optional; else MDREPORTS_TEMPLATES_DIR or ~/.mdreports/templates\n});\n\nconst all = await store.list();\nconst one = await store.get(\"clean-report\");\n\nawait store.createFromHtml({\n  id: \"brand-report\",\n  name: \"Brand Report\",\n  layoutHtml: \"<!doctype html><html><head></head><body><main><!--CONTENT--></main></body></html>\",\n  stylesCss: \"main { max-width: 720px; margin: 0 auto; }\"\n});\n\nawait store.update(\"brand-report\", { name: \"Brand Report v2\" });\nawait store.delete(\"brand-report\");\n```\n\nBuilt-in templates cannot be updated or deleted.\n\n---\n\n## From: SDK — 4. AI template from image\n\n```ts\nimport { readFile } from \"node:fs/promises\";\nimport { createTemplateFromImage, shutdown } from \"@x12i/mdreports-core\";\n\nconst imageBuffer = await readFile(\"design.png\");\nawait createTemplateFromImage({\n  id: \"from-design\",\n  name: \"From Design\",\n  imageBuffer,\n  imageMediaType: \"image/png\",\n  anthropicApiKey: process.env.ANTHROPIC_API_KEY!\n});\nawait shutdown();\n```\n\n## Also see\n\n- **SDK** (`03-sdk`) — In-process HTML/PDF/DOCX/PPTX render, TemplateStore, and create-from-image.\n- **Templates** (`07-templates`) — Template directory contract, built-ins, user store, and PPTX slide rules.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "agent/use-cases/wire-mcp-agents.md": "# Wire MCP tools for agents\n\n> **Use case id:** `wire-mcp-agents`\n> **Goal:** Install the MCP server and expose render/template tools to Cursor or Claude.\n> **Audiences:** developers\n> **Tags:** mcp, agents\n\n## Reading path\n\n1. **MCP** (developers) → chapters: `1-run-configure`, `2-tools`\n\n## From: MCP — 1. Run configure\n\n```bash\nnpm install -g @x12i/mdreports-mcp-server\nnpx playwright install chromium\n```\n\nExample MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"mdreports\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@x12i/mdreports-mcp-server\"],\n      \"env\": {\n        \"ANTHROPIC_API_KEY\": \"optional\"\n      }\n    }\n  }\n}\n```\n\nOptional: `MDREPORTS_TEMPLATES_DIR` for the user template store.\n\n---\n\n## From: MCP — 2. Tools\n\n- `list_templates` / `get_template`\n- `render_markdown_to_html` (returns HTML inline)\n- `render_markdown_to_pdf` / `render_markdown_to_docx` / `render_markdown_to_pptx` (write a file; optional `outPath`)\n- `create_template_from_html` / `create_template_from_image` / `delete_template`\n\nPPTX is always landscape 16:9; each `#` heading starts a new slide.\n\n## Also see\n\n- **MCP** (`06-mcp`) — Wire @x12i/mdreports-mcp-server into Cursor or Claude for render and template tools.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "agent-manifest.json": "{\n  \"version\": 1,\n  \"product\": \"mdreports\",\n  \"site\": \"https://docs.mdreports.x12i.com\",\n  \"knowledgePackage\": \"@x12i/mdreports-docs\",\n  \"roles\": [\n    \"developers\",\n    \"builders\"\n  ],\n  \"books\": [\n    {\n      \"id\": \"00-overview\",\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/00-overview/developers.md\",\n        \"builders\": \"downloads/books/00-overview/builders.md\"\n      },\n      \"pdf\": {\n        \"developers\": null,\n        \"builders\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/00-overview/developers.chapters.json\",\n        \"builders\": \"downloads/books/00-overview/builders.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"01-packages\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/01-packages/developers.md\"\n      },\n      \"pdf\": {\n        \"developers\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/01-packages/developers.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"02-getting-started\",\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/02-getting-started/developers.md\",\n        \"builders\": \"downloads/books/02-getting-started/builders.md\"\n      },\n      \"pdf\": {\n        \"developers\": null,\n        \"builders\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/02-getting-started/developers.chapters.json\",\n        \"builders\": \"downloads/books/02-getting-started/builders.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"03-sdk\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/03-sdk/developers.md\"\n      },\n      \"pdf\": {\n        \"developers\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/03-sdk/developers.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"04-cli\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/04-cli/developers.md\"\n      },\n      \"pdf\": {\n        \"developers\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/04-cli/developers.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"05-api\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/05-api/developers.md\"\n      },\n      \"pdf\": {\n        \"developers\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/05-api/developers.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"06-mcp\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/06-mcp/developers.md\"\n      },\n      \"pdf\": {\n        \"developers\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/06-mcp/developers.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"07-templates\",\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/07-templates/developers.md\",\n        \"builders\": \"downloads/books/07-templates/builders.md\"\n      },\n      \"pdf\": {\n        \"developers\": null,\n        \"builders\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/07-templates/developers.chapters.json\",\n        \"builders\": \"downloads/books/07-templates/builders.chapters.json\"\n      }\n    }\n  ],\n  \"useCases\": [\n    {\n      \"id\": \"orient-mdreports\",\n      \"title\": \"Orient on Markdown Reports Studio\",\n      \"md\": \"downloads/use-cases/orient-mdreports.md\",\n      \"path\": [\n        {\n          \"bookId\": \"00-overview\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-what-it-is\",\n            \"2-formats-and-surfaces\",\n            \"3-how-rendering-works\",\n            \"4-where-to-go-next\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"pick-a-surface\",\n      \"title\": \"Pick a surface and first render\",\n      \"md\": \"downloads/use-cases/pick-a-surface.md\",\n      \"path\": [\n        {\n          \"bookId\": \"02-getting-started\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-prerequisites\",\n            \"2-option-a-cli\",\n            \"3-option-b-sdk\",\n            \"4-option-c-http-api\",\n            \"5-option-d-mcp\",\n            \"6-built-in-templates\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"map-packages\",\n      \"title\": \"Map the @x12i/mdreports-* packages\",\n      \"md\": \"downloads/use-cases/map-packages.md\",\n      \"path\": [\n        {\n          \"bookId\": \"01-packages\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-package-table\",\n            \"2-dependency-shape\",\n            \"3-naming-note\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"render-with-sdk\",\n      \"title\": \"Render in-process with the SDK\",\n      \"md\": \"downloads/use-cases/render-with-sdk.md\",\n      \"path\": [\n        {\n          \"bookId\": \"03-sdk\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-install\",\n            \"2-render\",\n            \"3-template-store\",\n            \"4-ai-template-from-image\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"render-with-cli\",\n      \"title\": \"Render from the CLI\",\n      \"md\": \"downloads/use-cases/render-with-cli.md\",\n      \"path\": [\n        {\n          \"bookId\": \"04-cli\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-install\",\n            \"2-render\",\n            \"3-templates\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"call-http-api\",\n      \"title\": \"Run and call the HTTP API\",\n      \"md\": \"downloads/use-cases/call-http-api.md\",\n      \"path\": [\n        {\n          \"bookId\": \"05-api\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-run\",\n            \"2-call-with-curl\",\n            \"3-typed-client\",\n            \"4-route-summary\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"wire-mcp-agents\",\n      \"title\": \"Wire MCP tools for agents\",\n      \"md\": \"downloads/use-cases/wire-mcp-agents.md\",\n      \"path\": [\n        {\n          \"bookId\": \"06-mcp\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-run-configure\",\n            \"2-tools\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"author-templates\",\n      \"title\": \"Author and store templates\",\n      \"md\": \"downloads/use-cases/author-templates.md\",\n      \"path\": [\n        {\n          \"bookId\": \"07-templates\",\n          \"audience\": \"builders\",\n          \"chapters\": [\n            \"1-built-ins\",\n            \"2-layout-contract\",\n            \"3-user-templates\",\n            \"4-images-in-markdown\",\n            \"5-pptx\"\n          ]\n        }\n      ]\n    }\n  ],\n  \"indexes\": {\n    \"indexMd\": \"INDEX.md\",\n    \"searchJson\": \"SEARCH.json\"\n  },\n  \"concepts\": [\n    {\n      \"id\": \"render-pipeline\",\n      \"title\": \"Render pipeline\",\n      \"md\": \"concepts/render-pipeline.md\"\n    }\n  ],\n  \"guides\": [\n    {\n      \"id\": \"pick-a-surface\",\n      \"title\": \"Pick a surface\",\n      \"md\": \"guides/pick-a-surface.md\"\n    }\n  ],\n  \"scenarios\": [\n    {\n      \"id\": \"choose-integrate-or-ui\",\n      \"title\": \"Choose integrate-or-UI path\",\n      \"md\": \"scenarios/choose-integrate-or-ui.md\"\n    }\n  ],\n  \"decisions\": [],\n  \"glossary\": [],\n  \"visuals\": [],\n  \"diagrams\": [],\n  \"relationships\": [],\n  \"tutorials\": [],\n  \"examples\": [],\n  \"sampleData\": [],\n  \"uiClients\": [],\n  \"apis\": [],\n  \"packs\": [\n    {\n      \"id\": \"concept/render-pipeline\",\n      \"type\": \"concept\",\n      \"path\": \"packs/concept/render-pipeline\"\n    },\n    {\n      \"id\": \"guide/pick-a-surface\",\n      \"type\": \"guide\",\n      \"path\": \"packs/guide/pick-a-surface\"\n    },\n    {\n      \"id\": \"scenario/choose-integrate-or-ui\",\n      \"type\": \"scenario\",\n      \"path\": \"packs/scenario/choose-integrate-or-ui\"\n    }\n  ]\n}",
+    "concepts/render-pipeline.md": "---\nid: \"render-pipeline\"\ntype: \"concept\"\ntitle: \"Render pipeline\"\nsummary: \"Markdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine.\"\nproblem: \"Teams reimplement Markdown rendering per surface and drift on templates, slots, and export fidelity.\"\nwhy: \"One core (`@x12i/mdreports-core`) keeps CLI, API, MCP, Playground, and Studio on the same contract.\"\nmentalModel: \"Parse Markdown → load template → inject CSS/slots → emit the requested format.\"\naudiences: [\"developers\", \"builders\"]\nnext: [\"pick-a-surface\"]\n---\n# Render pipeline\n\n# Render pipeline\n\n## Answer\n\nMarkdown Reports Studio is a **render pipeline**: Markdown in, branded document out — not a CMS.\n\n## Problem\n\nWithout a shared engine, PDF/DOCX/HTML exports diverge per tool and templates stop composing.\n\n## Why\n\nSDK, CLI, HTTP API, MCP, Playground, and Studio all call the same core so template ids and frontmatter behave identically.\n\n## Mental model\n\n1. Parse Markdown (YAML frontmatter fills slots).\n2. Load a template (`layout.html` + `styles.css` + `template.json`).\n3. Inject CSS and fill slots (`<!--CONTENT-->`, `<!--TITLE-->`, meta slots).\n4. Emit HTML, PDF (Playwright), DOCX, or PPTX.\n\n## Example\n\n```ts\nimport { renderToPdf, shutdown } from \"@x12i/mdreports-core\";\n\nconst pdf = await renderToPdf(\"# Hello\", \"clean-report\");\nawait shutdown();\n```\n\n## How it works\n\nBuilt-in templates ship in `@x12i/mdreports-templates`. User templates live under `~/.mdreports/templates` (or `MDREPORTS_TEMPLATES_DIR`).\n\n## Next\n\nPick a surface — CLI for shells, SDK for Node, API for services, MCP for agents.",
+    "downloads/books/00-overview/builders.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"1-what-it-is\",\n    \"title\": \"1. What it is\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"2-formats-and-surfaces\",\n    \"title\": \"2. Formats and surfaces\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"3-how-rendering-works\",\n    \"title\": \"3. How rendering works\",\n    \"level\": 2,\n    \"order\": 3\n  },\n  {\n    \"slug\": \"4-where-to-go-next\",\n    \"title\": \"4. Where to go next\",\n    \"level\": 2,\n    \"order\": 4\n  }\n]",
+    "downloads/books/00-overview/builders.md": "# Overview — Builders\n\n**Audience:** Template authors and Studio users.  \n**Twin:** [Developers version](../developers/BOOK.md)\n\n---\n\n## 1. What it is\n\nMarkdown Reports Studio turns Markdown into branded **PDF**, **DOCX**, **PPTX**, and **HTML** using templates you can browse and edit in Studio.\n\nYou do not need to change the renderer to ship a new look — author HTML+CSS templates (or draft from a screenshot) and pick them at render time.\n\n---\n\n## 2. Formats and surfaces\n\n| You want… | Use |\n| --- | --- |\n| Try Markdown → preview / download | Playground (repo, port **6461**) |\n| Browse / create / edit templates | Studio (repo, port **6463**) |\n| Built-in looks without custom work | `clean-report`, `letter`, `technical-doc` |\n\nDevelopers wire SDK/CLI/API/MCP; builders own template content and design screenshots for `create-from-image`.\n\n---\n\n## 3. How rendering works\n\nMarkdown (+ optional frontmatter `title`) is poured into a template shell. HTML/PDF share the same layout; DOCX and PPTX map structure from headings and paragraphs.\n\nPPTX: each `#` (H1) starts a new landscape 16:9 slide.\n\n---\n\n## 4. Where to go next\n\n- **Getting Started** — see the product end-to-end once.\n- **Templates** — layout contract, slots, user store (`author-templates`).\n",
+    "downloads/books/00-overview/developers.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"1-what-it-is\",\n    \"title\": \"1. What it is\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"2-formats-and-surfaces\",\n    \"title\": \"2. Formats and surfaces\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"3-how-rendering-works\",\n    \"title\": \"3. How rendering works\",\n    \"level\": 2,\n    \"order\": 3\n  },\n  {\n    \"slug\": \"4-where-to-go-next\",\n    \"title\": \"4. Where to go next\",\n    \"level\": 2,\n    \"order\": 4\n  }\n]",
+    "downloads/books/00-overview/developers.md": "# Overview — Developers\n\n**Audience:** Engineers choosing how to consume Markdown Reports Studio.  \n**Twin:** [Builders version](../builders/BOOK.md)\n\n---\n\n## 1. What it is\n\nTurn Markdown into styled **PDF**, **Word (DOCX)**, **PowerPoint (PPTX)**, and **HTML** using swappable templates.\n\n**Not** a CMS or collaborative editor — a render pipeline: Markdown in, branded document out.\n\nOne engine powers every surface: SDK, CLI, HTTP API, MCP server, Playground UI, and Studio UI.\n\n---\n\n## 2. Formats and surfaces\n\n| Capability | Details |\n| --- | --- |\n| Formats | HTML, PDF (Playwright Chromium), DOCX, PPTX (landscape 16:9) |\n| Templates | Built-ins (`clean-report`, `letter`, `technical-doc`) + your own |\n| Frontmatter | YAML (e.g. `title`) fills template slots |\n| Surfaces | SDK, CLI (`mdreports`), HTTP API, MCP, Playground (`:6461`), Studio (`:6463`) |\n\nAll published packages are public under `@x12i/mdreports-*` on npm.\n\nPDF needs Chromium once per machine: `npx playwright install chromium`. Requires **Node.js 20.11+**.\n\n---\n\n## 3. How rendering works\n\n1. **Parse** Markdown (including YAML frontmatter).\n2. **Load template** by id — built-in or user template from disk.\n3. **Inject** CSS into `layout.html` and fill slots (`<!--CONTENT-->`, `<!--TITLE-->`, meta slots).\n4. **Emit** HTML string, PDF via pooled Chromium, DOCX/PPTX from the Markdown AST.\n\nAlways call `shutdown()` in SDK/long-lived processes so the browser exits cleanly.\n\n### Known limitations\n\n- **HTML/PDF images**: absolute `http(s)` URLs or data URIs only.\n- **DOCX / PPTX images**: local paths and URLs are best-effort; failures become `[image: alt]`.\n- **DOCX / PPTX code blocks**: monospace + shading — no syntax highlighting.\n- **PPTX overflow**: long content under a single H1 is not auto-split (may clip).\n- **Raw HTML in Markdown**: kept for HTML/PDF; dropped for DOCX and PPTX.\n\n---\n\n## 4. Where to go next\n\n| Goal | Book / use case |\n| --- | --- |\n| First successful file | Getting Started · `pick-a-surface` |\n| Which package to install | Packages · `map-packages` |\n| Custom look | Templates · `author-templates` |\n| Agent tools | MCP · `wire-mcp-agents` |\n",
+    "downloads/books/01-packages/developers.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"1-package-table\",\n    \"title\": \"1. Package table\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"2-dependency-shape\",\n    \"title\": \"2. Dependency shape\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"3-naming-note\",\n    \"title\": \"3. Naming note\",\n    \"level\": 2,\n    \"order\": 3\n  }\n]",
+    "downloads/books/01-packages/developers.md": "# Packages — Developers\n\n**Audience:** Engineers choosing which `@x12i/mdreports-*` package to install.\n\n---\n\n## 1. Package table\n\n| Package | When to install |\n| --- | --- |\n| `@x12i/mdreports-core` | In-process HTML/PDF/DOCX/PPTX + `TemplateStore` |\n| `@x12i/mdreports-cli` | Shell command `mdreports` |\n| `@x12i/mdreports-api` | Network service `mdreports-api` |\n| `@x12i/mdreports-api-client` | Typed `fetch` client for the HTTP API |\n| `@x12i/mdreports-mcp-server` | MCP tools over stdio |\n| `@x12i/mdreports-types` | Shared Zod schemas / TS types |\n| `@x12i/mdreports-templates` | Rarely — pulled in by core |\n\nNot published: `apps/playground`, `apps/studio` (run from this monorepo).\n\nKnowledge for agents/humans: `@x12i/mdreports-docs` (this library) — install as a **devDependency** only.\n\n---\n\n## 2. Dependency shape\n\n```\n@x12i/mdreports-types\n        ↑\n@x12i/mdreports-templates ──→ @x12i/mdreports-core ──→ CLI / API / MCP\n                                   ↓\n                         @x12i/mdreports-api-client  (HTTP → API)\n```\n\nCore formats: **HTML**, **PDF**, **DOCX**, and landscape **PPTX** (H1 = new slide).\n\n---\n\n## 3. Naming note\n\nShort names like `@x12i/core` / `@x12i/cli` are already used by another x12i project on npm, so this product publishes under `@x12i/mdreports-*`.\n",
+    "downloads/books/02-getting-started/builders.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"1-prerequisites\",\n    \"title\": \"1. Prerequisites\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"2-option-a-cli\",\n    \"title\": \"2. Option A — CLI\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"3-option-b-sdk\",\n    \"title\": \"3. Option B — SDK\",\n    \"level\": 2,\n    \"order\": 3\n  },\n  {\n    \"slug\": \"4-option-c-http-api\",\n    \"title\": \"4. Option C — HTTP API\",\n    \"level\": 2,\n    \"order\": 4\n  },\n  {\n    \"slug\": \"5-option-d-mcp\",\n    \"title\": \"5. Option D — MCP\",\n    \"level\": 2,\n    \"order\": 5\n  },\n  {\n    \"slug\": \"6-built-in-templates\",\n    \"title\": \"6. Built-in templates\",\n    \"level\": 2,\n    \"order\": 6\n  }\n]",
+    "downloads/books/02-getting-started/builders.md": "# Getting Started — Builders\n\n**Audience:** People trying Playground/Studio before writing code.  \n**Twin:** [Developers version](../developers/BOOK.md)\n\n---\n\n## 1. Prerequisites\n\nFrom this monorepo:\n\n```bash\npnpm install\npnpm playwright:install\npnpm build\npnpm dev\n```\n\n- Playground: **6461**\n- Studio: **6463**\n- API: **6460**\n\n---\n\n## 2. Option A — CLI\n\nAsk a developer to install `@x12i/mdreports-cli`, or use Playground export once `pnpm dev` is running.\n\n---\n\n## 3. Option B — SDK\n\nDevelopers embed `@x12i/mdreports-core`. Builders supply template HTML/CSS and sample Markdown.\n\n---\n\n## 4. Option C — HTTP API\n\nStudio and Playground talk to the local API. Optional `MDREPORTS_API_KEY` protects non-health routes.\n\n---\n\n## 5. Option D — MCP\n\nAgents can render and create templates when the MCP server is configured — useful for “turn this Markdown into a PDF” workflows.\n\n---\n\n## 6. Built-in templates\n\nStart with `clean-report`, then clone look-and-feel via Studio create-from-HTML or create-from-image (`ANTHROPIC_API_KEY` required for image drafts).\n",
+    "downloads/books/02-getting-started/developers.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"1-prerequisites\",\n    \"title\": \"1. Prerequisites\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"2-option-a-cli\",\n    \"title\": \"2. Option A — CLI\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"3-option-b-sdk\",\n    \"title\": \"3. Option B — SDK\",\n    \"level\": 2,\n    \"order\": 3\n  },\n  {\n    \"slug\": \"4-option-c-http-api\",\n    \"title\": \"4. Option C — HTTP API\",\n    \"level\": 2,\n    \"order\": 4\n  },\n  {\n    \"slug\": \"5-option-d-mcp\",\n    \"title\": \"5. Option D — MCP\",\n    \"level\": 2,\n    \"order\": 5\n  },\n  {\n    \"slug\": \"6-built-in-templates\",\n    \"title\": \"6. Built-in templates\",\n    \"level\": 2,\n    \"order\": 6\n  }\n]",
+    "downloads/books/02-getting-started/developers.md": "# Getting Started — Developers\n\n**Audience:** First-time integrators.  \n**Twin:** [Builders version](../builders/BOOK.md)\n\n---\n\n## 1. Prerequisites\n\n- Node.js **20.11+**\n- Chromium for PDF: `npx playwright install chromium`\n\n---\n\n## 2. Option A — CLI\n\n```bash\nnpm install -g @x12i/mdreports-cli\nnpx playwright install chromium\n\nmdreports templates list\nmdreports render --in report.md --template clean-report --format pdf --out report.pdf\nmdreports render --in report.md --template clean-report --format pptx --out report.pptx\n```\n\n---\n\n## 3. Option B — SDK\n\n```bash\nnpm install @x12i/mdreports-core\nnpx playwright install chromium\n```\n\n```ts\nimport { renderToPdf, renderToPptx, shutdown } from \"@x12i/mdreports-core\";\nimport { writeFile } from \"node:fs/promises\";\n\nconst pdf = await renderToPdf(\"# Hello\\n\\nWorld\", \"clean-report\");\nawait writeFile(\"report.pdf\", pdf);\n\nconst pptx = await renderToPptx(\"# Hello\\n\\nWorld\", \"clean-report\");\nawait writeFile(\"report.pptx\", pptx);\nawait shutdown();\n```\n\n---\n\n## 4. Option C — HTTP API\n\n```bash\nnpm install -g @x12i/mdreports-api\nnpx playwright install chromium\nmdreports-api   # http://localhost:6460\n```\n\n```ts\nimport { ApiClient } from \"@x12i/mdreports-api-client\";\n\nconst client = new ApiClient({ baseUrl: \"http://localhost:6460\" });\nconst pdf = await client.renderPdf(\"# Hello\", \"clean-report\");\n```\n\n---\n\n## 5. Option D — MCP\n\n```json\n{\n  \"mcpServers\": {\n    \"mdreports\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@x12i/mdreports-mcp-server\"]\n    }\n  }\n}\n```\n\n---\n\n## 6. Built-in templates\n\n- `clean-report` — multi-section reports\n- `letter` — short correspondence\n- `technical-doc` — technical documentation\n\nCreate your own with CLI `templates create-from-html` / `create-from-image`, the SDK, or Studio.\n",
+    "downloads/books/03-sdk/developers.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"1-install\",\n    \"title\": \"1. Install\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"2-render\",\n    \"title\": \"2. Render\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"3-template-store\",\n    \"title\": \"3. Template store\",\n    \"level\": 2,\n    \"order\": 3\n  },\n  {\n    \"slug\": \"4-ai-template-from-image\",\n    \"title\": \"4. AI template from image\",\n    \"level\": 2,\n    \"order\": 4\n  }\n]",
+    "downloads/books/03-sdk/developers.md": "# SDK — Developers\n\n**Audience:** Engineers embedding `@x12i/mdreports-core` in Node.js.\n\n---\n\n## 1. Install\n\n```bash\nnpm install @x12i/mdreports-core\nnpx playwright install chromium\n```\n\n---\n\n## 2. Render\n\n```ts\nimport { renderToHtml, renderToPdf, renderToDocx, renderToPptx, shutdown } from \"@x12i/mdreports-core\";\n\nconst md = `---\ntitle: Q1 Report\n---\n\n# Summary\n\nBody here.\n`;\n\nconst { html, title } = await renderToHtml(md, \"clean-report\");\nconst pdf = await renderToPdf(md, \"clean-report\", {\n  pdf: { format: \"Letter\", landscape: false }\n});\nconst docx = await renderToDocx(md, \"technical-doc\");\nconst pptx = await renderToPptx(md, \"clean-report\"); // landscape 16:9; each H1 = new slide\n\nawait shutdown();\n```\n\nAlways call `shutdown()` when your process is done (or on SIGTERM in long-lived servers) so Playwright exits cleanly.\n\n---\n\n## 3. Template store\n\n```ts\nimport { TemplateStore } from \"@x12i/mdreports-core\";\n\nconst store = new TemplateStore({\n  templatesDir: \"./my-templates\" // optional; else MDREPORTS_TEMPLATES_DIR or ~/.mdreports/templates\n});\n\nconst all = await store.list();\nconst one = await store.get(\"clean-report\");\n\nawait store.createFromHtml({\n  id: \"brand-report\",\n  name: \"Brand Report\",\n  layoutHtml: \"<!doctype html><html><head></head><body><main><!--CONTENT--></main></body></html>\",\n  stylesCss: \"main { max-width: 720px; margin: 0 auto; }\"\n});\n\nawait store.update(\"brand-report\", { name: \"Brand Report v2\" });\nawait store.delete(\"brand-report\");\n```\n\nBuilt-in templates cannot be updated or deleted.\n\n---\n\n## 4. AI template from image\n\n```ts\nimport { readFile } from \"node:fs/promises\";\nimport { createTemplateFromImage, shutdown } from \"@x12i/mdreports-core\";\n\nconst imageBuffer = await readFile(\"design.png\");\nawait createTemplateFromImage({\n  id: \"from-design\",\n  name: \"From Design\",\n  imageBuffer,\n  imageMediaType: \"image/png\",\n  anthropicApiKey: process.env.ANTHROPIC_API_KEY!\n});\nawait shutdown();\n```\n",
+    "downloads/books/04-cli/developers.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"1-install\",\n    \"title\": \"1. Install\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"2-render\",\n    \"title\": \"2. Render\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"3-templates\",\n    \"title\": \"3. Templates\",\n    \"level\": 2,\n    \"order\": 3\n  }\n]",
+    "downloads/books/04-cli/developers.md": "# CLI — Developers\n\n**Audience:** Engineers using the `mdreports` binary.\n\n---\n\n## 1. Install\n\n```bash\nnpm install -g @x12i/mdreports-cli\nnpx playwright install chromium\n```\n\nBinary name: `mdreports`.\n\n---\n\n## 2. Render\n\n```bash\nmdreports render --in report.md --template clean-report --format pdf --out report.pdf\nmdreports render --in report.md --template letter --format docx\nmdreports render --in report.md --template clean-report --format pptx\nmdreports render --in report.md --template technical-doc --format html\n```\n\n---\n\n## 3. Templates\n\n```bash\nmdreports templates list\nmdreports templates list --json\nmdreports templates show clean-report\nmdreports templates create-from-html --id my-layout --name \"My Layout\" \\\n  --layout layout.html --styles styles.css\nmdreports templates create-from-image --id from-shot --name \"From Shot\" \\\n  --image design.png\nmdreports templates delete my-layout\n```\n\n`--templates-dir` overrides the user templates directory on any command.\n",
+    "downloads/books/05-api/developers.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"1-run\",\n    \"title\": \"1. Run\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"2-call-with-curl\",\n    \"title\": \"2. Call with curl\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"3-typed-client\",\n    \"title\": \"3. Typed client\",\n    \"level\": 2,\n    \"order\": 3\n  },\n  {\n    \"slug\": \"4-route-summary\",\n    \"title\": \"4. Route summary\",\n    \"level\": 2,\n    \"order\": 4\n  }\n]",
+    "downloads/books/05-api/developers.md": "# HTTP API — Developers\n\n**Audience:** Engineers running or calling `@x12i/mdreports-api`.\n\n---\n\n## 1. Run\n\n```bash\nnpm install -g @x12i/mdreports-api\nnpx playwright install chromium\nmdreports-api\n```\n\nOptional env:\n\n| Variable | Purpose |\n| --- | --- |\n| `MDREPORTS_API_PORT` / `PORT` | Listen port (default **6460**) |\n| `MDREPORTS_API_KEY` | If set, require `Authorization: Bearer <key>` (except `/health`) |\n| `MDREPORTS_TEMPLATES_DIR` | User templates directory |\n\n---\n\n## 2. Call with curl\n\n```bash\ncurl -s http://localhost:6460/health\n\ncurl -s http://localhost:6460/templates | jq .\n\ncurl -s -X POST http://localhost:6460/render/html \\\n  -H 'content-type: application/json' \\\n  -d '{\"markdown\":\"# Hello\",\"templateId\":\"clean-report\"}' | jq .\n\ncurl -s -X POST http://localhost:6460/render/pdf \\\n  -H 'content-type: application/json' \\\n  -d '{\"markdown\":\"# Hello\",\"templateId\":\"clean-report\"}' \\\n  --output report.pdf\n\ncurl -s -X POST http://localhost:6460/render/pptx \\\n  -H 'content-type: application/json' \\\n  -d '{\"markdown\":\"# Hello\\n\\nSlide body\",\"templateId\":\"clean-report\"}' \\\n  --output report.pptx\n```\n\n---\n\n## 3. Typed client\n\n```bash\nnpm install @x12i/mdreports-api-client\n```\n\n```ts\nimport { ApiClient } from \"@x12i/mdreports-api-client\";\n\nconst client = new ApiClient({\n  baseUrl: \"http://localhost:6460\",\n  apiKey: process.env.MDREPORTS_API_KEY\n});\n\nconst pdf = await client.renderPdf(\"# Hello\", \"clean-report\");\nconst templates = await client.listTemplates();\n```\n\n---\n\n## 4. Route summary\n\n| Method | Path | Description |\n| --- | --- |\n| `GET` | `/health` | Liveness (no auth) |\n| `GET` | `/templates` | List templates |\n| `GET` | `/templates/:id` | Get template |\n| `POST` | `/templates/from-html` | Create from HTML + CSS |\n| `POST` | `/templates/from-image` | Create from image (multipart) |\n| `PATCH` | `/templates/:id` | Update user template |\n| `DELETE` | `/templates/:id` | Delete user template |\n| `POST` | `/render/html` | Markdown → HTML JSON |\n| `POST` | `/render/pdf` | Markdown → PDF bytes |\n| `POST` | `/render/docx` | Markdown → DOCX bytes |\n| `POST` | `/render/pptx` | Markdown → PPTX bytes |\n",
+    "downloads/books/06-mcp/developers.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"1-run-configure\",\n    \"title\": \"1. Run configure\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"2-tools\",\n    \"title\": \"2. Tools\",\n    \"level\": 2,\n    \"order\": 2\n  }\n]",
+    "downloads/books/06-mcp/developers.md": "# MCP — Developers\n\n**Audience:** Engineers wiring agents to Markdown Reports Studio.\n\n---\n\n## 1. Run configure\n\n```bash\nnpm install -g @x12i/mdreports-mcp-server\nnpx playwright install chromium\n```\n\nExample MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"mdreports\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@x12i/mdreports-mcp-server\"],\n      \"env\": {\n        \"ANTHROPIC_API_KEY\": \"optional\"\n      }\n    }\n  }\n}\n```\n\nOptional: `MDREPORTS_TEMPLATES_DIR` for the user template store.\n\n---\n\n## 2. Tools\n\n- `list_templates` / `get_template`\n- `render_markdown_to_html` (returns HTML inline)\n- `render_markdown_to_pdf` / `render_markdown_to_docx` / `render_markdown_to_pptx` (write a file; optional `outPath`)\n- `create_template_from_html` / `create_template_from_image` / `delete_template`\n\nPPTX is always landscape 16:9; each `#` heading starts a new slide.\n",
+    "downloads/books/07-templates/builders.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"1-built-ins\",\n    \"title\": \"1. Built-ins\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"2-layout-contract\",\n    \"title\": \"2. Layout contract\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"3-user-templates\",\n    \"title\": \"3. User templates\",\n    \"level\": 2,\n    \"order\": 3\n  },\n  {\n    \"slug\": \"4-images-in-markdown\",\n    \"title\": \"4. Images in Markdown\",\n    \"level\": 2,\n    \"order\": 4\n  },\n  {\n    \"slug\": \"5-pptx\",\n    \"title\": \"5. PPTX\",\n    \"level\": 2,\n    \"order\": 5\n  }\n]",
+    "downloads/books/07-templates/builders.md": "# Templates — Builders\n\n**Audience:** Authors designing layouts in Studio or from HTML/CSS.  \n**Twin:** [Developers version](../developers/BOOK.md)\n\n---\n\n## 1. Built-ins\n\nStart here before inventing a new layout:\n\n| Id | Best for |\n| --- | --- |\n| `clean-report` | Multi-section reports |\n| `letter` | Short correspondence |\n| `technical-doc` | Technical documentation |\n\n---\n\n## 2. Layout contract\n\nA template folder is three files:\n\n| File | Role |\n| --- | --- |\n| `template.json` | Id, name, page/theme/DOCX/PPTX styles, meta slots |\n| `layout.html` | Shell with `</head>` and `<!--CONTENT-->` |\n| `styles.css` | Look-and-feel injected into the shell |\n\nKeep slot names stable; renderers fill them from Markdown and frontmatter.\n\n---\n\n## 3. User templates\n\nYour custom templates live under `~/.mdreports/templates` (or a path your team sets). Built-ins are never overwritten.\n\nCreate from:\n\n- Studio UI (HTML or design screenshot)\n- CLI `create-from-html` / `create-from-image`\n- Asking an agent via MCP when configured\n\nScreenshot drafts need an Anthropic API key.\n\n---\n\n## 4. Images in Markdown\n\nPrefer absolute HTTPS image URLs in source Markdown so HTML and PDF previews stay reliable.\n\n---\n\n## 5. PPTX\n\nSlides are landscape 16:9. Structure decks with `#` headings — one H1 per slide. Put deck title in YAML frontmatter `title` for an opening title slide.\n",
+    "downloads/books/07-templates/developers.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"1-built-ins\",\n    \"title\": \"1. Built-ins\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"2-layout-contract\",\n    \"title\": \"2. Layout contract\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"3-user-templates\",\n    \"title\": \"3. User templates\",\n    \"level\": 2,\n    \"order\": 3\n  },\n  {\n    \"slug\": \"4-images-in-markdown\",\n    \"title\": \"4. Images in Markdown\",\n    \"level\": 2,\n    \"order\": 4\n  },\n  {\n    \"slug\": \"5-pptx\",\n    \"title\": \"5. PPTX\",\n    \"level\": 2,\n    \"order\": 5\n  }\n]",
+    "downloads/books/07-templates/developers.md": "# Templates — Developers\n\n**Audience:** Engineers integrating template stores and manifests.  \n**Twin:** [Builders version](../builders/BOOK.md)\n\n---\n\n## 1. Built-ins\n\nShipped in `@x12i/mdreports-templates` (read-only):\n\n| Id | Use |\n| --- | --- |\n| `clean-report` | General multi-section reports |\n| `letter` | Letters / short correspondence |\n| `technical-doc` | Technical documentation |\n\n---\n\n## 2. Layout contract\n\nEvery template directory needs:\n\n1. `template.json` — manifest (validated by `TemplateManifestSchema`)\n2. `layout.html` — must include `</head>` and slot tokens\n3. `styles.css` — injected before `</head>`\n\nCommon HTML slots:\n\n- `<!--CONTENT-->` — rendered Markdown body (required)\n- `<!--TITLE-->` — document title\n- additional `metaSlots` declared in the manifest\n\n---\n\n## 3. User templates\n\nWritable location (never overwrites built-ins):\n\n- default: `~/.mdreports/templates`\n- override: `MDREPORTS_TEMPLATES_DIR`, SDK `templatesDir`, or CLI `--templates-dir`\n\nCreate via CLI, SDK `TemplateStore#createFromHtml` / `createTemplateFromImage`, API, MCP, or Studio.\n\n`create-from-image` needs `ANTHROPIC_API_KEY`.\n\n---\n\n## 4. Images in Markdown\n\n- HTML/PDF: absolute `http(s)` URLs or data URIs\n- DOCX / PPTX: local paths and URLs are best-effort; failures become placeholders\n\n---\n\n## 5. PPTX\n\nEvery manifest includes a `pptx` block. Built-ins and new templates default to **landscape 16:9** (13.333″ × 7.5″).\n\n- Each `#` (H1) starts a new slide\n- Optional title slide when a document title is present (frontmatter / first heading)\n",
+    "downloads/use-cases/author-templates.md": "# Author and store templates\n\n> **Use case id:** `author-templates`\n> **Goal:** Understand the template directory contract, built-ins, user store, and PPTX rules.\n> **Audiences:** developers, builders\n> **Tags:** templates, studio\n\n## Reading path\n\n1. **Templates** (builders) → chapters: `1-built-ins`, `2-layout-contract`, `3-user-templates`, `4-images-in-markdown`, `5-pptx`\n\n## From: Templates — 1. Built-ins\n\nStart here before inventing a new layout:\n\n| Id | Best for |\n| --- | --- |\n| `clean-report` | Multi-section reports |\n| `letter` | Short correspondence |\n| `technical-doc` | Technical documentation |\n\n---\n\n## From: Templates — 2. Layout contract\n\nA template folder is three files:\n\n| File | Role |\n| --- | --- |\n| `template.json` | Id, name, page/theme/DOCX/PPTX styles, meta slots |\n| `layout.html` | Shell with `</head>` and `<!--CONTENT-->` |\n| `styles.css` | Look-and-feel injected into the shell |\n\nKeep slot names stable; renderers fill them from Markdown and frontmatter.\n\n---\n\n## From: Templates — 3. User templates\n\nYour custom templates live under `~/.mdreports/templates` (or a path your team sets). Built-ins are never overwritten.\n\nCreate from:\n\n- Studio UI (HTML or design screenshot)\n- CLI `create-from-html` / `create-from-image`\n- Asking an agent via MCP when configured\n\nScreenshot drafts need an Anthropic API key.\n\n---\n\n## From: Templates — 4. Images in Markdown\n\nPrefer absolute HTTPS image URLs in source Markdown so HTML and PDF previews stay reliable.\n\n---\n\n## From: Templates — 5. PPTX\n\nSlides are landscape 16:9. Structure decks with `#` headings — one H1 per slide. Put deck title in YAML frontmatter `title` for an opening title slide.\n\n## Also see\n\n- **Templates** (`07-templates`) — Template directory contract, built-ins, user store, and PPTX slide rules.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "downloads/use-cases/call-http-api.md": "# Run and call the HTTP API\n\n> **Use case id:** `call-http-api`\n> **Goal:** Start mdreports-api and render via curl or the typed client.\n> **Audiences:** developers\n> **Tags:** api, http\n\n## Reading path\n\n1. **HTTP API** (developers) → chapters: `1-run`, `2-call-with-curl`, `3-typed-client`, `4-route-summary`\n\n## From: HTTP API — 1. Run\n\n```bash\nnpm install -g @x12i/mdreports-api\nnpx playwright install chromium\nmdreports-api\n```\n\nOptional env:\n\n| Variable | Purpose |\n| --- | --- |\n| `MDREPORTS_API_PORT` / `PORT` | Listen port (default **6460**) |\n| `MDREPORTS_API_KEY` | If set, require `Authorization: Bearer <key>` (except `/health`) |\n| `MDREPORTS_TEMPLATES_DIR` | User templates directory |\n\n---\n\n## From: HTTP API — 2. Call with curl\n\n```bash\ncurl -s http://localhost:6460/health\n\ncurl -s http://localhost:6460/templates | jq .\n\ncurl -s -X POST http://localhost:6460/render/html \\\n  -H 'content-type: application/json' \\\n  -d '{\"markdown\":\"# Hello\",\"templateId\":\"clean-report\"}' | jq .\n\ncurl -s -X POST http://localhost:6460/render/pdf \\\n  -H 'content-type: application/json' \\\n  -d '{\"markdown\":\"# Hello\",\"templateId\":\"clean-report\"}' \\\n  --output report.pdf\n\ncurl -s -X POST http://localhost:6460/render/pptx \\\n  -H 'content-type: application/json' \\\n  -d '{\"markdown\":\"# Hello\\n\\nSlide body\",\"templateId\":\"clean-report\"}' \\\n  --output report.pptx\n```\n\n---\n\n## From: HTTP API — 3. Typed client\n\n```bash\nnpm install @x12i/mdreports-api-client\n```\n\n```ts\nimport { ApiClient } from \"@x12i/mdreports-api-client\";\n\nconst client = new ApiClient({\n  baseUrl: \"http://localhost:6460\",\n  apiKey: process.env.MDREPORTS_API_KEY\n});\n\nconst pdf = await client.renderPdf(\"# Hello\", \"clean-report\");\nconst templates = await client.listTemplates();\n```\n\n---\n\n## From: HTTP API — 4. Route summary\n\n| Method | Path | Description |\n| --- | --- |\n| `GET` | `/health` | Liveness (no auth) |\n| `GET` | `/templates` | List templates |\n| `GET` | `/templates/:id` | Get template |\n| `POST` | `/templates/from-html` | Create from HTML + CSS |\n| `POST` | `/templates/from-image` | Create from image (multipart) |\n| `PATCH` | `/templates/:id` | Update user template |\n| `DELETE` | `/templates/:id` | Delete user template |\n| `POST` | `/render/html` | Markdown → HTML JSON |\n| `POST` | `/render/pdf` | Markdown → PDF bytes |\n| `POST` | `/render/docx` | Markdown → DOCX bytes |\n| `POST` | `/render/pptx` | Markdown → PPTX bytes |\n\n## Also see\n\n- **HTTP API** (`05-api`) — Run mdreports-api and call it with curl or @x12i/mdreports-api-client.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "downloads/use-cases/map-packages.md": "# Map the @x12i/mdreports-* packages\n\n> **Use case id:** `map-packages`\n> **Goal:** Know which npm package owns core, CLI, API, client, MCP, types, and templates.\n> **Audiences:** developers\n> **Tags:** packages, npm\n\n## Reading path\n\n1. **Packages** (developers) → chapters: `1-package-table`, `2-dependency-shape`, `3-naming-note`\n\n## From: Packages — 1. Package table\n\n| Package | When to install |\n| --- | --- |\n| `@x12i/mdreports-core` | In-process HTML/PDF/DOCX/PPTX + `TemplateStore` |\n| `@x12i/mdreports-cli` | Shell command `mdreports` |\n| `@x12i/mdreports-api` | Network service `mdreports-api` |\n| `@x12i/mdreports-api-client` | Typed `fetch` client for the HTTP API |\n| `@x12i/mdreports-mcp-server` | MCP tools over stdio |\n| `@x12i/mdreports-types` | Shared Zod schemas / TS types |\n| `@x12i/mdreports-templates` | Rarely — pulled in by core |\n\nNot published: `apps/playground`, `apps/studio` (run from this monorepo).\n\nKnowledge for agents/humans: `@x12i/mdreports-docs` (this library) — install as a **devDependency** only.\n\n---\n\n## From: Packages — 2. Dependency shape\n\n```\n@x12i/mdreports-types\n        ↑\n@x12i/mdreports-templates ──→ @x12i/mdreports-core ──→ CLI / API / MCP\n                                   ↓\n                         @x12i/mdreports-api-client  (HTTP → API)\n```\n\nCore formats: **HTML**, **PDF**, **DOCX**, and landscape **PPTX** (H1 = new slide).\n\n---\n\n## From: Packages — 3. Naming note\n\nShort names like `@x12i/core` / `@x12i/cli` are already used by another x12i project on npm, so this product publishes under `@x12i/mdreports-*`.\n\n## Also see\n\n- **Packages** (`01-packages`) — Which npm package to install for SDK, CLI, API, client, MCP, types, and templates.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "downloads/use-cases/orient-mdreports.md": "# Orient on Markdown Reports Studio\n\n> **Use case id:** `orient-mdreports`\n> **Goal:** Understand formats, surfaces, and the one render pipeline before installing anything.\n> **Audiences:** developers, builders\n> **Tags:** platform, start-here\n\n## Reading path\n\n1. **Overview** (developers) → chapters: `1-what-it-is`, `2-formats-and-surfaces`, `3-how-rendering-works`, `4-where-to-go-next`\n\n## From: Overview — 1. What it is\n\nTurn Markdown into styled **PDF**, **Word (DOCX)**, **PowerPoint (PPTX)**, and **HTML** using swappable templates.\n\n**Not** a CMS or collaborative editor — a render pipeline: Markdown in, branded document out.\n\nOne engine powers every surface: SDK, CLI, HTTP API, MCP server, Playground UI, and Studio UI.\n\n---\n\n## From: Overview — 2. Formats and surfaces\n\n| Capability | Details |\n| --- | --- |\n| Formats | HTML, PDF (Playwright Chromium), DOCX, PPTX (landscape 16:9) |\n| Templates | Built-ins (`clean-report`, `letter`, `technical-doc`) + your own |\n| Frontmatter | YAML (e.g. `title`) fills template slots |\n| Surfaces | SDK, CLI (`mdreports`), HTTP API, MCP, Playground (`:6461`), Studio (`:6463`) |\n\nAll published packages are public under `@x12i/mdreports-*` on npm.\n\nPDF needs Chromium once per machine: `npx playwright install chromium`. Requires **Node.js 20.11+**.\n\n---\n\n## From: Overview — 3. How rendering works\n\n1. **Parse** Markdown (including YAML frontmatter).\n2. **Load template** by id — built-in or user template from disk.\n3. **Inject** CSS into `layout.html` and fill slots (`<!--CONTENT-->`, `<!--TITLE-->`, meta slots).\n4. **Emit** HTML string, PDF via pooled Chromium, DOCX/PPTX from the Markdown AST.\n\nAlways call `shutdown()` in SDK/long-lived processes so the browser exits cleanly.\n\n### Known limitations\n\n- **HTML/PDF images**: absolute `http(s)` URLs or data URIs only.\n- **DOCX / PPTX images**: local paths and URLs are best-effort; failures become `[image: alt]`.\n- **DOCX / PPTX code blocks**: monospace + shading — no syntax highlighting.\n- **PPTX overflow**: long content under a single H1 is not auto-split (may clip).\n- **Raw HTML in Markdown**: kept for HTML/PDF; dropped for DOCX and PPTX.\n\n---\n\n## From: Overview — 4. Where to go next\n\n| Goal | Book / use case |\n| --- | --- |\n| First successful file | Getting Started · `pick-a-surface` |\n| Which package to install | Packages · `map-packages` |\n| Custom look | Templates · `author-templates` |\n| Agent tools | MCP · `wire-mcp-agents` |\n\n## Also see\n\n- **Overview** (`00-overview`) — Surfaces, formats, and the render pipeline — where Markdown Reports Studio fits.\n- **Getting Started** (`02-getting-started`) — CLI, SDK, HTTP API, or MCP — first successful PDF/DOCX/PPTX in minutes.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "downloads/use-cases/pick-a-surface.md": "# Pick a surface and first render\n\n> **Use case id:** `pick-a-surface`\n> **Goal:** Choose CLI, SDK, API, or MCP and produce a first PDF/DOCX/PPTX.\n> **Audiences:** developers, builders\n> **Tags:** getting-started, quickstart\n\n## Reading path\n\n1. **Getting Started** (developers) → chapters: `1-prerequisites`, `2-option-a-cli`, `3-option-b-sdk`, `4-option-c-http-api`, `5-option-d-mcp`, `6-built-in-templates`\n\n## From: Getting Started — 1. Prerequisites\n\n- Node.js **20.11+**\n- Chromium for PDF: `npx playwright install chromium`\n\n---\n\n## From: Getting Started — 2. Option A — CLI\n\n```bash\nnpm install -g @x12i/mdreports-cli\nnpx playwright install chromium\n\nmdreports templates list\nmdreports render --in report.md --template clean-report --format pdf --out report.pdf\nmdreports render --in report.md --template clean-report --format pptx --out report.pptx\n```\n\n---\n\n## From: Getting Started — 3. Option B — SDK\n\n```bash\nnpm install @x12i/mdreports-core\nnpx playwright install chromium\n```\n\n```ts\nimport { renderToPdf, renderToPptx, shutdown } from \"@x12i/mdreports-core\";\nimport { writeFile } from \"node:fs/promises\";\n\nconst pdf = await renderToPdf(\"# Hello\\n\\nWorld\", \"clean-report\");\nawait writeFile(\"report.pdf\", pdf);\n\nconst pptx = await renderToPptx(\"# Hello\\n\\nWorld\", \"clean-report\");\nawait writeFile(\"report.pptx\", pptx);\nawait shutdown();\n```\n\n---\n\n## From: Getting Started — 4. Option C — HTTP API\n\n```bash\nnpm install -g @x12i/mdreports-api\nnpx playwright install chromium\nmdreports-api   # http://localhost:6460\n```\n\n```ts\nimport { ApiClient } from \"@x12i/mdreports-api-client\";\n\nconst client = new ApiClient({ baseUrl: \"http://localhost:6460\" });\nconst pdf = await client.renderPdf(\"# Hello\", \"clean-report\");\n```\n\n---\n\n## From: Getting Started — 5. Option D — MCP\n\n```json\n{\n  \"mcpServers\": {\n    \"mdreports\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@x12i/mdreports-mcp-server\"]\n    }\n  }\n}\n```\n\n---\n\n## From: Getting Started — 6. Built-in templates\n\n- `clean-report` — multi-section reports\n- `letter` — short correspondence\n- `technical-doc` — technical documentation\n\nCreate your own with CLI `templates create-from-html` / `create-from-image`, the SDK, or Studio.\n\n## Also see\n\n- **Packages** (`01-packages`) — Which npm package to install for SDK, CLI, API, client, MCP, types, and templates.\n- **Getting Started** (`02-getting-started`) — CLI, SDK, HTTP API, or MCP — first successful PDF/DOCX/PPTX in minutes.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "downloads/use-cases/render-with-cli.md": "# Render from the CLI\n\n> **Use case id:** `render-with-cli`\n> **Goal:** Use mdreports render and templates commands from the shell.\n> **Audiences:** developers\n> **Tags:** cli\n\n## Reading path\n\n1. **CLI** (developers) → chapters: `1-install`, `2-render`, `3-templates`\n\n## From: CLI — 1. Install\n\n```bash\nnpm install -g @x12i/mdreports-cli\nnpx playwright install chromium\n```\n\nBinary name: `mdreports`.\n\n---\n\n## From: CLI — 2. Render\n\n```bash\nmdreports render --in report.md --template clean-report --format pdf --out report.pdf\nmdreports render --in report.md --template letter --format docx\nmdreports render --in report.md --template clean-report --format pptx\nmdreports render --in report.md --template technical-doc --format html\n```\n\n---\n\n## From: CLI — 3. Templates\n\n```bash\nmdreports templates list\nmdreports templates list --json\nmdreports templates show clean-report\nmdreports templates create-from-html --id my-layout --name \"My Layout\" \\\n  --layout layout.html --styles styles.css\nmdreports templates create-from-image --id from-shot --name \"From Shot\" \\\n  --image design.png\nmdreports templates delete my-layout\n```\n\n`--templates-dir` overrides the user templates directory on any command.\n\n## Also see\n\n- **CLI** (`04-cli`) — Render from the shell and manage templates with create-from-html / create-from-image.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "downloads/use-cases/render-with-sdk.md": "# Render in-process with the SDK\n\n> **Use case id:** `render-with-sdk`\n> **Goal:** Call renderToHtml/Pdf/Docx/Pptx, shut down Chromium, and use TemplateStore.\n> **Audiences:** developers\n> **Tags:** sdk, core\n\n## Reading path\n\n1. **SDK** (developers) → chapters: `1-install`, `2-render`, `3-template-store`, `4-ai-template-from-image`\n\n## From: SDK — 1. Install\n\n```bash\nnpm install @x12i/mdreports-core\nnpx playwright install chromium\n```\n\n---\n\n## From: SDK — 2. Render\n\n```ts\nimport { renderToHtml, renderToPdf, renderToDocx, renderToPptx, shutdown } from \"@x12i/mdreports-core\";\n\nconst md = `---\ntitle: Q1 Report\n---\n\n# Summary\n\nBody here.\n`;\n\nconst { html, title } = await renderToHtml(md, \"clean-report\");\nconst pdf = await renderToPdf(md, \"clean-report\", {\n  pdf: { format: \"Letter\", landscape: false }\n});\nconst docx = await renderToDocx(md, \"technical-doc\");\nconst pptx = await renderToPptx(md, \"clean-report\"); // landscape 16:9; each H1 = new slide\n\nawait shutdown();\n```\n\nAlways call `shutdown()` when your process is done (or on SIGTERM in long-lived servers) so Playwright exits cleanly.\n\n---\n\n## From: SDK — 3. Template store\n\n```ts\nimport { TemplateStore } from \"@x12i/mdreports-core\";\n\nconst store = new TemplateStore({\n  templatesDir: \"./my-templates\" // optional; else MDREPORTS_TEMPLATES_DIR or ~/.mdreports/templates\n});\n\nconst all = await store.list();\nconst one = await store.get(\"clean-report\");\n\nawait store.createFromHtml({\n  id: \"brand-report\",\n  name: \"Brand Report\",\n  layoutHtml: \"<!doctype html><html><head></head><body><main><!--CONTENT--></main></body></html>\",\n  stylesCss: \"main { max-width: 720px; margin: 0 auto; }\"\n});\n\nawait store.update(\"brand-report\", { name: \"Brand Report v2\" });\nawait store.delete(\"brand-report\");\n```\n\nBuilt-in templates cannot be updated or deleted.\n\n---\n\n## From: SDK — 4. AI template from image\n\n```ts\nimport { readFile } from \"node:fs/promises\";\nimport { createTemplateFromImage, shutdown } from \"@x12i/mdreports-core\";\n\nconst imageBuffer = await readFile(\"design.png\");\nawait createTemplateFromImage({\n  id: \"from-design\",\n  name: \"From Design\",\n  imageBuffer,\n  imageMediaType: \"image/png\",\n  anthropicApiKey: process.env.ANTHROPIC_API_KEY!\n});\nawait shutdown();\n```\n\n## Also see\n\n- **SDK** (`03-sdk`) — In-process HTML/PDF/DOCX/PPTX render, TemplateStore, and create-from-image.\n- **Templates** (`07-templates`) — Template directory contract, built-ins, user store, and PPTX slide rules.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "downloads/use-cases/wire-mcp-agents.md": "# Wire MCP tools for agents\n\n> **Use case id:** `wire-mcp-agents`\n> **Goal:** Install the MCP server and expose render/template tools to Cursor or Claude.\n> **Audiences:** developers\n> **Tags:** mcp, agents\n\n## Reading path\n\n1. **MCP** (developers) → chapters: `1-run-configure`, `2-tools`\n\n## From: MCP — 1. Run configure\n\n```bash\nnpm install -g @x12i/mdreports-mcp-server\nnpx playwright install chromium\n```\n\nExample MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"mdreports\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@x12i/mdreports-mcp-server\"],\n      \"env\": {\n        \"ANTHROPIC_API_KEY\": \"optional\"\n      }\n    }\n  }\n}\n```\n\nOptional: `MDREPORTS_TEMPLATES_DIR` for the user template store.\n\n---\n\n## From: MCP — 2. Tools\n\n- `list_templates` / `get_template`\n- `render_markdown_to_html` (returns HTML inline)\n- `render_markdown_to_pdf` / `render_markdown_to_docx` / `render_markdown_to_pptx` (write a file; optional `outPath`)\n- `create_template_from_html` / `create_template_from_image` / `delete_template`\n\nPPTX is always landscape 16:9; each `#` heading starts a new slide.\n\n## Also see\n\n- **MCP** (`06-mcp`) — Wire @x12i/mdreports-mcp-server into Cursor or Claude for render and template tools.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "guides/pick-a-surface.md": "---\nid: \"pick-a-surface\"\ntype: \"guide\"\ntitle: \"Pick a surface\"\nsummary: \"Choose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render.\"\nwhy: \"The same engine backs every surface — install only what your workflow needs.\"\naudiences: [\"developers\", \"builders\"]\nprerequisites: [\"render-pipeline\"]\nconfirmationRequired: false\n---\n# Pick a surface\n\n# Pick a surface\n\n## Use this when\n\nYou know you want Markdown → PDF/DOCX/PPTX/HTML and need the smallest install path.\n\n## Do not use this when\n\nYou are designing template HTML/CSS only — open Studio after a local `pnpm dev` instead.\n\n## Steps\n\n1. **CLI** — `npm i -g @x12i/mdreports-cli` then `mdreports render --in report.md --template clean-report --format pdf`.\n2. **SDK** — `npm i @x12i/mdreports-core` and call `renderToPdf` / `renderToDocx` / `renderToPptx` / `renderToHtml`.\n3. **HTTP API** — `npm i -g @x12i/mdreports-api` → `mdreports-api` on port **6460**; optional `@x12i/mdreports-api-client`.\n4. **MCP** — wire `@x12i/mdreports-mcp-server` into your agent client.\n5. **Playground / Studio** — from this monorepo, `pnpm dev` (:6461 / :6463).\n\nAlways install Chromium once for PDF: `npx playwright install chromium`.\n\n## Verification\n\nYou have a non-empty PDF/DOCX/PPTX/HTML file from the same Markdown + `clean-report` template.\n\n## Recovery\n\nIf PDF fails, reinstall Chromium. If a template is missing, `mdreports templates list` and confirm built-ins or your `MDREPORTS_TEMPLATES_DIR`.",
+    "INDEX.md": "# mdreports — knowledge index\n\nPackage: `@x12i/mdreports-docs`\n\n## How to choose\n\n- **Concept** — what it is and why it exists\n- **Guide** — bounded task procedure\n- **Scenario** — state + evidence → which path\n- **Use case** — end-to-end outcome\n- **Tutorial** — learn by doing\n- **Decision** — options and recommended default\n- **Reference / API** — exact technical detail\n\n## Manifest and search\n\n- `agent-manifest.json`\n- `SEARCH.json`\n\n## Concepts\n\n- `render-pipeline` — **Render pipeline** — Markdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine. — [concepts/render-pipeline.md](concepts/render-pipeline.md)\n\n## Guides\n\n- `pick-a-surface` — **Pick a surface** — Choose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render. — [guides/pick-a-surface.md](guides/pick-a-surface.md)\n\n## Scenarios\n\n- `choose-integrate-or-ui` — **Choose integrate-or-UI path** — Decide whether to embed the engine in code or use the local UIs first. — [scenarios/choose-integrate-or-ui.md](scenarios/choose-integrate-or-ui.md)\n\n## Diagrams\n\n_None authored yet._\n\n## Tutorials\n\n_None authored yet._\n",
+    "indexes/books.json": "{\n  \"version\": 1,\n  \"items\": [\n    {\n      \"id\": \"00-overview\",\n      \"title\": \"Overview\",\n      \"summary\": \"Surfaces, formats, and the render pipeline — where Markdown Reports Studio fits.\",\n      \"path\": \"books/00-overview/\"\n    },\n    {\n      \"id\": \"01-packages\",\n      \"title\": \"Packages\",\n      \"summary\": \"Which npm package to install for SDK, CLI, API, client, MCP, types, and templates.\",\n      \"path\": \"books/01-packages/\"\n    },\n    {\n      \"id\": \"02-getting-started\",\n      \"title\": \"Getting Started\",\n      \"summary\": \"CLI, SDK, HTTP API, or MCP — first successful PDF/DOCX/PPTX in minutes.\",\n      \"path\": \"books/02-getting-started/\"\n    },\n    {\n      \"id\": \"03-sdk\",\n      \"title\": \"SDK\",\n      \"summary\": \"In-process HTML/PDF/DOCX/PPTX render, TemplateStore, and create-from-image.\",\n      \"path\": \"books/03-sdk/\"\n    },\n    {\n      \"id\": \"04-cli\",\n      \"title\": \"CLI\",\n      \"summary\": \"Render from the shell and manage templates with create-from-html / create-from-image.\",\n      \"path\": \"books/04-cli/\"\n    },\n    {\n      \"id\": \"05-api\",\n      \"title\": \"HTTP API\",\n      \"summary\": \"Run mdreports-api and call it with curl or @x12i/mdreports-api-client.\",\n      \"path\": \"books/05-api/\"\n    },\n    {\n      \"id\": \"06-mcp\",\n      \"title\": \"MCP\",\n      \"summary\": \"Wire @x12i/mdreports-mcp-server into Cursor or Claude for render and template tools.\",\n      \"path\": \"books/06-mcp/\"\n    },\n    {\n      \"id\": \"07-templates\",\n      \"title\": \"Templates\",\n      \"summary\": \"Template directory contract, built-ins, user store, and PPTX slide rules.\",\n      \"path\": \"books/07-templates/\"\n    }\n  ]\n}",
+    "indexes/books.md": "# books\n\n- `00-overview` — Overview — Surfaces, formats, and the render pipeline — where Markdown Reports Studio fits.\n- `01-packages` — Packages — Which npm package to install for SDK, CLI, API, client, MCP, types, and templates.\n- `02-getting-started` — Getting Started — CLI, SDK, HTTP API, or MCP — first successful PDF/DOCX/PPTX in minutes.\n- `03-sdk` — SDK — In-process HTML/PDF/DOCX/PPTX render, TemplateStore, and create-from-image.\n- `04-cli` — CLI — Render from the shell and manage templates with create-from-html / create-from-image.\n- `05-api` — HTTP API — Run mdreports-api and call it with curl or @x12i/mdreports-api-client.\n- `06-mcp` — MCP — Wire @x12i/mdreports-mcp-server into Cursor or Claude for render and template tools.\n- `07-templates` — Templates — Template directory contract, built-ins, user store, and PPTX slide rules.\n",
+    "indexes/concepts.json": "{\n  \"version\": 1,\n  \"items\": [\n    {\n      \"id\": \"render-pipeline\",\n      \"title\": \"Render pipeline\",\n      \"summary\": \"Markdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine.\",\n      \"path\": \"concepts/render-pipeline.md\"\n    }\n  ]\n}",
+    "indexes/concepts.md": "# concepts\n\n- `render-pipeline` — Render pipeline — Markdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine.\n",
+    "indexes/diagrams.json": "{\n  \"version\": 1,\n  \"items\": []\n}",
+    "indexes/diagrams.md": "# diagrams\n\n\n",
+    "indexes/guides.json": "{\n  \"version\": 1,\n  \"items\": [\n    {\n      \"id\": \"pick-a-surface\",\n      \"title\": \"Pick a surface\",\n      \"summary\": \"Choose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render.\",\n      \"path\": \"guides/pick-a-surface.md\"\n    }\n  ]\n}",
+    "indexes/guides.md": "# guides\n\n- `pick-a-surface` — Pick a surface — Choose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render.\n",
+    "indexes/scenarios.json": "{\n  \"version\": 1,\n  \"items\": [\n    {\n      \"id\": \"choose-integrate-or-ui\",\n      \"title\": \"Choose integrate-or-UI path\",\n      \"summary\": \"Decide whether to embed the engine in code or use the local UIs first.\",\n      \"path\": \"scenarios/choose-integrate-or-ui.md\"\n    }\n  ]\n}",
+    "indexes/scenarios.md": "# scenarios\n\n- `choose-integrate-or-ui` — Choose integrate-or-UI path — Decide whether to embed the engine in code or use the local UIs first.\n",
+    "indexes/tutorials.json": "{\n  \"version\": 1,\n  \"items\": []\n}",
+    "indexes/tutorials.md": "# tutorials\n\n\n",
+    "indexes/use-cases.json": "{\n  \"version\": 1,\n  \"items\": [\n    {\n      \"id\": \"orient-mdreports\",\n      \"title\": \"Orient on Markdown Reports Studio\",\n      \"summary\": \"Understand formats, surfaces, and the one render pipeline before installing anything.\",\n      \"path\": \"use-cases/orient-mdreports.md\"\n    },\n    {\n      \"id\": \"pick-a-surface\",\n      \"title\": \"Pick a surface and first render\",\n      \"summary\": \"Choose CLI, SDK, API, or MCP and produce a first PDF/DOCX/PPTX.\",\n      \"path\": \"use-cases/pick-a-surface.md\"\n    },\n    {\n      \"id\": \"map-packages\",\n      \"title\": \"Map the @x12i/mdreports-* packages\",\n      \"summary\": \"Know which npm package owns core, CLI, API, client, MCP, types, and templates.\",\n      \"path\": \"use-cases/map-packages.md\"\n    },\n    {\n      \"id\": \"render-with-sdk\",\n      \"title\": \"Render in-process with the SDK\",\n      \"summary\": \"Call renderToHtml/Pdf/Docx/Pptx, shut down Chromium, and use TemplateStore.\",\n      \"path\": \"use-cases/render-with-sdk.md\"\n    },\n    {\n      \"id\": \"render-with-cli\",\n      \"title\": \"Render from the CLI\",\n      \"summary\": \"Use mdreports render and templates commands from the shell.\",\n      \"path\": \"use-cases/render-with-cli.md\"\n    },\n    {\n      \"id\": \"call-http-api\",\n      \"title\": \"Run and call the HTTP API\",\n      \"summary\": \"Start mdreports-api and render via curl or the typed client.\",\n      \"path\": \"use-cases/call-http-api.md\"\n    },\n    {\n      \"id\": \"wire-mcp-agents\",\n      \"title\": \"Wire MCP tools for agents\",\n      \"summary\": \"Install the MCP server and expose render/template tools to Cursor or Claude.\",\n      \"path\": \"use-cases/wire-mcp-agents.md\"\n    },\n    {\n      \"id\": \"author-templates\",\n      \"title\": \"Author and store templates\",\n      \"summary\": \"Understand the template directory contract, built-ins, user store, and PPTX rules.\",\n      \"path\": \"use-cases/author-templates.md\"\n    }\n  ]\n}",
+    "indexes/use-cases.md": "# use-cases\n\n- `orient-mdreports` — Orient on Markdown Reports Studio — Understand formats, surfaces, and the one render pipeline before installing anything.\n- `pick-a-surface` — Pick a surface and first render — Choose CLI, SDK, API, or MCP and produce a first PDF/DOCX/PPTX.\n- `map-packages` — Map the @x12i/mdreports-* packages — Know which npm package owns core, CLI, API, client, MCP, types, and templates.\n- `render-with-sdk` — Render in-process with the SDK — Call renderToHtml/Pdf/Docx/Pptx, shut down Chromium, and use TemplateStore.\n- `render-with-cli` — Render from the CLI — Use mdreports render and templates commands from the shell.\n- `call-http-api` — Run and call the HTTP API — Start mdreports-api and render via curl or the typed client.\n- `wire-mcp-agents` — Wire MCP tools for agents — Install the MCP server and expose render/template tools to Cursor or Claude.\n- `author-templates` — Author and store templates — Understand the template directory contract, built-ins, user store, and PPTX rules.\n",
+    "knowledge.json": "{\n  \"concepts\": [\n    {\n      \"summary\": \"Markdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine.\",\n      \"problem\": \"Teams reimplement Markdown rendering per surface and drift on templates, slots, and export fidelity.\",\n      \"why\": \"One core (`@x12i/mdreports-core`) keeps CLI, API, MCP, Playground, and Studio on the same contract.\",\n      \"mentalModel\": \"Parse Markdown → load template → inject CSS/slots → emit the requested format.\",\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"whenItMatters\": [],\n      \"whenNotToUse\": [],\n      \"prerequisites\": [],\n      \"related\": [],\n      \"next\": [\n        \"pick-a-surface\"\n      ],\n      \"exampleIds\": [],\n      \"commonMistakes\": [],\n      \"successCriteria\": [],\n      \"invariants\": [],\n      \"alternatives\": [],\n      \"tags\": [],\n      \"id\": \"render-pipeline\",\n      \"type\": \"concept\",\n      \"title\": \"Render pipeline\",\n      \"visualIds\": [],\n      \"diagramIds\": [],\n      \"referenceIds\": []\n    }\n  ],\n  \"guides\": [\n    {\n      \"summary\": \"Choose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render.\",\n      \"why\": \"The same engine backs every surface — install only what your workflow needs.\",\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"whenItMatters\": [],\n      \"whenNotToUse\": [],\n      \"prerequisites\": [\n        \"render-pipeline\"\n      ],\n      \"related\": [],\n      \"next\": [],\n      \"exampleIds\": [],\n      \"commonMistakes\": [],\n      \"successCriteria\": [],\n      \"invariants\": [],\n      \"alternatives\": [],\n      \"confirmationRequired\": false,\n      \"tags\": [],\n      \"id\": \"pick-a-surface\",\n      \"type\": \"guide\",\n      \"title\": \"Pick a surface\",\n      \"useWhen\": [],\n      \"doNotUseWhen\": [],\n      \"inputs\": [],\n      \"permissions\": [],\n      \"steps\": [],\n      \"verification\": [],\n      \"recovery\": [],\n      \"tutorialIds\": [],\n      \"referenceIds\": [],\n      \"scenarioIds\": []\n    }\n  ],\n  \"scenarios\": [\n    {\n      \"summary\": \"Decide whether to embed the engine in code or use the local UIs first.\",\n      \"why\": \"Builders and developers share content but start from different entry points.\",\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"whenItMatters\": [],\n      \"whenNotToUse\": [],\n      \"prerequisites\": [\n        \"render-pipeline\"\n      ],\n      \"related\": [\n        \"pick-a-surface\"\n      ],\n      \"next\": [],\n      \"exampleIds\": [],\n      \"commonMistakes\": [],\n      \"successCriteria\": [],\n      \"invariants\": [],\n      \"alternatives\": [],\n      \"tags\": [],\n      \"id\": \"choose-integrate-or-ui\",\n      \"type\": \"scenario\",\n      \"title\": \"Choose integrate-or-UI path\",\n      \"situation\": \"You need branded documents from Markdown and are unsure whether to open Playground/Studio or install packages.\",\n      \"preconditions\": [],\n      \"signals\": [],\n      \"decisionQuestion\": \"Should you start in the local UIs or install a package surface?\",\n      \"paths\": [\n        {\n          \"id\": \"explore-ui\",\n          \"label\": \"Explore in Playground/Studio\",\n          \"when\": \"You prefer live preview over npm while iterating on Markdown or templates\",\n          \"guideIds\": [\n            \"pick-a-surface\"\n          ],\n          \"expectedOutcome\": \"Local preview on :6461 / :6463 via pnpm dev\"\n        },\n        {\n          \"id\": \"embed-core\",\n          \"label\": \"Embed the SDK\",\n          \"when\": \"You need in-process renders inside a Node service\",\n          \"guideIds\": [\n            \"pick-a-surface\"\n          ],\n          \"expectedOutcome\": \"`@x12i/mdreports-core` installed and rendering\"\n        },\n        {\n          \"id\": \"shell-cli\",\n          \"label\": \"Use the CLI\",\n          \"when\": \"You need one-off or CI shell jobs\",\n          \"guideIds\": [\n            \"pick-a-surface\"\n          ],\n          \"expectedOutcome\": \"mdreports render producing PDF/DOCX/PPTX/HTML\"\n        },\n        {\n          \"id\": \"agent-mcp\",\n          \"label\": \"Wire MCP for agents\",\n          \"when\": \"Agents must render or manage templates via tools\",\n          \"guideIds\": [\n            \"pick-a-surface\"\n          ],\n          \"expectedOutcome\": \"`@x12i/mdreports-mcp-server` configured in the agent client\"\n        }\n      ],\n      \"verification\": [],\n      \"recovery\": []\n    }\n  ],\n  \"decisions\": [],\n  \"glossary\": [],\n  \"visuals\": [],\n  \"diagrams\": [],\n  \"relationships\": [],\n  \"tutorials\": [],\n  \"examples\": [],\n  \"sampleData\": [],\n  \"uiClients\": [],\n  \"apis\": []\n}",
+    "packs/concept/render-pipeline/pack.json": "{\n  \"id\": \"concept/render-pipeline\",\n  \"type\": \"concept\",\n  \"title\": \"Render pipeline\",\n  \"summary\": \"Markdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine.\",\n  \"markdownPath\": \"concepts/render-pipeline.md\",\n  \"files\": [\n    \"concepts/render-pipeline.md\"\n  ],\n  \"related\": []\n}",
+    "packs/concept/render-pipeline/PACK.md": "---\nid: \"concept/render-pipeline\"\ntype: \"pack\"\ntitle: \"Render pipeline\"\nsummary: \"Markdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine.\"\n---\n# Pack: Render pipeline\n\nMarkdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine.\n\nPrimary markdown: `concepts/render-pipeline.md`\n",
+    "packs/guide/pick-a-surface/pack.json": "{\n  \"id\": \"guide/pick-a-surface\",\n  \"type\": \"guide\",\n  \"title\": \"Pick a surface\",\n  \"summary\": \"Choose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render.\",\n  \"markdownPath\": \"guides/pick-a-surface.md\",\n  \"files\": [\n    \"guides/pick-a-surface.md\"\n  ],\n  \"related\": []\n}",
+    "packs/guide/pick-a-surface/PACK.md": "---\nid: \"guide/pick-a-surface\"\ntype: \"pack\"\ntitle: \"Pick a surface\"\nsummary: \"Choose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render.\"\n---\n# Pack: Pick a surface\n\nChoose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render.\n\nPrimary markdown: `guides/pick-a-surface.md`\n",
+    "packs/scenario/choose-integrate-or-ui/pack.json": "{\n  \"id\": \"scenario/choose-integrate-or-ui\",\n  \"type\": \"scenario\",\n  \"title\": \"Choose integrate-or-UI path\",\n  \"summary\": \"Decide whether to embed the engine in code or use the local UIs first.\",\n  \"markdownPath\": \"scenarios/choose-integrate-or-ui.md\",\n  \"files\": [\n    \"scenarios/choose-integrate-or-ui.md\"\n  ],\n  \"related\": [\n    \"pick-a-surface\"\n  ]\n}",
+    "packs/scenario/choose-integrate-or-ui/PACK.md": "---\nid: \"scenario/choose-integrate-or-ui\"\ntype: \"pack\"\ntitle: \"Choose integrate-or-UI path\"\nsummary: \"Decide whether to embed the engine in code or use the local UIs first.\"\n---\n# Pack: Choose integrate-or-UI path\n\nDecide whether to embed the engine in code or use the local UIs first.\n\nPrimary markdown: `scenarios/choose-integrate-or-ui.md`\n",
+    "scenarios/choose-integrate-or-ui.md": "---\nid: \"choose-integrate-or-ui\"\ntype: \"scenario\"\ntitle: \"Choose integrate-or-UI path\"\nsummary: \"Decide whether to embed the engine in code or use the local UIs first.\"\naudiences: [\"developers\", \"builders\"]\n---\n# Choose integrate-or-UI path\n\n# Choose integrate-or-UI path\n\nStart with **Playground** only if you are iterating on Markdown/template look. Otherwise install the surface that matches how the document will be produced in production.\n\nFollow the Pick a surface guide for install commands.",
+    "SEARCH.json": "{\n  \"version\": 1,\n  \"product\": \"mdreports\",\n  \"generatedAt\": \"2026-07-26T12:49:20.367Z\",\n  \"records\": [\n    {\n      \"id\": \"render-pipeline\",\n      \"type\": \"concept\",\n      \"title\": \"Render pipeline\",\n      \"summary\": \"Markdown plus a template id becomes HTML, PDF, DOCX, or PPTX through one shared engine.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [],\n      \"goals\": [],\n      \"path\": \"concepts/render-pipeline.md\",\n      \"webPath\": \"/concepts/render-pipeline\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": [\n        \"concept/render-pipeline\"\n      ]\n    },\n    {\n      \"id\": \"pick-a-surface\",\n      \"type\": \"guide\",\n      \"title\": \"Pick a surface\",\n      \"summary\": \"Choose CLI, SDK, HTTP API, MCP, Playground, or Studio for your first successful render.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [],\n      \"goals\": [],\n      \"path\": \"guides/pick-a-surface.md\",\n      \"webPath\": \"/guides/pick-a-surface\",\n      \"prerequisites\": [\n        \"render-pipeline\"\n      ],\n      \"related\": [],\n      \"packIds\": [\n        \"guide/pick-a-surface\"\n      ]\n    },\n    {\n      \"id\": \"choose-integrate-or-ui\",\n      \"type\": \"scenario\",\n      \"title\": \"Choose integrate-or-UI path\",\n      \"summary\": \"Decide whether to embed the engine in code or use the local UIs first.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [],\n      \"goals\": [\n        \"Should you start in the local UIs or install a package surface?\"\n      ],\n      \"path\": \"scenarios/choose-integrate-or-ui.md\",\n      \"webPath\": \"/scenarios/choose-integrate-or-ui\",\n      \"prerequisites\": [\n        \"render-pipeline\"\n      ],\n      \"related\": [\n        \"pick-a-surface\"\n      ],\n      \"packIds\": [\n        \"scenario/choose-integrate-or-ui\"\n      ]\n    },\n    {\n      \"id\": \"orient-mdreports\",\n      \"type\": \"use-case\",\n      \"title\": \"Orient on Markdown Reports Studio\",\n      \"summary\": \"Understand formats, surfaces, and the one render pipeline before installing anything.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [\n        \"platform\",\n        \"start-here\"\n      ],\n      \"goals\": [\n        \"Understand formats, surfaces, and the one render pipeline before installing anything.\"\n      ],\n      \"path\": \"use-cases/orient-mdreports.md\",\n      \"webPath\": \"/use-cases#orient-mdreports\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"00-overview\",\n        \"02-getting-started\"\n      ],\n      \"packIds\": [\n        \"use-case/orient-mdreports\"\n      ]\n    },\n    {\n      \"id\": \"pick-a-surface\",\n      \"type\": \"use-case\",\n      \"title\": \"Pick a surface and first render\",\n      \"summary\": \"Choose CLI, SDK, API, or MCP and produce a first PDF/DOCX/PPTX.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [\n        \"getting-started\",\n        \"quickstart\"\n      ],\n      \"goals\": [\n        \"Choose CLI, SDK, API, or MCP and produce a first PDF/DOCX/PPTX.\"\n      ],\n      \"path\": \"use-cases/pick-a-surface.md\",\n      \"webPath\": \"/use-cases#pick-a-surface\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"01-packages\",\n        \"02-getting-started\"\n      ],\n      \"packIds\": [\n        \"use-case/pick-a-surface\"\n      ]\n    },\n    {\n      \"id\": \"map-packages\",\n      \"type\": \"use-case\",\n      \"title\": \"Map the @x12i/mdreports-* packages\",\n      \"summary\": \"Know which npm package owns core, CLI, API, client, MCP, types, and templates.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"packages\",\n        \"npm\"\n      ],\n      \"goals\": [\n        \"Know which npm package owns core, CLI, API, client, MCP, types, and templates.\"\n      ],\n      \"path\": \"use-cases/map-packages.md\",\n      \"webPath\": \"/use-cases#map-packages\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"01-packages\"\n      ],\n      \"packIds\": [\n        \"use-case/map-packages\"\n      ]\n    },\n    {\n      \"id\": \"render-with-sdk\",\n      \"type\": \"use-case\",\n      \"title\": \"Render in-process with the SDK\",\n      \"summary\": \"Call renderToHtml/Pdf/Docx/Pptx, shut down Chromium, and use TemplateStore.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"sdk\",\n        \"core\"\n      ],\n      \"goals\": [\n        \"Call renderToHtml/Pdf/Docx/Pptx, shut down Chromium, and use TemplateStore.\"\n      ],\n      \"path\": \"use-cases/render-with-sdk.md\",\n      \"webPath\": \"/use-cases#render-with-sdk\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"03-sdk\",\n        \"07-templates\"\n      ],\n      \"packIds\": [\n        \"use-case/render-with-sdk\"\n      ]\n    },\n    {\n      \"id\": \"render-with-cli\",\n      \"type\": \"use-case\",\n      \"title\": \"Render from the CLI\",\n      \"summary\": \"Use mdreports render and templates commands from the shell.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"cli\"\n      ],\n      \"goals\": [\n        \"Use mdreports render and templates commands from the shell.\"\n      ],\n      \"path\": \"use-cases/render-with-cli.md\",\n      \"webPath\": \"/use-cases#render-with-cli\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"04-cli\"\n      ],\n      \"packIds\": [\n        \"use-case/render-with-cli\"\n      ]\n    },\n    {\n      \"id\": \"call-http-api\",\n      \"type\": \"use-case\",\n      \"title\": \"Run and call the HTTP API\",\n      \"summary\": \"Start mdreports-api and render via curl or the typed client.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"api\",\n        \"http\"\n      ],\n      \"goals\": [\n        \"Start mdreports-api and render via curl or the typed client.\"\n      ],\n      \"path\": \"use-cases/call-http-api.md\",\n      \"webPath\": \"/use-cases#call-http-api\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"05-api\"\n      ],\n      \"packIds\": [\n        \"use-case/call-http-api\"\n      ]\n    },\n    {\n      \"id\": \"wire-mcp-agents\",\n      \"type\": \"use-case\",\n      \"title\": \"Wire MCP tools for agents\",\n      \"summary\": \"Install the MCP server and expose render/template tools to Cursor or Claude.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"mcp\",\n        \"agents\"\n      ],\n      \"goals\": [\n        \"Install the MCP server and expose render/template tools to Cursor or Claude.\"\n      ],\n      \"path\": \"use-cases/wire-mcp-agents.md\",\n      \"webPath\": \"/use-cases#wire-mcp-agents\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"06-mcp\"\n      ],\n      \"packIds\": [\n        \"use-case/wire-mcp-agents\"\n      ]\n    },\n    {\n      \"id\": \"author-templates\",\n      \"type\": \"use-case\",\n      \"title\": \"Author and store templates\",\n      \"summary\": \"Understand the template directory contract, built-ins, user store, and PPTX rules.\",\n      \"aliases\": [],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [\n        \"templates\",\n        \"studio\"\n      ],\n      \"goals\": [\n        \"Understand the template directory contract, built-ins, user store, and PPTX rules.\"\n      ],\n      \"path\": \"use-cases/author-templates.md\",\n      \"webPath\": \"/use-cases#author-templates\",\n      \"prerequisites\": [],\n      \"related\": [\n        \"07-templates\"\n      ],\n      \"packIds\": [\n        \"use-case/author-templates\"\n      ]\n    },\n    {\n      \"id\": \"00-overview\",\n      \"type\": \"book\",\n      \"title\": \"Overview\",\n      \"summary\": \"Surfaces, formats, and the render pipeline — where Markdown Reports Studio fits.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-00\"\n      ],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [\n        \"platform\",\n        \"start-here\",\n        \"overview\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/00-overview/\",\n      \"webPath\": \"/books/00-overview\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    },\n    {\n      \"id\": \"01-packages\",\n      \"type\": \"book\",\n      \"title\": \"Packages\",\n      \"summary\": \"Which npm package to install for SDK, CLI, API, client, MCP, types, and templates.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-01\"\n      ],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"packages\",\n        \"npm\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/01-packages/\",\n      \"webPath\": \"/books/01-packages\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    },\n    {\n      \"id\": \"02-getting-started\",\n      \"type\": \"book\",\n      \"title\": \"Getting Started\",\n      \"summary\": \"CLI, SDK, HTTP API, or MCP — first successful PDF/DOCX/PPTX in minutes.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-02\"\n      ],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [\n        \"getting-started\",\n        \"quickstart\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/02-getting-started/\",\n      \"webPath\": \"/books/02-getting-started\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    },\n    {\n      \"id\": \"03-sdk\",\n      \"type\": \"book\",\n      \"title\": \"SDK\",\n      \"summary\": \"In-process HTML/PDF/DOCX/PPTX render, TemplateStore, and create-from-image.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-03\"\n      ],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"sdk\",\n        \"node\",\n        \"core\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/03-sdk/\",\n      \"webPath\": \"/books/03-sdk\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    },\n    {\n      \"id\": \"04-cli\",\n      \"type\": \"book\",\n      \"title\": \"CLI\",\n      \"summary\": \"Render from the shell and manage templates with create-from-html / create-from-image.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-04\"\n      ],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"cli\",\n        \"shell\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/04-cli/\",\n      \"webPath\": \"/books/04-cli\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    },\n    {\n      \"id\": \"05-api\",\n      \"type\": \"book\",\n      \"title\": \"HTTP API\",\n      \"summary\": \"Run mdreports-api and call it with curl or @x12i/mdreports-api-client.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-05\"\n      ],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"api\",\n        \"http\",\n        \"client\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/05-api/\",\n      \"webPath\": \"/books/05-api\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    },\n    {\n      \"id\": \"06-mcp\",\n      \"type\": \"book\",\n      \"title\": \"MCP\",\n      \"summary\": \"Wire @x12i/mdreports-mcp-server into Cursor or Claude for render and template tools.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-06\"\n      ],\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"mcp\",\n        \"agents\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/06-mcp/\",\n      \"webPath\": \"/books/06-mcp\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    },\n    {\n      \"id\": \"07-templates\",\n      \"type\": \"book\",\n      \"title\": \"Templates\",\n      \"summary\": \"Template directory contract, built-ins, user store, and PPTX slide rules.\",\n      \"aliases\": [\n        \"CASE FILE · MDR-07\"\n      ],\n      \"audiences\": [\n        \"developers\",\n        \"builders\"\n      ],\n      \"tags\": [\n        \"templates\",\n        \"html\",\n        \"css\"\n      ],\n      \"goals\": [],\n      \"path\": \"books/07-templates/\",\n      \"webPath\": \"/books/07-templates\",\n      \"prerequisites\": [],\n      \"related\": [],\n      \"packIds\": []\n    }\n  ]\n}",
+    "use-cases/author-templates.md": "# Author and store templates\n\n> **Use case id:** `author-templates`\n> **Goal:** Understand the template directory contract, built-ins, user store, and PPTX rules.\n> **Audiences:** developers, builders\n> **Tags:** templates, studio\n\n## Reading path\n\n1. **Templates** (builders) → chapters: `1-built-ins`, `2-layout-contract`, `3-user-templates`, `4-images-in-markdown`, `5-pptx`\n\n## From: Templates — 1. Built-ins\n\nStart here before inventing a new layout:\n\n| Id | Best for |\n| --- | --- |\n| `clean-report` | Multi-section reports |\n| `letter` | Short correspondence |\n| `technical-doc` | Technical documentation |\n\n---\n\n## From: Templates — 2. Layout contract\n\nA template folder is three files:\n\n| File | Role |\n| --- | --- |\n| `template.json` | Id, name, page/theme/DOCX/PPTX styles, meta slots |\n| `layout.html` | Shell with `</head>` and `<!--CONTENT-->` |\n| `styles.css` | Look-and-feel injected into the shell |\n\nKeep slot names stable; renderers fill them from Markdown and frontmatter.\n\n---\n\n## From: Templates — 3. User templates\n\nYour custom templates live under `~/.mdreports/templates` (or a path your team sets). Built-ins are never overwritten.\n\nCreate from:\n\n- Studio UI (HTML or design screenshot)\n- CLI `create-from-html` / `create-from-image`\n- Asking an agent via MCP when configured\n\nScreenshot drafts need an Anthropic API key.\n\n---\n\n## From: Templates — 4. Images in Markdown\n\nPrefer absolute HTTPS image URLs in source Markdown so HTML and PDF previews stay reliable.\n\n---\n\n## From: Templates — 5. PPTX\n\nSlides are landscape 16:9. Structure decks with `#` headings — one H1 per slide. Put deck title in YAML frontmatter `title` for an opening title slide.\n\n## Also see\n\n- **Templates** (`07-templates`) — Template directory contract, built-ins, user store, and PPTX slide rules.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "use-cases/call-http-api.md": "# Run and call the HTTP API\n\n> **Use case id:** `call-http-api`\n> **Goal:** Start mdreports-api and render via curl or the typed client.\n> **Audiences:** developers\n> **Tags:** api, http\n\n## Reading path\n\n1. **HTTP API** (developers) → chapters: `1-run`, `2-call-with-curl`, `3-typed-client`, `4-route-summary`\n\n## From: HTTP API — 1. Run\n\n```bash\nnpm install -g @x12i/mdreports-api\nnpx playwright install chromium\nmdreports-api\n```\n\nOptional env:\n\n| Variable | Purpose |\n| --- | --- |\n| `MDREPORTS_API_PORT` / `PORT` | Listen port (default **6460**) |\n| `MDREPORTS_API_KEY` | If set, require `Authorization: Bearer <key>` (except `/health`) |\n| `MDREPORTS_TEMPLATES_DIR` | User templates directory |\n\n---\n\n## From: HTTP API — 2. Call with curl\n\n```bash\ncurl -s http://localhost:6460/health\n\ncurl -s http://localhost:6460/templates | jq .\n\ncurl -s -X POST http://localhost:6460/render/html \\\n  -H 'content-type: application/json' \\\n  -d '{\"markdown\":\"# Hello\",\"templateId\":\"clean-report\"}' | jq .\n\ncurl -s -X POST http://localhost:6460/render/pdf \\\n  -H 'content-type: application/json' \\\n  -d '{\"markdown\":\"# Hello\",\"templateId\":\"clean-report\"}' \\\n  --output report.pdf\n\ncurl -s -X POST http://localhost:6460/render/pptx \\\n  -H 'content-type: application/json' \\\n  -d '{\"markdown\":\"# Hello\\n\\nSlide body\",\"templateId\":\"clean-report\"}' \\\n  --output report.pptx\n```\n\n---\n\n## From: HTTP API — 3. Typed client\n\n```bash\nnpm install @x12i/mdreports-api-client\n```\n\n```ts\nimport { ApiClient } from \"@x12i/mdreports-api-client\";\n\nconst client = new ApiClient({\n  baseUrl: \"http://localhost:6460\",\n  apiKey: process.env.MDREPORTS_API_KEY\n});\n\nconst pdf = await client.renderPdf(\"# Hello\", \"clean-report\");\nconst templates = await client.listTemplates();\n```\n\n---\n\n## From: HTTP API — 4. Route summary\n\n| Method | Path | Description |\n| --- | --- |\n| `GET` | `/health` | Liveness (no auth) |\n| `GET` | `/templates` | List templates |\n| `GET` | `/templates/:id` | Get template |\n| `POST` | `/templates/from-html` | Create from HTML + CSS |\n| `POST` | `/templates/from-image` | Create from image (multipart) |\n| `PATCH` | `/templates/:id` | Update user template |\n| `DELETE` | `/templates/:id` | Delete user template |\n| `POST` | `/render/html` | Markdown → HTML JSON |\n| `POST` | `/render/pdf` | Markdown → PDF bytes |\n| `POST` | `/render/docx` | Markdown → DOCX bytes |\n| `POST` | `/render/pptx` | Markdown → PPTX bytes |\n\n## Also see\n\n- **HTTP API** (`05-api`) — Run mdreports-api and call it with curl or @x12i/mdreports-api-client.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "use-cases/map-packages.md": "# Map the @x12i/mdreports-* packages\n\n> **Use case id:** `map-packages`\n> **Goal:** Know which npm package owns core, CLI, API, client, MCP, types, and templates.\n> **Audiences:** developers\n> **Tags:** packages, npm\n\n## Reading path\n\n1. **Packages** (developers) → chapters: `1-package-table`, `2-dependency-shape`, `3-naming-note`\n\n## From: Packages — 1. Package table\n\n| Package | When to install |\n| --- | --- |\n| `@x12i/mdreports-core` | In-process HTML/PDF/DOCX/PPTX + `TemplateStore` |\n| `@x12i/mdreports-cli` | Shell command `mdreports` |\n| `@x12i/mdreports-api` | Network service `mdreports-api` |\n| `@x12i/mdreports-api-client` | Typed `fetch` client for the HTTP API |\n| `@x12i/mdreports-mcp-server` | MCP tools over stdio |\n| `@x12i/mdreports-types` | Shared Zod schemas / TS types |\n| `@x12i/mdreports-templates` | Rarely — pulled in by core |\n\nNot published: `apps/playground`, `apps/studio` (run from this monorepo).\n\nKnowledge for agents/humans: `@x12i/mdreports-docs` (this library) — install as a **devDependency** only.\n\n---\n\n## From: Packages — 2. Dependency shape\n\n```\n@x12i/mdreports-types\n        ↑\n@x12i/mdreports-templates ──→ @x12i/mdreports-core ──→ CLI / API / MCP\n                                   ↓\n                         @x12i/mdreports-api-client  (HTTP → API)\n```\n\nCore formats: **HTML**, **PDF**, **DOCX**, and landscape **PPTX** (H1 = new slide).\n\n---\n\n## From: Packages — 3. Naming note\n\nShort names like `@x12i/core` / `@x12i/cli` are already used by another x12i project on npm, so this product publishes under `@x12i/mdreports-*`.\n\n## Also see\n\n- **Packages** (`01-packages`) — Which npm package to install for SDK, CLI, API, client, MCP, types, and templates.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "use-cases/orient-mdreports.md": "# Orient on Markdown Reports Studio\n\n> **Use case id:** `orient-mdreports`\n> **Goal:** Understand formats, surfaces, and the one render pipeline before installing anything.\n> **Audiences:** developers, builders\n> **Tags:** platform, start-here\n\n## Reading path\n\n1. **Overview** (developers) → chapters: `1-what-it-is`, `2-formats-and-surfaces`, `3-how-rendering-works`, `4-where-to-go-next`\n\n## From: Overview — 1. What it is\n\nTurn Markdown into styled **PDF**, **Word (DOCX)**, **PowerPoint (PPTX)**, and **HTML** using swappable templates.\n\n**Not** a CMS or collaborative editor — a render pipeline: Markdown in, branded document out.\n\nOne engine powers every surface: SDK, CLI, HTTP API, MCP server, Playground UI, and Studio UI.\n\n---\n\n## From: Overview — 2. Formats and surfaces\n\n| Capability | Details |\n| --- | --- |\n| Formats | HTML, PDF (Playwright Chromium), DOCX, PPTX (landscape 16:9) |\n| Templates | Built-ins (`clean-report`, `letter`, `technical-doc`) + your own |\n| Frontmatter | YAML (e.g. `title`) fills template slots |\n| Surfaces | SDK, CLI (`mdreports`), HTTP API, MCP, Playground (`:6461`), Studio (`:6463`) |\n\nAll published packages are public under `@x12i/mdreports-*` on npm.\n\nPDF needs Chromium once per machine: `npx playwright install chromium`. Requires **Node.js 20.11+**.\n\n---\n\n## From: Overview — 3. How rendering works\n\n1. **Parse** Markdown (including YAML frontmatter).\n2. **Load template** by id — built-in or user template from disk.\n3. **Inject** CSS into `layout.html` and fill slots (`<!--CONTENT-->`, `<!--TITLE-->`, meta slots).\n4. **Emit** HTML string, PDF via pooled Chromium, DOCX/PPTX from the Markdown AST.\n\nAlways call `shutdown()` in SDK/long-lived processes so the browser exits cleanly.\n\n### Known limitations\n\n- **HTML/PDF images**: absolute `http(s)` URLs or data URIs only.\n- **DOCX / PPTX images**: local paths and URLs are best-effort; failures become `[image: alt]`.\n- **DOCX / PPTX code blocks**: monospace + shading — no syntax highlighting.\n- **PPTX overflow**: long content under a single H1 is not auto-split (may clip).\n- **Raw HTML in Markdown**: kept for HTML/PDF; dropped for DOCX and PPTX.\n\n---\n\n## From: Overview — 4. Where to go next\n\n| Goal | Book / use case |\n| --- | --- |\n| First successful file | Getting Started · `pick-a-surface` |\n| Which package to install | Packages · `map-packages` |\n| Custom look | Templates · `author-templates` |\n| Agent tools | MCP · `wire-mcp-agents` |\n\n## Also see\n\n- **Overview** (`00-overview`) — Surfaces, formats, and the render pipeline — where Markdown Reports Studio fits.\n- **Getting Started** (`02-getting-started`) — CLI, SDK, HTTP API, or MCP — first successful PDF/DOCX/PPTX in minutes.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "use-cases/pick-a-surface.md": "# Pick a surface and first render\n\n> **Use case id:** `pick-a-surface`\n> **Goal:** Choose CLI, SDK, API, or MCP and produce a first PDF/DOCX/PPTX.\n> **Audiences:** developers, builders\n> **Tags:** getting-started, quickstart\n\n## Reading path\n\n1. **Getting Started** (developers) → chapters: `1-prerequisites`, `2-option-a-cli`, `3-option-b-sdk`, `4-option-c-http-api`, `5-option-d-mcp`, `6-built-in-templates`\n\n## From: Getting Started — 1. Prerequisites\n\n- Node.js **20.11+**\n- Chromium for PDF: `npx playwright install chromium`\n\n---\n\n## From: Getting Started — 2. Option A — CLI\n\n```bash\nnpm install -g @x12i/mdreports-cli\nnpx playwright install chromium\n\nmdreports templates list\nmdreports render --in report.md --template clean-report --format pdf --out report.pdf\nmdreports render --in report.md --template clean-report --format pptx --out report.pptx\n```\n\n---\n\n## From: Getting Started — 3. Option B — SDK\n\n```bash\nnpm install @x12i/mdreports-core\nnpx playwright install chromium\n```\n\n```ts\nimport { renderToPdf, renderToPptx, shutdown } from \"@x12i/mdreports-core\";\nimport { writeFile } from \"node:fs/promises\";\n\nconst pdf = await renderToPdf(\"# Hello\\n\\nWorld\", \"clean-report\");\nawait writeFile(\"report.pdf\", pdf);\n\nconst pptx = await renderToPptx(\"# Hello\\n\\nWorld\", \"clean-report\");\nawait writeFile(\"report.pptx\", pptx);\nawait shutdown();\n```\n\n---\n\n## From: Getting Started — 4. Option C — HTTP API\n\n```bash\nnpm install -g @x12i/mdreports-api\nnpx playwright install chromium\nmdreports-api   # http://localhost:6460\n```\n\n```ts\nimport { ApiClient } from \"@x12i/mdreports-api-client\";\n\nconst client = new ApiClient({ baseUrl: \"http://localhost:6460\" });\nconst pdf = await client.renderPdf(\"# Hello\", \"clean-report\");\n```\n\n---\n\n## From: Getting Started — 5. Option D — MCP\n\n```json\n{\n  \"mcpServers\": {\n    \"mdreports\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@x12i/mdreports-mcp-server\"]\n    }\n  }\n}\n```\n\n---\n\n## From: Getting Started — 6. Built-in templates\n\n- `clean-report` — multi-section reports\n- `letter` — short correspondence\n- `technical-doc` — technical documentation\n\nCreate your own with CLI `templates create-from-html` / `create-from-image`, the SDK, or Studio.\n\n## Also see\n\n- **Packages** (`01-packages`) — Which npm package to install for SDK, CLI, API, client, MCP, types, and templates.\n- **Getting Started** (`02-getting-started`) — CLI, SDK, HTTP API, or MCP — first successful PDF/DOCX/PPTX in minutes.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "use-cases/render-with-cli.md": "# Render from the CLI\n\n> **Use case id:** `render-with-cli`\n> **Goal:** Use mdreports render and templates commands from the shell.\n> **Audiences:** developers\n> **Tags:** cli\n\n## Reading path\n\n1. **CLI** (developers) → chapters: `1-install`, `2-render`, `3-templates`\n\n## From: CLI — 1. Install\n\n```bash\nnpm install -g @x12i/mdreports-cli\nnpx playwright install chromium\n```\n\nBinary name: `mdreports`.\n\n---\n\n## From: CLI — 2. Render\n\n```bash\nmdreports render --in report.md --template clean-report --format pdf --out report.pdf\nmdreports render --in report.md --template letter --format docx\nmdreports render --in report.md --template clean-report --format pptx\nmdreports render --in report.md --template technical-doc --format html\n```\n\n---\n\n## From: CLI — 3. Templates\n\n```bash\nmdreports templates list\nmdreports templates list --json\nmdreports templates show clean-report\nmdreports templates create-from-html --id my-layout --name \"My Layout\" \\\n  --layout layout.html --styles styles.css\nmdreports templates create-from-image --id from-shot --name \"From Shot\" \\\n  --image design.png\nmdreports templates delete my-layout\n```\n\n`--templates-dir` overrides the user templates directory on any command.\n\n## Also see\n\n- **CLI** (`04-cli`) — Render from the shell and manage templates with create-from-html / create-from-image.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "use-cases/render-with-sdk.md": "# Render in-process with the SDK\n\n> **Use case id:** `render-with-sdk`\n> **Goal:** Call renderToHtml/Pdf/Docx/Pptx, shut down Chromium, and use TemplateStore.\n> **Audiences:** developers\n> **Tags:** sdk, core\n\n## Reading path\n\n1. **SDK** (developers) → chapters: `1-install`, `2-render`, `3-template-store`, `4-ai-template-from-image`\n\n## From: SDK — 1. Install\n\n```bash\nnpm install @x12i/mdreports-core\nnpx playwright install chromium\n```\n\n---\n\n## From: SDK — 2. Render\n\n```ts\nimport { renderToHtml, renderToPdf, renderToDocx, renderToPptx, shutdown } from \"@x12i/mdreports-core\";\n\nconst md = `---\ntitle: Q1 Report\n---\n\n# Summary\n\nBody here.\n`;\n\nconst { html, title } = await renderToHtml(md, \"clean-report\");\nconst pdf = await renderToPdf(md, \"clean-report\", {\n  pdf: { format: \"Letter\", landscape: false }\n});\nconst docx = await renderToDocx(md, \"technical-doc\");\nconst pptx = await renderToPptx(md, \"clean-report\"); // landscape 16:9; each H1 = new slide\n\nawait shutdown();\n```\n\nAlways call `shutdown()` when your process is done (or on SIGTERM in long-lived servers) so Playwright exits cleanly.\n\n---\n\n## From: SDK — 3. Template store\n\n```ts\nimport { TemplateStore } from \"@x12i/mdreports-core\";\n\nconst store = new TemplateStore({\n  templatesDir: \"./my-templates\" // optional; else MDREPORTS_TEMPLATES_DIR or ~/.mdreports/templates\n});\n\nconst all = await store.list();\nconst one = await store.get(\"clean-report\");\n\nawait store.createFromHtml({\n  id: \"brand-report\",\n  name: \"Brand Report\",\n  layoutHtml: \"<!doctype html><html><head></head><body><main><!--CONTENT--></main></body></html>\",\n  stylesCss: \"main { max-width: 720px; margin: 0 auto; }\"\n});\n\nawait store.update(\"brand-report\", { name: \"Brand Report v2\" });\nawait store.delete(\"brand-report\");\n```\n\nBuilt-in templates cannot be updated or deleted.\n\n---\n\n## From: SDK — 4. AI template from image\n\n```ts\nimport { readFile } from \"node:fs/promises\";\nimport { createTemplateFromImage, shutdown } from \"@x12i/mdreports-core\";\n\nconst imageBuffer = await readFile(\"design.png\");\nawait createTemplateFromImage({\n  id: \"from-design\",\n  name: \"From Design\",\n  imageBuffer,\n  imageMediaType: \"image/png\",\n  anthropicApiKey: process.env.ANTHROPIC_API_KEY!\n});\nawait shutdown();\n```\n\n## Also see\n\n- **SDK** (`03-sdk`) — In-process HTML/PDF/DOCX/PPTX render, TemplateStore, and create-from-image.\n- **Templates** (`07-templates`) — Template directory contract, built-ins, user store, and PPTX slide rules.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "use-cases/wire-mcp-agents.md": "# Wire MCP tools for agents\n\n> **Use case id:** `wire-mcp-agents`\n> **Goal:** Install the MCP server and expose render/template tools to Cursor or Claude.\n> **Audiences:** developers\n> **Tags:** mcp, agents\n\n## Reading path\n\n1. **MCP** (developers) → chapters: `1-run-configure`, `2-tools`\n\n## From: MCP — 1. Run configure\n\n```bash\nnpm install -g @x12i/mdreports-mcp-server\nnpx playwright install chromium\n```\n\nExample MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"mdreports\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@x12i/mdreports-mcp-server\"],\n      \"env\": {\n        \"ANTHROPIC_API_KEY\": \"optional\"\n      }\n    }\n  }\n}\n```\n\nOptional: `MDREPORTS_TEMPLATES_DIR` for the user template store.\n\n---\n\n## From: MCP — 2. Tools\n\n- `list_templates` / `get_template`\n- `render_markdown_to_html` (returns HTML inline)\n- `render_markdown_to_pdf` / `render_markdown_to_docx` / `render_markdown_to_pptx` (write a file; optional `outPath`)\n- `create_template_from_html` / `create_template_from_image` / `delete_template`\n\nPPTX is always landscape 16:9; each `#` heading starts a new slide.\n\n## Also see\n\n- **MCP** (`06-mcp`) — Wire @x12i/mdreports-mcp-server into Cursor or Claude for render and template tools.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n"
+};
+//# sourceMappingURL=bundle.js.map