@x12i/api-simulator-docs 0.1.1

package/README.md

@@ -0,0 +1,33 @@
+# @x12i/api-simulator-docs
+
+api-simulator ebook **knowledge SDK**. Install as a **devDependency only** — do not add to production service dependencies.
+
+```bash
+npm i -D @x12i/api-simulator-docs
+```
+
+```ts
+import { apiSimulatorDocs } from "@x12i/api-simulator-docs";
+
+apiSimulatorDocs.getUseCaseMarkdown("orient-simulator");
+apiSimulatorDocs.getBookMarkdown("01-behaviors", "developers");
+apiSimulatorDocs.manifest();
+```
+
+CLI:
+
+```bash
+npx api-simulator-docs list-use-cases
+npx api-simulator-docs use-case orient-simulator > pack.md
+npx api-simulator-docs book 00-overview developers > book.md
+```
+
+Human UI: from the api-simulator monorepo, run `npm run docs` (`docify-web` + content bundle).
+
+Publishable static site:
+
+```bash
+npm run docs:web   # → dist/docs-web/
+```
+
+Deploy the contents of `dist/docs-web/` to your docs host root (see root `site.json` `siteUrl`).

package/bin/api-simulator-docs.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../dist/cli.js";

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { apiSimulatorDocs } from "./index.js";
+const [cmd, id, audience] = process.argv.slice(2);
+function usage() {
+    console.error(`Usage:
+  api-simulator-docs use-case <id>          Print assembled use-case markdown
+  api-simulator-docs book <id> <audience>   Print book markdown
+  api-simulator-docs list-use-cases         List use case ids
+  api-simulator-docs list-books             List book ids
+`);
+}
+if (!cmd || cmd === "help" || cmd === "--help") {
+    usage();
+    process.exit(cmd ? 0 : 1);
+}
+if (cmd === "list-use-cases") {
+    for (const uc of apiSimulatorDocs.listUseCases()) {
+        console.log(`${uc.id}\t${uc.title}`);
+    }
+    process.exit(0);
+}
+if (cmd === "list-books") {
+    for (const b of apiSimulatorDocs.listBooks()) {
+        console.log(`${b.id}\t${b.title}\t${b.audiences.join(",")}`);
+    }
+    process.exit(0);
+}
+if (cmd === "use-case") {
+    if (!id) {
+        usage();
+        process.exit(1);
+    }
+    const md = apiSimulatorDocs.getUseCaseMarkdown(id);
+    if (!md) {
+        console.error(`Unknown use case: ${id}`);
+        process.exit(1);
+    }
+    process.stdout.write(md);
+    process.exit(0);
+}
+if (cmd === "book") {
+    if (!id || !audience) {
+        usage();
+        process.exit(1);
+    }
+    const md = apiSimulatorDocs.getBookMarkdown(id, audience);
+    if (!md) {
+        console.error(`Unknown book/audience: ${id} ${audience}`);
+        process.exit(1);
+    }
+    process.stdout.write(md);
+    process.exit(0);
+}
+usage();
+process.exit(1);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,CAAC,GAAG,EAAE,EAAE,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAElD,SAAS,KAAK;IACZ,OAAO,CAAC,KAAK,CAAC;;;;;CAKf,CAAC,CAAC;AACH,CAAC;AAED,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;IAC/C,KAAK,EAAE,CAAC;IACR,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;IAC7B,KAAK,MAAM,EAAE,IAAI,gBAAgB,CAAC,YAAY,EAAE,EAAE,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,gBAAgB,CAAC,SAAS,EAAE,EAAE,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,EAAE,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,EAAE,GAAG,gBAAgB,CAAC,eAAe,CACzC,EAAE,EACF,QAAqC,CACtC,CAAC;IACF,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,IAAI,QAAQ,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,KAAK,EAAE,CAAC;AACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/generated/bundle.d.ts

@@ -0,0 +1,8 @@
+/** Auto-generated by scripts/build-docs-knowledge.mjs — do not edit. */
+import type { AgentManifest, Catalog, SiteConfig, UseCasesFile } from "@x12i/docify-core";
+export declare const catalog: Catalog;
+export declare const useCases: UseCasesFile;
+export declare const site: SiteConfig;
+export declare const manifest: AgentManifest;
+export declare const files: Record<string, string>;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/generated/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/generated/bundle.ts"],"names":[],"mappings":"AACA,wEAAwE;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAE1F,eAAO,MAAM,OAAO,EAmHf,OAAO,CAAC;AAEb,eAAO,MAAM,QAAQ,EA2LhB,YAAY,CAAC;AAElB,eAAO,MAAM,IAAI,EA8CZ,UAAU,CAAC;AAEhB,eAAO,MAAM,QAAQ,EA0MhB,aAAa,CAAC;AAEnB,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAqBxC,CAAC"}

package/dist/generated/bundle.js

@@ -0,0 +1,577 @@
+export const catalog = {
+    "roles": [
+        {
+            "id": "developers",
+            "label": "Developers",
+            "tagline": "Build and ship simulators",
+            "description": "Engineers who define SimulatorDefinition endpoints, wire Node/HTTP adapters, and publish package simulators."
+        }
+    ],
+    "families": [
+        {
+            "id": "api-simulator",
+            "name": "api-simulator",
+            "tagline": "Transport-agnostic API simulation — fixed, relative, and function behaviors.",
+            "description": "Core library, adapters, package-simulator patterns, and Playground/Studio apps.",
+            "color": "#16324f"
+        }
+    ],
+    "books": [
+        {
+            "id": "00-overview",
+            "familyId": "api-simulator",
+            "audiences": [
+                "developers"
+            ],
+            "status": "available",
+            "kicker": "CASE FILE · SIM-00",
+            "title": "Overview",
+            "subtitle": "What api-simulator is",
+            "blurb": "Install, a minimal three-behavior example, and where to go next.",
+            "tags": [
+                "start-here",
+                "overview",
+                "install"
+            ],
+            "color": "#16324f",
+            "dir": "00-overview"
+        },
+        {
+            "id": "01-behaviors",
+            "familyId": "api-simulator",
+            "audiences": [
+                "developers"
+            ],
+            "status": "available",
+            "kicker": "CASE FILE · SIM-01",
+            "title": "Behaviors and Dispatch",
+            "subtitle": "Fixed, relative, simulation",
+            "blurb": "The three endpoint behaviors, dispatch APIs, contracts, latency, raw bodies, and path patterns.",
+            "tags": [
+                "behaviors",
+                "dispatch",
+                "templates"
+            ],
+            "color": "#1f6e5c",
+            "dir": "01-behaviors"
+        },
+        {
+            "id": "02-adapters",
+            "familyId": "api-simulator",
+            "audiences": [
+                "developers"
+            ],
+            "status": "available",
+            "kicker": "CASE FILE · SIM-02",
+            "title": "Adapters and Helpers",
+            "subtitle": "Node, store, OpenAPI, fetch",
+            "blurb": "Expose simulators over HTTP, compose helpers, and plug into Express, Fastify, or fetch runtimes.",
+            "tags": [
+                "node",
+                "adapters",
+                "helpers"
+            ],
+            "color": "#a5710f",
+            "dir": "02-adapters"
+        },
+        {
+            "id": "03-package-simulators",
+            "familyId": "api-simulator",
+            "audiences": [
+                "developers"
+            ],
+            "status": "available",
+            "kicker": "CASE FILE · SIM-03",
+            "title": "Package Simulators",
+            "subtitle": "Product-owned packages",
+            "blurb": "Ship logic, data, and optional Memorix fixtures in a product package — with or without static-memorix.",
+            "tags": [
+                "packages",
+                "memorix",
+                "examples"
+            ],
+            "color": "#8b3a3a",
+            "dir": "03-package-simulators"
+        },
+        {
+            "id": "04-playground-studio",
+            "familyId": "api-simulator",
+            "audiences": [
+                "developers"
+            ],
+            "status": "available",
+            "kicker": "CASE FILE · SIM-04",
+            "title": "Playground and Studio",
+            "subtitle": "Try and author locally",
+            "blurb": "Two UI apps over the same library: ephemeral Playground and local-first Studio.",
+            "tags": [
+                "ui",
+                "playground",
+                "studio"
+            ],
+            "color": "#4a3f6b",
+            "dir": "04-playground-studio"
+        }
+    ]
+};
+export const useCases = {
+    "useCases": [
+        {
+            "id": "orient-simulator",
+            "title": "Orient on api-simulator",
+            "goal": "Understand what the library does, install it, and run a minimal three-behavior example.",
+            "audiences": [
+                "developers"
+            ],
+            "tags": [
+                "start-here",
+                "overview"
+            ],
+            "path": [
+                {
+                    "bookId": "00-overview",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-what-it-is",
+                        "2-install",
+                        "3-minimal-example",
+                        "4-where-to-go-next"
+                    ]
+                }
+            ],
+            "alsoSee": [
+                "00-overview",
+                "01-behaviors"
+            ]
+        },
+        {
+            "id": "define-three-behaviors",
+            "title": "Define the three endpoint behaviors",
+            "goal": "Author fixed, relative, and simulation endpoints and dispatch them from tests or adapters.",
+            "audiences": [
+                "developers"
+            ],
+            "tags": [
+                "behaviors",
+                "dispatch"
+            ],
+            "path": [
+                {
+                    "bookId": "01-behaviors",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-fixed",
+                        "2-relative",
+                        "3-simulation-function",
+                        "4-dispatch",
+                        "5-endpoint-contract"
+                    ]
+                }
+            ],
+            "alsoSee": [
+                "01-behaviors",
+                "02-adapters"
+            ]
+        },
+        {
+            "id": "expose-node-service",
+            "title": "Expose a Node.js HTTP service",
+            "goal": "Wrap a simulator with the Node HTTP adapter, and for processes that bind a port use @x12i/core-service (/health, /_live).",
+            "audiences": [
+                "developers"
+            ],
+            "tags": [
+                "node",
+                "http",
+                "adapters",
+                "core-service"
+            ],
+            "path": [
+                {
+                    "bookId": "02-adapters",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-node-http-adapter",
+                        "2-http-process-compliance-local-services",
+                        "3-multiple-apis",
+                        "7-express-and-fastify"
+                    ]
+                }
+            ],
+            "alsoSee": [
+                "02-adapters"
+            ]
+        },
+        {
+            "id": "ship-package-simulator",
+            "title": "Ship a package simulator",
+            "goal": "Structure a product-owned package with logic, data, optional static-memorix composition, and core-service on the HTTP entry.",
+            "audiences": [
+                "developers"
+            ],
+            "tags": [
+                "packages",
+                "memorix",
+                "core-service"
+            ],
+            "path": [
+                {
+                    "bookId": "03-package-simulators",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-what-a-package-simulator-is",
+                        "2-recommended-structure",
+                        "4-with-static-memorix"
+                    ]
+                },
+                {
+                    "bookId": "02-adapters",
+                    "audience": "developers",
+                    "chapters": [
+                        "2-http-process-compliance-local-services"
+                    ]
+                }
+            ],
+            "alsoSee": [
+                "03-package-simulators",
+                "02-adapters"
+            ]
+        },
+        {
+            "id": "run-playground-studio",
+            "title": "Run Playground and Studio",
+            "goal": "Start the local UI apps, know the port map, and understand the product rule.",
+            "audiences": [
+                "developers"
+            ],
+            "tags": [
+                "ui",
+                "playground",
+                "studio"
+            ],
+            "path": [
+                {
+                    "bookId": "04-playground-studio",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-two-surfaces",
+                        "2-run-locally",
+                        "3-ports",
+                        "4-product-rule"
+                    ]
+                }
+            ],
+            "alsoSee": [
+                "04-playground-studio"
+            ]
+        },
+        {
+            "id": "library-demo-rest",
+            "title": "Build a plain REST package simulator",
+            "goal": "Follow the library-demo path: data modules, relative/simulation endpoints, no Memorix.",
+            "audiences": [
+                "developers"
+            ],
+            "tags": [
+                "examples",
+                "rest",
+                "tutorial"
+            ],
+            "path": [
+                {
+                    "bookId": "03-package-simulators",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-what-a-package-simulator-is",
+                        "3-plain-rest-library-demo"
+                    ]
+                },
+                {
+                    "bookId": "01-behaviors",
+                    "audience": "developers",
+                    "chapters": [
+                        "2-relative",
+                        "3-simulation-function"
+                    ]
+                }
+            ],
+            "alsoSee": [
+                "03-package-simulators",
+                "01-behaviors"
+            ]
+        }
+    ]
+};
+export const site = {
+    "product": "api-simulator",
+    "brand": "x12i · api-simulator",
+    "brandAccent": "api-simulator",
+    "siteUrl": "https://docs.api-simulator.x12i.com",
+    "knowledgePackage": "@x12i/api-simulator-docs",
+    "footer": "api-simulator",
+    "accent": "oklch(45% 0.12 230)",
+    "accentAlt": "oklch(55% 0.12 50)",
+    "productUrl": "https://github.com/x12i/api-simulator",
+    "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"
+        }
+    ]
+};
+export const manifest = {
+    "version": 1,
+    "product": "api-simulator",
+    "site": "https://docs.api-simulator.x12i.com",
+    "knowledgePackage": "@x12i/api-simulator-docs",
+    "roles": [
+        "developers"
+    ],
+    "books": [
+        {
+            "id": "00-overview",
+            "audiences": [
+                "developers"
+            ],
+            "md": {
+                "developers": "downloads/books/00-overview/developers.md"
+            },
+            "pdf": {
+                "developers": null
+            },
+            "chapters": {
+                "developers": "downloads/books/00-overview/developers.chapters.json"
+            }
+        },
+        {
+            "id": "01-behaviors",
+            "audiences": [
+                "developers"
+            ],
+            "md": {
+                "developers": "downloads/books/01-behaviors/developers.md"
+            },
+            "pdf": {
+                "developers": null
+            },
+            "chapters": {
+                "developers": "downloads/books/01-behaviors/developers.chapters.json"
+            }
+        },
+        {
+            "id": "02-adapters",
+            "audiences": [
+                "developers"
+            ],
+            "md": {
+                "developers": "downloads/books/02-adapters/developers.md"
+            },
+            "pdf": {
+                "developers": null
+            },
+            "chapters": {
+                "developers": "downloads/books/02-adapters/developers.chapters.json"
+            }
+        },
+        {
+            "id": "03-package-simulators",
+            "audiences": [
+                "developers"
+            ],
+            "md": {
+                "developers": "downloads/books/03-package-simulators/developers.md"
+            },
+            "pdf": {
+                "developers": null
+            },
+            "chapters": {
+                "developers": "downloads/books/03-package-simulators/developers.chapters.json"
+            }
+        },
+        {
+            "id": "04-playground-studio",
+            "audiences": [
+                "developers"
+            ],
+            "md": {
+                "developers": "downloads/books/04-playground-studio/developers.md"
+            },
+            "pdf": {
+                "developers": null
+            },
+            "chapters": {
+                "developers": "downloads/books/04-playground-studio/developers.chapters.json"
+            }
+        }
+    ],
+    "useCases": [
+        {
+            "id": "orient-simulator",
+            "title": "Orient on api-simulator",
+            "md": "downloads/use-cases/orient-simulator.md",
+            "path": [
+                {
+                    "bookId": "00-overview",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-what-it-is",
+                        "2-install",
+                        "3-minimal-example",
+                        "4-where-to-go-next"
+                    ]
+                }
+            ]
+        },
+        {
+            "id": "define-three-behaviors",
+            "title": "Define the three endpoint behaviors",
+            "md": "downloads/use-cases/define-three-behaviors.md",
+            "path": [
+                {
+                    "bookId": "01-behaviors",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-fixed",
+                        "2-relative",
+                        "3-simulation-function",
+                        "4-dispatch",
+                        "5-endpoint-contract"
+                    ]
+                }
+            ]
+        },
+        {
+            "id": "expose-node-service",
+            "title": "Expose a Node.js HTTP service",
+            "md": "downloads/use-cases/expose-node-service.md",
+            "path": [
+                {
+                    "bookId": "02-adapters",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-node-http-adapter",
+                        "2-http-process-compliance-local-services",
+                        "3-multiple-apis",
+                        "7-express-and-fastify"
+                    ]
+                }
+            ]
+        },
+        {
+            "id": "ship-package-simulator",
+            "title": "Ship a package simulator",
+            "md": "downloads/use-cases/ship-package-simulator.md",
+            "path": [
+                {
+                    "bookId": "03-package-simulators",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-what-a-package-simulator-is",
+                        "2-recommended-structure",
+                        "4-with-static-memorix"
+                    ]
+                },
+                {
+                    "bookId": "02-adapters",
+                    "audience": "developers",
+                    "chapters": [
+                        "2-http-process-compliance-local-services"
+                    ]
+                }
+            ]
+        },
+        {
+            "id": "run-playground-studio",
+            "title": "Run Playground and Studio",
+            "md": "downloads/use-cases/run-playground-studio.md",
+            "path": [
+                {
+                    "bookId": "04-playground-studio",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-two-surfaces",
+                        "2-run-locally",
+                        "3-ports",
+                        "4-product-rule"
+                    ]
+                }
+            ]
+        },
+        {
+            "id": "library-demo-rest",
+            "title": "Build a plain REST package simulator",
+            "md": "downloads/use-cases/library-demo-rest.md",
+            "path": [
+                {
+                    "bookId": "03-package-simulators",
+                    "audience": "developers",
+                    "chapters": [
+                        "1-what-a-package-simulator-is",
+                        "3-plain-rest-library-demo"
+                    ]
+                },
+                {
+                    "bookId": "01-behaviors",
+                    "audience": "developers",
+                    "chapters": [
+                        "2-relative",
+                        "3-simulation-function"
+                    ]
+                }
+            ]
+        }
+    ]
+};
+export const files = {
+    "catalog.json": "{\n  \"roles\": [\n    {\n      \"id\": \"developers\",\n      \"label\": \"Developers\",\n      \"tagline\": \"Build and ship simulators\",\n      \"description\": \"Engineers who define SimulatorDefinition endpoints, wire Node/HTTP adapters, and publish package simulators.\"\n    }\n  ],\n  \"families\": [\n    {\n      \"id\": \"api-simulator\",\n      \"name\": \"api-simulator\",\n      \"tagline\": \"Transport-agnostic API simulation — fixed, relative, and function behaviors.\",\n      \"description\": \"Core library, adapters, package-simulator patterns, and Playground/Studio apps.\",\n      \"color\": \"#16324f\"\n    }\n  ],\n  \"books\": [\n    {\n      \"id\": \"00-overview\",\n      \"familyId\": \"api-simulator\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"status\": \"available\",\n      \"kicker\": \"CASE FILE · SIM-00\",\n      \"title\": \"Overview\",\n      \"subtitle\": \"What api-simulator is\",\n      \"blurb\": \"Install, a minimal three-behavior example, and where to go next.\",\n      \"tags\": [\n        \"start-here\",\n        \"overview\",\n        \"install\"\n      ],\n      \"color\": \"#16324f\",\n      \"dir\": \"00-overview\"\n    },\n    {\n      \"id\": \"01-behaviors\",\n      \"familyId\": \"api-simulator\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"status\": \"available\",\n      \"kicker\": \"CASE FILE · SIM-01\",\n      \"title\": \"Behaviors and Dispatch\",\n      \"subtitle\": \"Fixed, relative, simulation\",\n      \"blurb\": \"The three endpoint behaviors, dispatch APIs, contracts, latency, raw bodies, and path patterns.\",\n      \"tags\": [\n        \"behaviors\",\n        \"dispatch\",\n        \"templates\"\n      ],\n      \"color\": \"#1f6e5c\",\n      \"dir\": \"01-behaviors\"\n    },\n    {\n      \"id\": \"02-adapters\",\n      \"familyId\": \"api-simulator\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"status\": \"available\",\n      \"kicker\": \"CASE FILE · SIM-02\",\n      \"title\": \"Adapters and Helpers\",\n      \"subtitle\": \"Node, store, OpenAPI, fetch\",\n      \"blurb\": \"Expose simulators over HTTP, compose helpers, and plug into Express, Fastify, or fetch runtimes.\",\n      \"tags\": [\n        \"node\",\n        \"adapters\",\n        \"helpers\"\n      ],\n      \"color\": \"#a5710f\",\n      \"dir\": \"02-adapters\"\n    },\n    {\n      \"id\": \"03-package-simulators\",\n      \"familyId\": \"api-simulator\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"status\": \"available\",\n      \"kicker\": \"CASE FILE · SIM-03\",\n      \"title\": \"Package Simulators\",\n      \"subtitle\": \"Product-owned packages\",\n      \"blurb\": \"Ship logic, data, and optional Memorix fixtures in a product package — with or without static-memorix.\",\n      \"tags\": [\n        \"packages\",\n        \"memorix\",\n        \"examples\"\n      ],\n      \"color\": \"#8b3a3a\",\n      \"dir\": \"03-package-simulators\"\n    },\n    {\n      \"id\": \"04-playground-studio\",\n      \"familyId\": \"api-simulator\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"status\": \"available\",\n      \"kicker\": \"CASE FILE · SIM-04\",\n      \"title\": \"Playground and Studio\",\n      \"subtitle\": \"Try and author locally\",\n      \"blurb\": \"Two UI apps over the same library: ephemeral Playground and local-first Studio.\",\n      \"tags\": [\n        \"ui\",\n        \"playground\",\n        \"studio\"\n      ],\n      \"color\": \"#4a3f6b\",\n      \"dir\": \"04-playground-studio\"\n    }\n  ]\n}",
+    "use-cases.json": "{\n  \"useCases\": [\n    {\n      \"id\": \"orient-simulator\",\n      \"title\": \"Orient on api-simulator\",\n      \"goal\": \"Understand what the library does, install it, and run a minimal three-behavior example.\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"start-here\",\n        \"overview\"\n      ],\n      \"path\": [\n        {\n          \"bookId\": \"00-overview\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-what-it-is\",\n            \"2-install\",\n            \"3-minimal-example\",\n            \"4-where-to-go-next\"\n          ]\n        }\n      ],\n      \"alsoSee\": [\n        \"00-overview\",\n        \"01-behaviors\"\n      ]\n    },\n    {\n      \"id\": \"define-three-behaviors\",\n      \"title\": \"Define the three endpoint behaviors\",\n      \"goal\": \"Author fixed, relative, and simulation endpoints and dispatch them from tests or adapters.\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"behaviors\",\n        \"dispatch\"\n      ],\n      \"path\": [\n        {\n          \"bookId\": \"01-behaviors\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-fixed\",\n            \"2-relative\",\n            \"3-simulation-function\",\n            \"4-dispatch\",\n            \"5-endpoint-contract\"\n          ]\n        }\n      ],\n      \"alsoSee\": [\n        \"01-behaviors\",\n        \"02-adapters\"\n      ]\n    },\n    {\n      \"id\": \"expose-node-service\",\n      \"title\": \"Expose a Node.js HTTP service\",\n      \"goal\": \"Wrap a simulator with the Node HTTP adapter, and for processes that bind a port use @x12i/core-service (/health, /_live).\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"node\",\n        \"http\",\n        \"adapters\",\n        \"core-service\"\n      ],\n      \"path\": [\n        {\n          \"bookId\": \"02-adapters\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-node-http-adapter\",\n            \"2-http-process-compliance-local-services\",\n            \"3-multiple-apis\",\n            \"7-express-and-fastify\"\n          ]\n        }\n      ],\n      \"alsoSee\": [\n        \"02-adapters\"\n      ]\n    },\n    {\n      \"id\": \"ship-package-simulator\",\n      \"title\": \"Ship a package simulator\",\n      \"goal\": \"Structure a product-owned package with logic, data, optional static-memorix composition, and core-service on the HTTP entry.\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"packages\",\n        \"memorix\",\n        \"core-service\"\n      ],\n      \"path\": [\n        {\n          \"bookId\": \"03-package-simulators\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-what-a-package-simulator-is\",\n            \"2-recommended-structure\",\n            \"4-with-static-memorix\"\n          ]\n        },\n        {\n          \"bookId\": \"02-adapters\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"2-http-process-compliance-local-services\"\n          ]\n        }\n      ],\n      \"alsoSee\": [\n        \"03-package-simulators\",\n        \"02-adapters\"\n      ]\n    },\n    {\n      \"id\": \"run-playground-studio\",\n      \"title\": \"Run Playground and Studio\",\n      \"goal\": \"Start the local UI apps, know the port map, and understand the product rule.\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"ui\",\n        \"playground\",\n        \"studio\"\n      ],\n      \"path\": [\n        {\n          \"bookId\": \"04-playground-studio\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-two-surfaces\",\n            \"2-run-locally\",\n            \"3-ports\",\n            \"4-product-rule\"\n          ]\n        }\n      ],\n      \"alsoSee\": [\n        \"04-playground-studio\"\n      ]\n    },\n    {\n      \"id\": \"library-demo-rest\",\n      \"title\": \"Build a plain REST package simulator\",\n      \"goal\": \"Follow the library-demo path: data modules, relative/simulation endpoints, no Memorix.\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"tags\": [\n        \"examples\",\n        \"rest\",\n        \"tutorial\"\n      ],\n      \"path\": [\n        {\n          \"bookId\": \"03-package-simulators\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-what-a-package-simulator-is\",\n            \"3-plain-rest-library-demo\"\n          ]\n        },\n        {\n          \"bookId\": \"01-behaviors\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"2-relative\",\n            \"3-simulation-function\"\n          ]\n        }\n      ],\n      \"alsoSee\": [\n        \"03-package-simulators\",\n        \"01-behaviors\"\n      ]\n    }\n  ]\n}",
+    "site.json": "{\n  \"product\": \"api-simulator\",\n  \"brand\": \"x12i · api-simulator\",\n  \"brandAccent\": \"api-simulator\",\n  \"siteUrl\": \"https://docs.api-simulator.x12i.com\",\n  \"knowledgePackage\": \"@x12i/api-simulator-docs\",\n  \"footer\": \"api-simulator\",\n  \"accent\": \"oklch(45% 0.12 230)\",\n  \"accentAlt\": \"oklch(55% 0.12 50)\",\n  \"productUrl\": \"https://github.com/x12i/api-simulator\",\n  \"nav\": [\n    {\n      \"label\": \"Getting started\",\n      \"href\": \"/getting-started\"\n    },\n    {\n      \"label\": \"Use cases\",\n      \"href\": \"/use-cases\"\n    },\n    {\n      \"label\": \"Catalog\",\n      \"href\": \"/catalog\"\n    }\n  ],\n  \"footerLinks\": [\n    {\n      \"label\": \"Docs home\",\n      \"href\": \"/docs\"\n    },\n    {\n      \"label\": \"Getting started\",\n      \"href\": \"/getting-started\"\n    },\n    {\n      \"label\": \"Use cases\",\n      \"href\": \"/use-cases\"\n    },\n    {\n      \"label\": \"Catalog\",\n      \"href\": \"/catalog\"\n    },\n    {\n      \"label\": \"Agents/SDK\",\n      \"href\": \"/agents\"\n    }\n  ]\n}",
+    "agent-manifest.json": "{\n  \"version\": 1,\n  \"product\": \"api-simulator\",\n  \"site\": \"https://docs.api-simulator.x12i.com\",\n  \"knowledgePackage\": \"@x12i/api-simulator-docs\",\n  \"roles\": [\n    \"developers\"\n  ],\n  \"books\": [\n    {\n      \"id\": \"00-overview\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/00-overview/developers.md\"\n      },\n      \"pdf\": {\n        \"developers\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/00-overview/developers.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"01-behaviors\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/01-behaviors/developers.md\"\n      },\n      \"pdf\": {\n        \"developers\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/01-behaviors/developers.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"02-adapters\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/02-adapters/developers.md\"\n      },\n      \"pdf\": {\n        \"developers\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/02-adapters/developers.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"03-package-simulators\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/03-package-simulators/developers.md\"\n      },\n      \"pdf\": {\n        \"developers\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/03-package-simulators/developers.chapters.json\"\n      }\n    },\n    {\n      \"id\": \"04-playground-studio\",\n      \"audiences\": [\n        \"developers\"\n      ],\n      \"md\": {\n        \"developers\": \"downloads/books/04-playground-studio/developers.md\"\n      },\n      \"pdf\": {\n        \"developers\": null\n      },\n      \"chapters\": {\n        \"developers\": \"downloads/books/04-playground-studio/developers.chapters.json\"\n      }\n    }\n  ],\n  \"useCases\": [\n    {\n      \"id\": \"orient-simulator\",\n      \"title\": \"Orient on api-simulator\",\n      \"md\": \"downloads/use-cases/orient-simulator.md\",\n      \"path\": [\n        {\n          \"bookId\": \"00-overview\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-what-it-is\",\n            \"2-install\",\n            \"3-minimal-example\",\n            \"4-where-to-go-next\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"define-three-behaviors\",\n      \"title\": \"Define the three endpoint behaviors\",\n      \"md\": \"downloads/use-cases/define-three-behaviors.md\",\n      \"path\": [\n        {\n          \"bookId\": \"01-behaviors\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-fixed\",\n            \"2-relative\",\n            \"3-simulation-function\",\n            \"4-dispatch\",\n            \"5-endpoint-contract\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"expose-node-service\",\n      \"title\": \"Expose a Node.js HTTP service\",\n      \"md\": \"downloads/use-cases/expose-node-service.md\",\n      \"path\": [\n        {\n          \"bookId\": \"02-adapters\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-node-http-adapter\",\n            \"2-http-process-compliance-local-services\",\n            \"3-multiple-apis\",\n            \"7-express-and-fastify\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"ship-package-simulator\",\n      \"title\": \"Ship a package simulator\",\n      \"md\": \"downloads/use-cases/ship-package-simulator.md\",\n      \"path\": [\n        {\n          \"bookId\": \"03-package-simulators\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-what-a-package-simulator-is\",\n            \"2-recommended-structure\",\n            \"4-with-static-memorix\"\n          ]\n        },\n        {\n          \"bookId\": \"02-adapters\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"2-http-process-compliance-local-services\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"run-playground-studio\",\n      \"title\": \"Run Playground and Studio\",\n      \"md\": \"downloads/use-cases/run-playground-studio.md\",\n      \"path\": [\n        {\n          \"bookId\": \"04-playground-studio\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-two-surfaces\",\n            \"2-run-locally\",\n            \"3-ports\",\n            \"4-product-rule\"\n          ]\n        }\n      ]\n    },\n    {\n      \"id\": \"library-demo-rest\",\n      \"title\": \"Build a plain REST package simulator\",\n      \"md\": \"downloads/use-cases/library-demo-rest.md\",\n      \"path\": [\n        {\n          \"bookId\": \"03-package-simulators\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"1-what-a-package-simulator-is\",\n            \"3-plain-rest-library-demo\"\n          ]\n        },\n        {\n          \"bookId\": \"01-behaviors\",\n          \"audience\": \"developers\",\n          \"chapters\": [\n            \"2-relative\",\n            \"3-simulation-function\"\n          ]\n        }\n      ]\n    }\n  ]\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-install\",\n    \"title\": \"2. Install\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"3-minimal-example\",\n    \"title\": \"3. Minimal example\",\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 installing and evaluating `@x12i/api-simulator`.  \n**Related:** [Behaviors](../01-behaviors/developers/BOOK.md) · [Package simulators](../03-package-simulators/developers/BOOK.md)\n\n---\n\n## 1. What it is\n\nCore TypeScript framework for building simulated API services.\n\nEach endpoint defines **exactly one** behavior:\n\n1. `fixed` — always return the configured response.\n2. `relative` — render a configured JSON response using values from the request and API-local data.\n3. `simulation` — run a function that receives the matched request and returns a response.\n\nThe core is transport-agnostic. It can be called directly from tests, wrapped by Fastify/Express, or exposed through the included Node.js HTTP adapter.\n\n**Data and metadata:** this package does **not** load fixtures from disk, MongoDB, Memorix, or HTTP. Consumers pass an in-memory `SimulatorDefinition` (`api.data` + endpoints). Optional helpers (`createStore`, OpenAPI) still take data you supply. Product-owned **package simulators** ship their own logic, data, and (when needed) Memorix fixtures.\n\n---\n\n## 2. Install\n\n```bash\nnpm install @x12i/api-simulator\n```\n\nRequires Node.js 20+.\n\n---\n\n## 3. Minimal example\n\n```ts\nimport { createApiSimulator } from '@x12i/api-simulator';\n\nconst simulator = createApiSimulator({\n  apis: [\n    {\n      id: 'objects-api',\n      basePath: '/api/v1',\n      data: {\n        children: [\n          {\n            id: 'child-1',\n            parentId: '{{request.params.parentId}}'\n          },\n          {\n            id: 'child-2',\n            parentId: '{{request.params.parentId}}'\n          }\n        ]\n      },\n      endpoints: [\n        {\n          id: 'health',\n          method: 'GET',\n          path: '/health',\n          behavior: {\n            type: 'fixed',\n            response: {\n              status: 200,\n              body: { status: 'ok' }\n            }\n          }\n        },\n        {\n          id: 'list-children',\n          method: 'GET',\n          path: '/parents/:parentId/children',\n          behavior: {\n            type: 'relative',\n            response: {\n              body: {\n                parentId: '{{request.params.parentId}}',\n                items: '{{data.children}}'\n              }\n            }\n          }\n        },\n        {\n          id: 'calculate-score',\n          method: 'POST',\n          path: '/score',\n          behavior: {\n            type: 'simulation',\n            handler: ({ request }) => {\n              const values = (request.body as { values: number[] }).values;\n              return {\n                body: {\n                  score: values.reduce((sum, value) => sum + value, 0)\n                }\n              };\n            }\n          }\n        }\n      ]\n    }\n  ]\n});\n```\n\n---\n\n## 4. Where to go next\n\n- Try the **Playground** app (anonymous, ~30-second first dispatch).\n- Author projects in **Studio** (local-first).\n- Follow [`examples/library-demo/TUTORIAL.md`](../../../examples/library-demo/TUTORIAL.md) for a guided REST walkthrough.\n- Or [`examples/flowstate-simulator/TUTORIAL.md`](../../../examples/flowstate-simulator/TUTORIAL.md) to compose with `@x12i/static-memorix`.\n- Use cases: `orient-simulator`, `define-three-behaviors`, `ship-package-simulator`.\n",
+    "downloads/books/01-behaviors/developers.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"1-fixed\",\n    \"title\": \"1. Fixed\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"2-relative\",\n    \"title\": \"2. Relative\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"3-simulation-function\",\n    \"title\": \"3. Simulation function\",\n    \"level\": 2,\n    \"order\": 3\n  },\n  {\n    \"slug\": \"4-dispatch\",\n    \"title\": \"4. Dispatch\",\n    \"level\": 2,\n    \"order\": 4\n  },\n  {\n    \"slug\": \"5-endpoint-contract\",\n    \"title\": \"5. Endpoint contract\",\n    \"level\": 2,\n    \"order\": 5\n  },\n  {\n    \"slug\": \"6-artificial-latency\",\n    \"title\": \"6. Artificial latency\",\n    \"level\": 2,\n    \"order\": 6\n  },\n  {\n    \"slug\": \"7-raw-responses\",\n    \"title\": \"7. Raw responses\",\n    \"level\": 2,\n    \"order\": 7\n  },\n  {\n    \"slug\": \"8-path-patterns\",\n    \"title\": \"8. Path patterns\",\n    \"level\": 2,\n    \"order\": 8\n  }\n]",
+    "downloads/books/01-behaviors/developers.md": "# Behaviors and Dispatch — Developers\n\n**Audience:** Engineers defining endpoint behaviors and calling `dispatch`.  \n**Related:** [Overview](../00-overview/developers/BOOK.md) · [Adapters](../02-adapters/developers/BOOK.md)\n\n---\n\n## 1. Fixed\n\nUse fixed behavior for health endpoints, stable metadata, constants, and simple fixtures.\n\n```ts\n{\n  id: 'capabilities',\n  method: 'GET',\n  path: '/capabilities',\n  behavior: {\n    type: 'fixed',\n    response: {\n      status: 200,\n      headers: { 'x-simulator': 'true' },\n      body: { features: ['read', 'search'] }\n    }\n  }\n}\n```\n\n---\n\n## 2. Relative\n\nRelative behavior starts with configured JSON, then resolves tokens against the matched request and the API's internal `data` object.\n\nSupported token roots:\n\n- `{{request.params.parentId}}`\n- `{{request.query.page}}`\n- `{{request.headers.x-tenant-id}}`\n- `{{request.body.customer.id}}`\n- `{{data.children}}`\n- Array indexes, such as `{{data.users[0].id}}`\n\n```ts\n{\n  id: 'children',\n  method: 'GET',\n  path: '/parents/:parentId/children',\n  behavior: {\n    type: 'relative',\n    response: {\n      body: {\n        parentId: '{{request.params.parentId}}',\n        items: '{{data.children}}'\n      }\n    }\n  }\n}\n```\n\nA token occupying the entire string preserves its original type. Therefore, `{{request.body.limit}}` can produce a number and `{{data.children}}` can produce an array. A token embedded inside text is converted to a string:\n\n```ts\n{ message: 'Children for parent {{request.params.parentId}}' }\n```\n\nTokens inside API-local data are rendered too. This lets a reusable internal fixture inherit an identifier from the incoming request:\n\n```ts\ndata: {\n  children: [\n    { id: 'child-1', parentId: '{{request.params.parentId}}' }\n  ]\n}\n```\n\nRelative behavior is strict by default. A missing token throws `TemplateResolutionError`. Set `strict: false` to leave unresolved tokens unchanged.\n\n---\n\n## 3. Simulation function\n\nUse a simulation function when output needs conditions, calculations, validation, generated values, branching, or error responses.\n\n```ts\n{\n  id: 'quote',\n  method: 'POST',\n  path: '/quote',\n  behavior: {\n    type: 'simulation',\n    handler: async ({ request, data, apiId, endpointId }) => {\n      const quantity = Number((request.body as { quantity: number }).quantity);\n      const unitPrice = Number(data.unitPrice);\n\n      return {\n        status: 201,\n        body: {\n          apiId,\n          endpointId,\n          quantity,\n          unitPrice,\n          total: quantity * unitPrice\n        }\n      };\n    }\n  }\n}\n```\n\n---\n\n## 4. Dispatch\n\n```ts\nconst result = await simulator.dispatch({\n  method: 'GET',\n  path: '/api/v1/parents/parent-42/children'\n});\n\nconsole.log(result.response.body);\n```\n\n`dispatch()` throws `EndpointNotFoundError` when nothing matches. `tryDispatch()` returns `undefined` instead.\n\n---\n\n## 5. Endpoint contract\n\n```ts\ntype EndpointDefinition = {\n  id: string;\n  method: HttpMethod;\n  path: string;\n  enabled?: boolean;\n  delayMs?: number;\n  behavior:\n    | { type: 'fixed'; response: SimulatorResponse }\n    | { type: 'relative'; response: SimulatorResponse; strict?: boolean }\n    | { type: 'simulation'; handler: SimulationFunction };\n};\n```\n\nThe discriminated `behavior` union is the core guarantee: an endpoint cannot validly have two behaviors, and it cannot omit its behavior.\n\n---\n\n## 6. Artificial latency\n\n```ts\n{\n  id: 'slow-search',\n  method: 'GET',\n  path: '/search',\n  delayMs: 750,\n  behavior: {\n    type: 'fixed',\n    response: { body: { items: [] } }\n  }\n}\n```\n\n---\n\n## 7. Raw responses\n\n```ts\nimport { RawResponseBody, createApiSimulator } from '@x12i/api-simulator';\n\n// In a simulation handler:\nreturn {\n  body: new RawResponseBody('<h1>hello</h1>', 'text/html; charset=utf-8')\n};\n```\n\nTransport adapters write `RawResponseBody` verbatim instead of `JSON.stringify`.\n\n---\n\n## 8. Path patterns\n\nSupports `:id`, `:id(\\\\d+)`, and optional `:slug?` segments. Static routes are matched before parameter routes, so `/users/me` wins over `/users/:id`.\n",
+    "downloads/books/02-adapters/developers.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"1-node-http-adapter\",\n    \"title\": \"1. Node HTTP adapter\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"2-http-process-compliance-local-services\",\n    \"title\": \"2. HTTP process compliance (local services)\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"3-multiple-apis\",\n    \"title\": \"3. Multiple APIs\",\n    \"level\": 2,\n    \"order\": 3\n  },\n  {\n    \"slug\": \"4-in-memory-store\",\n    \"title\": \"4. In-memory store\",\n    \"level\": 2,\n    \"order\": 4\n  },\n  {\n    \"slug\": \"5-openapi-skeletons\",\n    \"title\": \"5. OpenAPI skeletons\",\n    \"level\": 2,\n    \"order\": 5\n  },\n  {\n    \"slug\": \"6-fetch-adapter\",\n    \"title\": \"6. Fetch adapter\",\n    \"level\": 2,\n    \"order\": 6\n  },\n  {\n    \"slug\": \"7-express-and-fastify\",\n    \"title\": \"7. Express and Fastify\",\n    \"level\": 2,\n    \"order\": 7\n  },\n  {\n    \"slug\": \"8-auth-and-rate-limits\",\n    \"title\": \"8. Auth and rate limits\",\n    \"level\": 2,\n    \"order\": 8\n  },\n  {\n    \"slug\": \"9-cors-host-and-validators\",\n    \"title\": \"9. CORS host and validators\",\n    \"level\": 2,\n    \"order\": 9\n  },\n  {\n    \"slug\": \"10-record-and-replay\",\n    \"title\": \"10. Record and replay\",\n    \"level\": 2,\n    \"order\": 10\n  },\n  {\n    \"slug\": \"11-node-body-parsers\",\n    \"title\": \"11. Node body parsers\",\n    \"level\": 2,\n    \"order\": 11\n  },\n  {\n    \"slug\": \"12-simulator-options\",\n    \"title\": \"12. Simulator options\",\n    \"level\": 2,\n    \"order\": 12\n  }\n]",
+    "downloads/books/02-adapters/developers.md": "# Adapters and Helpers — Developers\n\n**Audience:** Engineers exposing simulators over HTTP and composing helpers.  \n**Related:** [Behaviors](../01-behaviors/developers/BOOK.md) · [Package simulators](../03-package-simulators/developers/BOOK.md)\n\n---\n\n## 1. Node HTTP adapter\n\n```ts\nimport { createServer } from 'node:http';\nimport { createNodeHttpHandler } from '@x12i/api-simulator/node';\n\ncreateServer(createNodeHttpHandler(simulator)).listen(5520);\n```\n\nThe adapter:\n\n- parses URL path and query values;\n- normalizes request headers to lowercase keys (values may be `string | string[]`);\n- parses JSON, urlencoded, and text bodies by default; returns `Buffer` for binary;\n- returns `404` when no simulated endpoint matches;\n- returns `500` when rendering or simulation fails;\n- limits request bodies to 1 MiB by default;\n- writes `RawResponseBody` verbatim (HTML/XML/CSV/binary).\n\nThe `./node` adapter is **transport-only**. It does not bind ports, serve `/_live`, or print a compliance banner. Processes that **listen on HTTP** should wrap it with `@x12i/core-service` (next section).\n\n---\n\n## 2. HTTP process compliance (local services)\n\nAny example or package simulator that **binds an HTTP port** should use [`@x12i/core-service`](https://www.npmjs.com/package/@x12i/core-service) (pulls `@x12i/api-live-view`; uses `@x12i/ports-manager`).\n\nProduct contract (current **`@x12i/memorix-docs`**, not old memorix-ebooks):\n\n- Use case **`http-process-compliance`**\n- Building Services (developers) → **HTTP process compliance (local services)**\n- Deep reference: package READMEs for `core-service`, `ports-manager`, `api-live-view`\n\nThis repo applies that contract in zone **`api-simulator` (5520–5539)** — not Memorix’s 5100–5119.\n\n| Surface | Role |\n|--------|------|\n| Port from zone map | `scripts/api-simulator-ports.mjs` / `createSimulatorHttp` |\n| `GET /health` | Process liveness |\n| `/_live` | In-process request rings (api-live-view) |\n| `x-correlation-id` | Request/response correlation |\n| Startup banner | origin · health · live · docs |\n\nShared helper:\n\n```js\nimport { createSimulatorHttp } from '../../scripts/create-simulator-http.mjs';\n\nconst { core, announce } = createSimulatorHttp({\n  id: 'my-simulator',\n  title: 'My package simulator',\n  portKey: 'api', // or flowstate / libraryDemo\n  portEnv: 'API_SIMULATOR_API_PORT'\n});\n\nconst server = createServer(async (req, res) => {\n  if (await core.tryHandleCore(req, res)) return;\n  await createNodeHttpHandler(simulator)(req, res);\n});\n\nawait announce(server);\n```\n\nPublished `@x12i/api-simulator` stays **zero runtime dependencies**. Remote *clients* do not install these kits; *servers that bind* do.\n\n---\n\n## 3. Multiple APIs\n\nA single simulator can expose many APIs. Each API has its own `id`, optional `basePath`, internal `data`, and endpoints.\n\n```ts\nconst simulator = createApiSimulator({\n  apis: [crmApi, billingApi, identityApi]\n});\n```\n\nDuplicate `METHOD + full path` routes are rejected during startup. Structurally ambiguous routes such as `/users/:id` and `/users/:name` are also rejected. Static routes are matched before parameter routes.\n\n---\n\n## 4. In-memory store\n\n```ts\nimport { createStore } from '@x12i/api-simulator/store';\n\nconst users = createStore([{ id: '1', name: 'Ada' }]);\nusers.create({ name: 'Grace' });\nusers.list({ name: 'Ada' });\nusers.reset(); // restore seed — useful between tests\n```\n\n---\n\n## 5. OpenAPI skeletons\n\n```ts\nimport { openapiToApiDefinition } from '@x12i/api-simulator/openapi';\n\nconst api = openapiToApiDefinition(parsedOpenApiObject, { id: 'pets-api', basePath: '/v1' });\n```\n\nPass an already-parsed JS object (parse YAML yourself if needed).\n\n---\n\n## 6. Fetch adapter\n\n```ts\nimport { createFetchHandler } from '@x12i/api-simulator/fetch';\n\nexport default {\n  fetch: createFetchHandler(simulator)\n};\n```\n\n---\n\n## 7. Express and Fastify\n\n```ts\n// Express\napp.use(async (req, res) => {\n  const match = await simulator.tryDispatch({\n    method: req.method,\n    path: req.path,\n    headers: req.headers,\n    query: req.query,\n    body: req.body\n  });\n  if (!match) return res.status(404).json({ error: 'NOT_FOUND' });\n  res.status(match.response.status ?? 200).set(match.response.headers ?? {}).send(match.response.body);\n});\n```\n\n---\n\n## 8. Auth and rate limits\n\n```ts\nimport { requireBearerToken, rateLimit } from '@x12i/api-simulator/helpers';\n\nhandler: rateLimit({ windowMs: 60_000, max: 30 })(\n  requireBearerToken((token) => token === 'secret')(\n    ({ request }) => ({ body: { ok: true, path: request.path } })\n  )\n)\n```\n\n---\n\n## 9. CORS host and validators\n\n```ts\n{\n  id: 'api',\n  host: 'tenant.example.com',\n  cors: { origins: '*', methods: ['GET', 'POST', 'OPTIONS'] },\n  endpoints: [{\n    id: 'create',\n    method: 'POST',\n    path: '/items',\n    validate: ({ request }) => {\n      if (!request.body) return { status: 400, body: { error: 'EMPTY' } };\n    },\n    behavior: { type: 'fixed', response: { status: 201, body: { ok: true } } }\n  }]\n}\n```\n\n---\n\n## 10. Record and replay\n\n```bash\nnode scripts/record-replay.mjs --base https://httpbin.org --paths /get,/uuid --out captured.json\n```\n\n---\n\n## 11. Node body parsers\n\nBuilt-in parsers: JSON, `application/x-www-form-urlencoded`, `text/plain`. Binary bodies are returned as `Buffer`. Plug in multipart yourself:\n\n```ts\ncreateNodeHttpHandler(simulator, {\n  bodyParsers: {\n    'multipart/form-data': async (raw, contentType) => {\n      // use busboy / your parser of choice\n      return { rawLength: raw.length, contentType };\n    }\n  }\n});\n```\n\n---\n\n## 12. Simulator options\n\n```ts\nconst simulator = createApiSimulator(definition, {\n  recordHistory: { limit: 100 },\n  validateTemplates: true // checks {{data.*}} at construction\n});\n\nsimulator.getHistory();\nsimulator.clearHistory();\n```\n",
+    "downloads/books/03-package-simulators/developers.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"1-what-a-package-simulator-is\",\n    \"title\": \"1. What a package simulator is\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"2-recommended-structure\",\n    \"title\": \"2. Recommended structure\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"3-plain-rest-library-demo\",\n    \"title\": \"3. Plain REST library-demo\",\n    \"level\": 2,\n    \"order\": 3\n  },\n  {\n    \"slug\": \"4-with-static-memorix\",\n    \"title\": \"4. With static-memorix\",\n    \"level\": 2,\n    \"order\": 4\n  },\n  {\n    \"slug\": \"5-flowstate-walkthrough\",\n    \"title\": \"5. FlowState walkthrough\",\n    \"level\": 2,\n    \"order\": 5\n  }\n]",
+    "downloads/books/03-package-simulators/developers.md": "# Package Simulators — Developers\n\n**Audience:** Engineers shipping product-owned simulator packages.  \n**Related:** [Overview](../00-overview/developers/BOOK.md) · [Behaviors](../01-behaviors/developers/BOOK.md)\n\n---\n\n## 1. What a package simulator is\n\nA **package simulator** is a small product-owned package that uses `@x12i/api-simulator` as the engine and ships its own:\n\n- **logic** — `simulation` handlers (and optional `createStore` state)\n- **data** — seeds under `api.data` and/or fixture JSON\n- **metadata** — when the product speaks Memorix, declarative packs and explorer fixtures\n\nThe core library stays **zero runtime dependencies** and does not load data or metadata from disk, MongoDB, or HTTP. Your package (or an example like `examples/flowstate-simulator`) owns that.\n\n---\n\n## 2. Recommended structure\n\n```text\nmy-provider-simulator/\n├─ mocks/                    # optional — shared with static-memorix when used\n│  ├─ data/\n│  ├─ metadata/\n│  └─ metadata-packs/\n├─ src/\n│  ├─ data/                  # seeds for api.data / createStore\n│  ├─ simulations/           # package-specific handlers\n│  ├─ api.ts                 # createApiSimulator({ apis: [...] })\n│  ├─ memorix.ts             # optional — buildServer({ MOCKS_DIR })\n│  └─ server.ts              # Node/HTTP entry: core-service + tryDispatch ± forward\n└─ package.json\n```\n\nKeep provider-specific data and simulation logic outside `@x12i/api-simulator`. The core remains the reusable engine.\n\nHTTP entrypoints that bind a port use [`@x12i/core-service`](https://www.npmjs.com/package/@x12i/core-service) (see [Adapters — HTTP process compliance](../02-adapters/developers/BOOK.md#2-http-process-compliance-local-services)). Shared helper in this repo: [`scripts/create-simulator-http.mjs`](../../../scripts/create-simulator-http.mjs).\n\n---\n\n## 3. Plain REST library-demo\n\nIf the API is ordinary REST (no Memorix), follow [`examples/library-demo/TUTORIAL.md`](../../../examples/library-demo/TUTORIAL.md):\n\n1. Data modules seed `api.data` / `createStore`.\n2. Relative endpoints for list/read shapes; simulation handlers for writes and branching.\n3. `createApiSimulator` + optional Node HTTP entry — **no** `@x12i/static-memorix`.\n\nRunnable reference: [`examples/library-demo/`](../../../examples/library-demo).\n\n---\n\n## 4. With static-memorix\n\nFor Memorix Explorer (`/api/explorer/*`) and Metadata (`/api/metadata/*`) parity without MongoDB/Redis, compose [`@x12i/static-memorix`](https://www.npmjs.com/package/@x12i/static-memorix):\n\n1. Keep a shared `mocks/` tree (`data/`, `metadata/`, `metadata-packs/`).\n2. Load seeds into package REST via small helpers (see the FlowState example’s `src/bridge.mjs`).\n3. Run `buildServer()` / `startServer()` with `MOCKS_DIR` pointing at that tree.\n4. Serve one port with `@x12i/core-service`: `tryHandleCore` → `tryDispatch` package routes → forward misses to static-memorix (`inject`).\n\n| Surface | Owner |\n|--------|--------|\n| `/health`, `/_live` | `@x12i/core-service` (zone `api-simulator`) |\n| `/api/v1/<your-product>/*` | `@x12i/api-simulator` endpoints in your package |\n| `/api/explorer/*`, `/api/metadata/*` | `@x12i/static-memorix` (`MOCKS_DIR` → shared `mocks/`) |\n\n**Org scope:** `x-memorix-org-id` may be sent for client realism; it is a **no-op for isolation** in this simulator (not `memorix-service`).\n\nstatic-memorix is not a substitute for full `memorix-service` (pipelines, relationship materialize, abstract reverse-write, etc.).\n\n---\n\n## 5. FlowState walkthrough\n\nFull compose walkthrough: [`examples/flowstate-simulator/TUTORIAL.md`](../../../examples/flowstate-simulator/TUTORIAL.md).\n\n```bash\nnode examples/flowstate-simulator/demo.mjs\nnode examples/flowstate-simulator/src/server.mjs   # :5522\n```\n",
+    "downloads/books/04-playground-studio/developers.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"1-two-surfaces\",\n    \"title\": \"1. Two surfaces\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"2-run-locally\",\n    \"title\": \"2. Run locally\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"3-ports\",\n    \"title\": \"3. Ports\",\n    \"level\": 2,\n    \"order\": 3\n  },\n  {\n    \"slug\": \"4-product-rule\",\n    \"title\": \"4. Product rule\",\n    \"level\": 2,\n    \"order\": 4\n  },\n  {\n    \"slug\": \"5-out-of-v1-studio\",\n    \"title\": \"5. Out of v1 Studio\",\n    \"level\": 2,\n    \"order\": 5\n  }\n]",
+    "downloads/books/04-playground-studio/developers.md": "# Playground and Studio — Developers\n\n**Audience:** Engineers running the local UI apps.  \n**Related:** [Overview](../00-overview/developers/BOOK.md)\n\n---\n\n## 1. Two surfaces\n\nTwo separate UI apps over `@x12i/api-simulator`. They are **not** one merged workspace.\n\n| Surface | Job | Mindset |\n|---|---|---|\n| Playground (`apps/playground`) | Try a request in ~30 seconds | Ephemeral, session-only |\n| Studio (`apps/studio`) | Author and own a simulator | Persistent (IndexedDB), exportable |\n\nPlayground **Open in Studio** hands off the current definition via `sessionStorage`.\n\n---\n\n## 2. Run locally\n\nFrom the repo root (after `npm install` and `npm run build`):\n\n```bash\nnpm run build\nnpm run dev -w @x12i/playground   # http://127.0.0.1:5523\nnpm run dev -w @x12i/studio       # http://127.0.0.1:5521\n```\n\nOr use the root aliases: `npm run dev:playground` / `npm run dev:studio`.\n\n---\n\n## 3. Ports\n\nPorts come from [`@x12i/ports-manager`](https://www.npmjs.com/package/@x12i/ports-manager) zone **`api-simulator`** (5520–5539, even = API, odd = UI). Wrapper: [`scripts/api-simulator-ports.mjs`](../../../scripts/api-simulator-ports.mjs).\n\n| Name | Port | Role |\n|------|------|------|\n| `api` / library-demo / codegen | 5520 | API |\n| `studio` (Vite) | 5521 | UI |\n| `flowstate` compose server | 5522 | API |\n| `playground` (Vite) | 5523 | UI |\n\n```bash\nnpx x12i-ports zone api-simulator\n```\n\n**UI apps vs API processes:** Playground and Studio are Vite **UI** processes (odd ports). They do not need `@x12i/core-service` `/_live`. Example **API** processes that bind even ports (library-demo, FlowState compose, `node-server`) use `@x12i/core-service` for `/health` and `/_live` — see [Adapters — HTTP process compliance](../02-adapters/developers/BOOK.md#2-http-process-compliance-local-services).\n\n---\n\n## 4. Product rule\n\nBoth apps edit a UI model that maps to `SimulatorDefinition` / endpoint behaviors. The library remains the API of record; the UIs generate and preview — they do not invent a parallel DSL.\n\n---\n\n## 5. Out of v1 Studio\n\nCloud auth/sync, org SSO, CI, marketplace, multi-env matrices, and share links are deferred (Studio v1.1+).\n",
+    "downloads/use-cases/define-three-behaviors.md": "# Define the three endpoint behaviors\n\n> **Use case id:** `define-three-behaviors`\n> **Goal:** Author fixed, relative, and simulation endpoints and dispatch them from tests or adapters.\n> **Audiences:** developers\n> **Tags:** behaviors, dispatch\n\n## Reading path\n\n1. **Behaviors and Dispatch** (developers) → chapters: `1-fixed`, `2-relative`, `3-simulation-function`, `4-dispatch`, `5-endpoint-contract`\n\n## From: Behaviors and Dispatch — 1. Fixed\n\nUse fixed behavior for health endpoints, stable metadata, constants, and simple fixtures.\n\n```ts\n{\n  id: 'capabilities',\n  method: 'GET',\n  path: '/capabilities',\n  behavior: {\n    type: 'fixed',\n    response: {\n      status: 200,\n      headers: { 'x-simulator': 'true' },\n      body: { features: ['read', 'search'] }\n    }\n  }\n}\n```\n\n---\n\n## From: Behaviors and Dispatch — 2. Relative\n\nRelative behavior starts with configured JSON, then resolves tokens against the matched request and the API's internal `data` object.\n\nSupported token roots:\n\n- `{{request.params.parentId}}`\n- `{{request.query.page}}`\n- `{{request.headers.x-tenant-id}}`\n- `{{request.body.customer.id}}`\n- `{{data.children}}`\n- Array indexes, such as `{{data.users[0].id}}`\n\n```ts\n{\n  id: 'children',\n  method: 'GET',\n  path: '/parents/:parentId/children',\n  behavior: {\n    type: 'relative',\n    response: {\n      body: {\n        parentId: '{{request.params.parentId}}',\n        items: '{{data.children}}'\n      }\n    }\n  }\n}\n```\n\nA token occupying the entire string preserves its original type. Therefore, `{{request.body.limit}}` can produce a number and `{{data.children}}` can produce an array. A token embedded inside text is converted to a string:\n\n```ts\n{ message: 'Children for parent {{request.params.parentId}}' }\n```\n\nTokens inside API-local data are rendered too. This lets a reusable internal fixture inherit an identifier from the incoming request:\n\n```ts\ndata: {\n  children: [\n    { id: 'child-1', parentId: '{{request.params.parentId}}' }\n  ]\n}\n```\n\nRelative behavior is strict by default. A missing token throws `TemplateResolutionError`. Set `strict: false` to leave unresolved tokens unchanged.\n\n---\n\n## From: Behaviors and Dispatch — 3. Simulation function\n\nUse a simulation function when output needs conditions, calculations, validation, generated values, branching, or error responses.\n\n```ts\n{\n  id: 'quote',\n  method: 'POST',\n  path: '/quote',\n  behavior: {\n    type: 'simulation',\n    handler: async ({ request, data, apiId, endpointId }) => {\n      const quantity = Number((request.body as { quantity: number }).quantity);\n      const unitPrice = Number(data.unitPrice);\n\n      return {\n        status: 201,\n        body: {\n          apiId,\n          endpointId,\n          quantity,\n          unitPrice,\n          total: quantity * unitPrice\n        }\n      };\n    }\n  }\n}\n```\n\n---\n\n## From: Behaviors and Dispatch — 4. Dispatch\n\n```ts\nconst result = await simulator.dispatch({\n  method: 'GET',\n  path: '/api/v1/parents/parent-42/children'\n});\n\nconsole.log(result.response.body);\n```\n\n`dispatch()` throws `EndpointNotFoundError` when nothing matches. `tryDispatch()` returns `undefined` instead.\n\n---\n\n## From: Behaviors and Dispatch — 5. Endpoint contract\n\n```ts\ntype EndpointDefinition = {\n  id: string;\n  method: HttpMethod;\n  path: string;\n  enabled?: boolean;\n  delayMs?: number;\n  behavior:\n    | { type: 'fixed'; response: SimulatorResponse }\n    | { type: 'relative'; response: SimulatorResponse; strict?: boolean }\n    | { type: 'simulation'; handler: SimulationFunction };\n};\n```\n\nThe discriminated `behavior` union is the core guarantee: an endpoint cannot validly have two behaviors, and it cannot omit its behavior.\n\n---\n\n## Also see\n\n- **Behaviors and Dispatch** (`01-behaviors`) — The three endpoint behaviors, dispatch APIs, contracts, latency, raw bodies, and path patterns.\n- **Adapters and Helpers** (`02-adapters`) — Expose simulators over HTTP, compose helpers, and plug into Express, Fastify, or fetch runtimes.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "downloads/use-cases/expose-node-service.md": "# Expose a Node.js HTTP service\n\n> **Use case id:** `expose-node-service`\n> **Goal:** Wrap a simulator with the Node HTTP adapter, and for processes that bind a port use @x12i/core-service (/health, /_live).\n> **Audiences:** developers\n> **Tags:** node, http, adapters, core-service\n\n## Reading path\n\n1. **Adapters and Helpers** (developers) → chapters: `1-node-http-adapter`, `2-http-process-compliance-local-services`, `3-multiple-apis`, `7-express-and-fastify`\n\n## From: Adapters and Helpers — 1. Node HTTP adapter\n\n```ts\nimport { createServer } from 'node:http';\nimport { createNodeHttpHandler } from '@x12i/api-simulator/node';\n\ncreateServer(createNodeHttpHandler(simulator)).listen(5520);\n```\n\nThe adapter:\n\n- parses URL path and query values;\n- normalizes request headers to lowercase keys (values may be `string | string[]`);\n- parses JSON, urlencoded, and text bodies by default; returns `Buffer` for binary;\n- returns `404` when no simulated endpoint matches;\n- returns `500` when rendering or simulation fails;\n- limits request bodies to 1 MiB by default;\n- writes `RawResponseBody` verbatim (HTML/XML/CSV/binary).\n\nThe `./node` adapter is **transport-only**. It does not bind ports, serve `/_live`, or print a compliance banner. Processes that **listen on HTTP** should wrap it with `@x12i/core-service` (next section).\n\n---\n\n## From: Adapters and Helpers — 2. HTTP process compliance (local services)\n\nAny example or package simulator that **binds an HTTP port** should use [`@x12i/core-service`](https://www.npmjs.com/package/@x12i/core-service) (pulls `@x12i/api-live-view`; uses `@x12i/ports-manager`).\n\nProduct contract (current **`@x12i/memorix-docs`**, not old memorix-ebooks):\n\n- Use case **`http-process-compliance`**\n- Building Services (developers) → **HTTP process compliance (local services)**\n- Deep reference: package READMEs for `core-service`, `ports-manager`, `api-live-view`\n\nThis repo applies that contract in zone **`api-simulator` (5520–5539)** — not Memorix’s 5100–5119.\n\n| Surface | Role |\n|--------|------|\n| Port from zone map | `scripts/api-simulator-ports.mjs` / `createSimulatorHttp` |\n| `GET /health` | Process liveness |\n| `/_live` | In-process request rings (api-live-view) |\n| `x-correlation-id` | Request/response correlation |\n| Startup banner | origin · health · live · docs |\n\nShared helper:\n\n```js\nimport { createSimulatorHttp } from '../../scripts/create-simulator-http.mjs';\n\nconst { core, announce } = createSimulatorHttp({\n  id: 'my-simulator',\n  title: 'My package simulator',\n  portKey: 'api', // or flowstate / libraryDemo\n  portEnv: 'API_SIMULATOR_API_PORT'\n});\n\nconst server = createServer(async (req, res) => {\n  if (await core.tryHandleCore(req, res)) return;\n  await createNodeHttpHandler(simulator)(req, res);\n});\n\nawait announce(server);\n```\n\nPublished `@x12i/api-simulator` stays **zero runtime dependencies**. Remote *clients* do not install these kits; *servers that bind* do.\n\n---\n\n## From: Adapters and Helpers — 3. Multiple APIs\n\nA single simulator can expose many APIs. Each API has its own `id`, optional `basePath`, internal `data`, and endpoints.\n\n```ts\nconst simulator = createApiSimulator({\n  apis: [crmApi, billingApi, identityApi]\n});\n```\n\nDuplicate `METHOD + full path` routes are rejected during startup. Structurally ambiguous routes such as `/users/:id` and `/users/:name` are also rejected. Static routes are matched before parameter routes.\n\n---\n\n## From: Adapters and Helpers — 7. Express and Fastify\n\n```ts\n// Express\napp.use(async (req, res) => {\n  const match = await simulator.tryDispatch({\n    method: req.method,\n    path: req.path,\n    headers: req.headers,\n    query: req.query,\n    body: req.body\n  });\n  if (!match) return res.status(404).json({ error: 'NOT_FOUND' });\n  res.status(match.response.status ?? 200).set(match.response.headers ?? {}).send(match.response.body);\n});\n```\n\n---\n\n## Also see\n\n- **Adapters and Helpers** (`02-adapters`) — Expose simulators over HTTP, compose helpers, and plug into Express, Fastify, or fetch runtimes.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "downloads/use-cases/library-demo-rest.md": "# Build a plain REST package simulator\n\n> **Use case id:** `library-demo-rest`\n> **Goal:** Follow the library-demo path: data modules, relative/simulation endpoints, no Memorix.\n> **Audiences:** developers\n> **Tags:** examples, rest, tutorial\n\n## Reading path\n\n1. **Package Simulators** (developers) → chapters: `1-what-a-package-simulator-is`, `3-plain-rest-library-demo`\n1. **Behaviors and Dispatch** (developers) → chapters: `2-relative`, `3-simulation-function`\n\n## From: Package Simulators — 1. What a package simulator is\n\nA **package simulator** is a small product-owned package that uses `@x12i/api-simulator` as the engine and ships its own:\n\n- **logic** — `simulation` handlers (and optional `createStore` state)\n- **data** — seeds under `api.data` and/or fixture JSON\n- **metadata** — when the product speaks Memorix, declarative packs and explorer fixtures\n\nThe core library stays **zero runtime dependencies** and does not load data or metadata from disk, MongoDB, or HTTP. Your package (or an example like `examples/flowstate-simulator`) owns that.\n\n---\n\n## From: Package Simulators — 3. Plain REST library-demo\n\nIf the API is ordinary REST (no Memorix), follow [`examples/library-demo/TUTORIAL.md`](../../../examples/library-demo/TUTORIAL.md):\n\n1. Data modules seed `api.data` / `createStore`.\n2. Relative endpoints for list/read shapes; simulation handlers for writes and branching.\n3. `createApiSimulator` + optional Node HTTP entry — **no** `@x12i/static-memorix`.\n\nRunnable reference: [`examples/library-demo/`](../../../examples/library-demo).\n\n---\n\n## From: Behaviors and Dispatch — 2. Relative\n\nRelative behavior starts with configured JSON, then resolves tokens against the matched request and the API's internal `data` object.\n\nSupported token roots:\n\n- `{{request.params.parentId}}`\n- `{{request.query.page}}`\n- `{{request.headers.x-tenant-id}}`\n- `{{request.body.customer.id}}`\n- `{{data.children}}`\n- Array indexes, such as `{{data.users[0].id}}`\n\n```ts\n{\n  id: 'children',\n  method: 'GET',\n  path: '/parents/:parentId/children',\n  behavior: {\n    type: 'relative',\n    response: {\n      body: {\n        parentId: '{{request.params.parentId}}',\n        items: '{{data.children}}'\n      }\n    }\n  }\n}\n```\n\nA token occupying the entire string preserves its original type. Therefore, `{{request.body.limit}}` can produce a number and `{{data.children}}` can produce an array. A token embedded inside text is converted to a string:\n\n```ts\n{ message: 'Children for parent {{request.params.parentId}}' }\n```\n\nTokens inside API-local data are rendered too. This lets a reusable internal fixture inherit an identifier from the incoming request:\n\n```ts\ndata: {\n  children: [\n    { id: 'child-1', parentId: '{{request.params.parentId}}' }\n  ]\n}\n```\n\nRelative behavior is strict by default. A missing token throws `TemplateResolutionError`. Set `strict: false` to leave unresolved tokens unchanged.\n\n---\n\n## From: Behaviors and Dispatch — 3. Simulation function\n\nUse a simulation function when output needs conditions, calculations, validation, generated values, branching, or error responses.\n\n```ts\n{\n  id: 'quote',\n  method: 'POST',\n  path: '/quote',\n  behavior: {\n    type: 'simulation',\n    handler: async ({ request, data, apiId, endpointId }) => {\n      const quantity = Number((request.body as { quantity: number }).quantity);\n      const unitPrice = Number(data.unitPrice);\n\n      return {\n        status: 201,\n        body: {\n          apiId,\n          endpointId,\n          quantity,\n          unitPrice,\n          total: quantity * unitPrice\n        }\n      };\n    }\n  }\n}\n```\n\n---\n\n## Also see\n\n- **Package Simulators** (`03-package-simulators`) — Ship logic, data, and optional Memorix fixtures in a product package — with or without static-memorix.\n- **Behaviors and Dispatch** (`01-behaviors`) — The three endpoint behaviors, dispatch APIs, contracts, latency, raw bodies, and path patterns.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "downloads/use-cases/orient-simulator.md": "# Orient on api-simulator\n\n> **Use case id:** `orient-simulator`\n> **Goal:** Understand what the library does, install it, and run a minimal three-behavior example.\n> **Audiences:** developers\n> **Tags:** start-here, overview\n\n## Reading path\n\n1. **Overview** (developers) → chapters: `1-what-it-is`, `2-install`, `3-minimal-example`, `4-where-to-go-next`\n\n## From: Overview — 1. What it is\n\nCore TypeScript framework for building simulated API services.\n\nEach endpoint defines **exactly one** behavior:\n\n1. `fixed` — always return the configured response.\n2. `relative` — render a configured JSON response using values from the request and API-local data.\n3. `simulation` — run a function that receives the matched request and returns a response.\n\nThe core is transport-agnostic. It can be called directly from tests, wrapped by Fastify/Express, or exposed through the included Node.js HTTP adapter.\n\n**Data and metadata:** this package does **not** load fixtures from disk, MongoDB, Memorix, or HTTP. Consumers pass an in-memory `SimulatorDefinition` (`api.data` + endpoints). Optional helpers (`createStore`, OpenAPI) still take data you supply. Product-owned **package simulators** ship their own logic, data, and (when needed) Memorix fixtures.\n\n---\n\n## From: Overview — 2. Install\n\n```bash\nnpm install @x12i/api-simulator\n```\n\nRequires Node.js 20+.\n\n---\n\n## From: Overview — 3. Minimal example\n\n```ts\nimport { createApiSimulator } from '@x12i/api-simulator';\n\nconst simulator = createApiSimulator({\n  apis: [\n    {\n      id: 'objects-api',\n      basePath: '/api/v1',\n      data: {\n        children: [\n          {\n            id: 'child-1',\n            parentId: '{{request.params.parentId}}'\n          },\n          {\n            id: 'child-2',\n            parentId: '{{request.params.parentId}}'\n          }\n        ]\n      },\n      endpoints: [\n        {\n          id: 'health',\n          method: 'GET',\n          path: '/health',\n          behavior: {\n            type: 'fixed',\n            response: {\n              status: 200,\n              body: { status: 'ok' }\n            }\n          }\n        },\n        {\n          id: 'list-children',\n          method: 'GET',\n          path: '/parents/:parentId/children',\n          behavior: {\n            type: 'relative',\n            response: {\n              body: {\n                parentId: '{{request.params.parentId}}',\n                items: '{{data.children}}'\n              }\n            }\n          }\n        },\n        {\n          id: 'calculate-score',\n          method: 'POST',\n          path: '/score',\n          behavior: {\n            type: 'simulation',\n            handler: ({ request }) => {\n              const values = (request.body as { values: number[] }).values;\n              return {\n                body: {\n                  score: values.reduce((sum, value) => sum + value, 0)\n                }\n              };\n            }\n          }\n        }\n      ]\n    }\n  ]\n});\n```\n\n---\n\n## From: Overview — 4. Where to go next\n\n- Try the **Playground** app (anonymous, ~30-second first dispatch).\n- Author projects in **Studio** (local-first).\n- Follow [`examples/library-demo/TUTORIAL.md`](../../../examples/library-demo/TUTORIAL.md) for a guided REST walkthrough.\n- Or [`examples/flowstate-simulator/TUTORIAL.md`](../../../examples/flowstate-simulator/TUTORIAL.md) to compose with `@x12i/static-memorix`.\n- Use cases: `orient-simulator`, `define-three-behaviors`, `ship-package-simulator`.\n\n## Also see\n\n- **Overview** (`00-overview`) — Install, a minimal three-behavior example, and where to go next.\n- **Behaviors and Dispatch** (`01-behaviors`) — The three endpoint behaviors, dispatch APIs, contracts, latency, raw bodies, and path patterns.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "downloads/use-cases/run-playground-studio.md": "# Run Playground and Studio\n\n> **Use case id:** `run-playground-studio`\n> **Goal:** Start the local UI apps, know the port map, and understand the product rule.\n> **Audiences:** developers\n> **Tags:** ui, playground, studio\n\n## Reading path\n\n1. **Playground and Studio** (developers) → chapters: `1-two-surfaces`, `2-run-locally`, `3-ports`, `4-product-rule`\n\n## From: Playground and Studio — 1. Two surfaces\n\nTwo separate UI apps over `@x12i/api-simulator`. They are **not** one merged workspace.\n\n| Surface | Job | Mindset |\n|---|---|---|\n| Playground (`apps/playground`) | Try a request in ~30 seconds | Ephemeral, session-only |\n| Studio (`apps/studio`) | Author and own a simulator | Persistent (IndexedDB), exportable |\n\nPlayground **Open in Studio** hands off the current definition via `sessionStorage`.\n\n---\n\n## From: Playground and Studio — 2. Run locally\n\nFrom the repo root (after `npm install` and `npm run build`):\n\n```bash\nnpm run build\nnpm run dev -w @x12i/playground   # http://127.0.0.1:5523\nnpm run dev -w @x12i/studio       # http://127.0.0.1:5521\n```\n\nOr use the root aliases: `npm run dev:playground` / `npm run dev:studio`.\n\n---\n\n## From: Playground and Studio — 3. Ports\n\nPorts come from [`@x12i/ports-manager`](https://www.npmjs.com/package/@x12i/ports-manager) zone **`api-simulator`** (5520–5539, even = API, odd = UI). Wrapper: [`scripts/api-simulator-ports.mjs`](../../../scripts/api-simulator-ports.mjs).\n\n| Name | Port | Role |\n|------|------|------|\n| `api` / library-demo / codegen | 5520 | API |\n| `studio` (Vite) | 5521 | UI |\n| `flowstate` compose server | 5522 | API |\n| `playground` (Vite) | 5523 | UI |\n\n```bash\nnpx x12i-ports zone api-simulator\n```\n\n**UI apps vs API processes:** Playground and Studio are Vite **UI** processes (odd ports). They do not need `@x12i/core-service` `/_live`. Example **API** processes that bind even ports (library-demo, FlowState compose, `node-server`) use `@x12i/core-service` for `/health` and `/_live` — see [Adapters — HTTP process compliance](../02-adapters/developers/BOOK.md#2-http-process-compliance-local-services).\n\n---\n\n## From: Playground and Studio — 4. Product rule\n\nBoth apps edit a UI model that maps to `SimulatorDefinition` / endpoint behaviors. The library remains the API of record; the UIs generate and preview — they do not invent a parallel DSL.\n\n---\n\n## Also see\n\n- **Playground and Studio** (`04-playground-studio`) — Two UI apps over the same library: ephemeral Playground and local-first Studio.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
+    "downloads/use-cases/ship-package-simulator.md": "# Ship a package simulator\n\n> **Use case id:** `ship-package-simulator`\n> **Goal:** Structure a product-owned package with logic, data, optional static-memorix composition, and core-service on the HTTP entry.\n> **Audiences:** developers\n> **Tags:** packages, memorix, core-service\n\n## Reading path\n\n1. **Package Simulators** (developers) → chapters: `1-what-a-package-simulator-is`, `2-recommended-structure`, `4-with-static-memorix`\n1. **Adapters and Helpers** (developers) → chapters: `2-http-process-compliance-local-services`\n\n## From: Package Simulators — 1. What a package simulator is\n\nA **package simulator** is a small product-owned package that uses `@x12i/api-simulator` as the engine and ships its own:\n\n- **logic** — `simulation` handlers (and optional `createStore` state)\n- **data** — seeds under `api.data` and/or fixture JSON\n- **metadata** — when the product speaks Memorix, declarative packs and explorer fixtures\n\nThe core library stays **zero runtime dependencies** and does not load data or metadata from disk, MongoDB, or HTTP. Your package (or an example like `examples/flowstate-simulator`) owns that.\n\n---\n\n## From: Package Simulators — 2. Recommended structure\n\n```text\nmy-provider-simulator/\n├─ mocks/                    # optional — shared with static-memorix when used\n│  ├─ data/\n│  ├─ metadata/\n│  └─ metadata-packs/\n├─ src/\n│  ├─ data/                  # seeds for api.data / createStore\n│  ├─ simulations/           # package-specific handlers\n│  ├─ api.ts                 # createApiSimulator({ apis: [...] })\n│  ├─ memorix.ts             # optional — buildServer({ MOCKS_DIR })\n│  └─ server.ts              # Node/HTTP entry: core-service + tryDispatch ± forward\n└─ package.json\n```\n\nKeep provider-specific data and simulation logic outside `@x12i/api-simulator`. The core remains the reusable engine.\n\nHTTP entrypoints that bind a port use [`@x12i/core-service`](https://www.npmjs.com/package/@x12i/core-service) (see [Adapters — HTTP process compliance](../02-adapters/developers/BOOK.md#2-http-process-compliance-local-services)). Shared helper in this repo: [`scripts/create-simulator-http.mjs`](../../../scripts/create-simulator-http.mjs).\n\n---\n\n## From: Package Simulators — 4. With static-memorix\n\nFor Memorix Explorer (`/api/explorer/*`) and Metadata (`/api/metadata/*`) parity without MongoDB/Redis, compose [`@x12i/static-memorix`](https://www.npmjs.com/package/@x12i/static-memorix):\n\n1. Keep a shared `mocks/` tree (`data/`, `metadata/`, `metadata-packs/`).\n2. Load seeds into package REST via small helpers (see the FlowState example’s `src/bridge.mjs`).\n3. Run `buildServer()` / `startServer()` with `MOCKS_DIR` pointing at that tree.\n4. Serve one port with `@x12i/core-service`: `tryHandleCore` → `tryDispatch` package routes → forward misses to static-memorix (`inject`).\n\n| Surface | Owner |\n|--------|--------|\n| `/health`, `/_live` | `@x12i/core-service` (zone `api-simulator`) |\n| `/api/v1/<your-product>/*` | `@x12i/api-simulator` endpoints in your package |\n| `/api/explorer/*`, `/api/metadata/*` | `@x12i/static-memorix` (`MOCKS_DIR` → shared `mocks/`) |\n\n**Org scope:** `x-memorix-org-id` may be sent for client realism; it is a **no-op for isolation** in this simulator (not `memorix-service`).\n\nstatic-memorix is not a substitute for full `memorix-service` (pipelines, relationship materialize, abstract reverse-write, etc.).\n\n---\n\n## From: Adapters and Helpers — 2. HTTP process compliance (local services)\n\nAny example or package simulator that **binds an HTTP port** should use [`@x12i/core-service`](https://www.npmjs.com/package/@x12i/core-service) (pulls `@x12i/api-live-view`; uses `@x12i/ports-manager`).\n\nProduct contract (current **`@x12i/memorix-docs`**, not old memorix-ebooks):\n\n- Use case **`http-process-compliance`**\n- Building Services (developers) → **HTTP process compliance (local services)**\n- Deep reference: package READMEs for `core-service`, `ports-manager`, `api-live-view`\n\nThis repo applies that contract in zone **`api-simulator` (5520–5539)** — not Memorix’s 5100–5119.\n\n| Surface | Role |\n|--------|------|\n| Port from zone map | `scripts/api-simulator-ports.mjs` / `createSimulatorHttp` |\n| `GET /health` | Process liveness |\n| `/_live` | In-process request rings (api-live-view) |\n| `x-correlation-id` | Request/response correlation |\n| Startup banner | origin · health · live · docs |\n\nShared helper:\n\n```js\nimport { createSimulatorHttp } from '../../scripts/create-simulator-http.mjs';\n\nconst { core, announce } = createSimulatorHttp({\n  id: 'my-simulator',\n  title: 'My package simulator',\n  portKey: 'api', // or flowstate / libraryDemo\n  portEnv: 'API_SIMULATOR_API_PORT'\n});\n\nconst server = createServer(async (req, res) => {\n  if (await core.tryHandleCore(req, res)) return;\n  await createNodeHttpHandler(simulator)(req, res);\n});\n\nawait announce(server);\n```\n\nPublished `@x12i/api-simulator` stays **zero runtime dependencies**. Remote *clients* do not install these kits; *servers that bind* do.\n\n---\n\n## Also see\n\n- **Package Simulators** (`03-package-simulators`) — Ship logic, data, and optional Memorix fixtures in a product package — with or without static-memorix.\n- **Adapters and Helpers** (`02-adapters`) — Expose simulators over HTTP, compose helpers, and plug into Express, Fastify, or fetch runtimes.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n"
+};
+//# sourceMappingURL=bundle.js.map

package/dist/generated/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../src/generated/bundle.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { catalog, useCases, site, manifest, files } from "./generated/bundle.js";
+/** Pre-wired api-simulator knowledge SDK. Install as a **devDependency** only. */
+export declare const apiSimulatorDocs: import("@x12i/docify-sdk").EbooksSdk;
+export { catalog, useCases, site, manifest, files };
+export default apiSimulatorDocs;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEjF,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,sCAM3B,CAAC;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACpD,eAAe,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+import { createEbooksSdk } from "@x12i/docify-sdk";
+import { catalog, useCases, site, manifest, files } from "./generated/bundle.js";
+/** Pre-wired api-simulator knowledge SDK. Install as a **devDependency** only. */
+export const apiSimulatorDocs = createEbooksSdk({
+    catalog,
+    useCases,
+    site,
+    manifest,
+    files,
+});
+export { catalog, useCases, site, manifest, files };
+export default apiSimulatorDocs;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEjF,kFAAkF;AAClF,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC;IAC9C,OAAO;IACP,QAAQ;IACR,IAAI;IACJ,QAAQ;IACR,KAAK;CACN,CAAC,CAAC;AAEH,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACpD,eAAe,gBAAgB,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@x12i/api-simulator-docs",
+  "version": "0.1.1",
+  "description": "api-simulator docs knowledge SDK — install as a devDependency only. Catalog, use cases, and markdown packs for humans and agents.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "api-simulator-docs": "bin/api-simulator-docs.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "scripts": {
+    "prebuild": "node -e \"import('node:fs').then(fs=>fs.rmSync('dist',{recursive:true,force:true}))\"",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@x12i/docify-core": "^1.0.1",
+    "@x12i/docify-sdk": "^1.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.0",
+    "typescript": "^5.8.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "x12i",
+    "api-simulator",
+    "docs",
+    "knowledge",
+    "devDependency"
+  ],
+  "license": "MIT"
+}