diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 8c686379..f0f91035 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -13,6 +13,17 @@ jobs:
         with:
           ruby-version: 3.2.2
           bundler-cache: true
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
       - name: Build Slate
         run: |
           ./deploy.sh -v --source-only
+      - name: Validate LLM artifacts
+        run: |
+          test -f build/docs.jsonl && echo '✓ docs.jsonl exists' || exit 1
+          test -f build/docs-index.json && echo '✓ docs-index.json exists' || exit 1
+          test -f build/llms.txt && echo '✓ llms.txt exists' || exit 1
+          node -e "require('fs').readFileSync('build/docs.jsonl','utf8').trim().split('\n').forEach((l,i)=>{JSON.parse(l)});console.log('✓ docs.jsonl is valid NDJSON')"
+          node -e "JSON.parse(require('fs').readFileSync('build/docs-index.json','utf8'));console.log('✓ docs-index.json is valid JSON');"
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
index 8a4edf20..99428e41 100644
--- a/.github/workflows/publish.yml
+++ b/.github/workflows/publish.yml
@@ -15,6 +15,10 @@ jobs:
         with:
           ruby-version: 3.2.2
           bundler-cache: true
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
       - name: Setup git user
         run: |
           git config --global user.email "contact@killbill.io"
diff --git a/.gitignore b/.gitignore
index 447df206..3485ff36 100644
--- a/.gitignore
+++ b/.gitignore
@@ -17,6 +17,7 @@ build/
 .vagrant
 .sass-cache
 .env
+node_modules/
 # YARD artifacts
 .yardoc
 _yardoc
diff --git a/README.md b/README.md
index c99a2b29..37ee1823 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,70 @@ Kill Bill API documentation.
 
 The site is built using [Middleman](https://github.com/middleman/middleman). See also https://github.com/slatedocs/slate.
 
+## Accessing Kill Bill Docs from AI Assistants (MCP)
+
+Kill Bill provides a **Model Context Protocol (MCP) server** that allows AI assistants to retrieve accurate, up-to-date documentation directly from our official docs corpus.
+
+Instead of relying on potentially outdated training data or web scraping, MCP enables assistants to search and fetch documentation through a deterministic API.
+
+This results in:
+
+- more accurate answers
+- fewer hallucinations
+- version-aware documentation retrieval
+- better code generation and testing workflows
+
+---
+
+### Server Information
+
+The Kill Bill MCP server is hosted privately and backed by the same artifacts used to generate this documentation site.
+
+**Endpoint**
+
+```
+
+[https://apidocs-mcp.killbill.io](https://apidocs-mcp.killbill.io)
+
+````
+
+**Available tools**
+
+| Tool | Description |
+|--------|-------------|
+| `searchDocs` | Finds relevant documentation sections |
+| `fetchDoc` | Retrieves the full content of a section |
+
+The server is read-only and optimized for fast retrieval.
+
+---
+
+### Example: Claude Desktop Configuration
+
+Add the server to your Claude MCP configuration:
+
+```json
+{
+  "mcpServers": {
+    "killbill-docs": {
+      "command": "npx",
+      "args": [
+        "mcp-remote",
+        "https://apidocs-mcp.killbill.io"
+      ]
+    }
+  }
+}
+````
+
+After restarting Claude, you can ask questions like:
+
+> "How do I create a subscription in Kill Bill?"
+> "Show me an example catalog."
+> "Explain invoice generation flow."
+
+Claude will automatically pull from the official docs.
+
 ## Edit and Syntax
 
 The documentation is in the `source/includes` directory.
@@ -36,3 +100,61 @@ Notes:
 * The generated static pages under `build` are deployed by Cloudflare (https://apidocs.killbill.io/)
 * The built pages are also pushed to the `gh-pages` branch for debugging (served by GitHub pages at https://killbill.github.io/slate/ for backward compatibility)
 * Minification of assets is handled by Cloudflare (check-in the unminified version)
+
+## LLM Artifacts
+
+The build generates machine-consumable artifacts for LLM retrieval and MCP servers. These are produced automatically during the normal build process and deployed alongside the HTML site.
+
+| File | Purpose | Format |
+|------|---------|--------|
+| [`docs.jsonl`](https://apidocs.killbill.io/docs.jsonl) | Retrieval corpus — chunked by heading | Newline-delimited JSON |
+| [`docs-index.json`](https://apidocs.killbill.io/docs-index.json) | Lightweight search pre-filter | JSON array |
+| [`llms.txt`](https://apidocs.killbill.io/llms.txt) | Machine-readable site descriptor | Plain text |
+
+### Chunk Schema (`docs.jsonl`)
+
+Each line is a JSON object representing one retrieval chunk:
+
+```json
+{
+  "id": "catalog-upload-a-catalog-as-xml",
+  "title": "Upload a catalog as XML",
+  "url": "https://apidocs.killbill.io/catalog.html#upload-a-catalog-as-xml",
+  "section": "Catalog",
+  "version": "latest",
+  "headings": ["Catalog", "Catalog", "Upload a catalog as XML"],
+  "content": "...clean markdown...",
+  "keywords": ["catalog", "upload", "xml"],
+  "lastUpdated": "2026-02-12"
+}
+```
+
+Chunks are split on H2/H3 boundaries, targeting 400–1200 tokens. Code blocks and tables are never split.
+
+### Search Index Schema (`docs-index.json`)
+
+```json
+{
+  "id": "...",
+  "title": "...",
+  "url": "...",
+  "keywords": [],
+  "summary": "1-2 sentence description",
+  "headings": []
+}
+```
+
+### Generating locally
+
+```
+bundle exec middleman build --clean
+npm ci
+node scripts/generate-llm-artifacts.js
+```
+
+### Configuration
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `BASE_URL` | `https://apidocs.killbill.io` | Canonical site URL for absolute links |
+| `VERSION` | `latest` | Version string embedded in every chunk |
diff --git a/cloudflare_deploy.sh b/cloudflare_deploy.sh
index 21f0803e..c6a3afa4 100755
--- a/cloudflare_deploy.sh
+++ b/cloudflare_deploy.sh
@@ -6,5 +6,5 @@ then
   bundle exec middleman build
 else
   mkdir build
-  mv fonts images javascripts stylesheets *.html build/
+  mv fonts images javascripts stylesheets *.html docs.jsonl docs-index.json llms.txt build/
 fi
diff --git a/deploy.sh b/deploy.sh
index d0bdffb0..d01e3098 100755
--- a/deploy.sh
+++ b/deploy.sh
@@ -26,6 +26,11 @@ run_build() {
   else
     bundle exec middleman build --clean
   fi
+
+  # Generate LLM artifacts (docs.jsonl, docs-index.json, llms.txt)
+  npm ci --ignore-scripts
+  node scripts/generate-llm-artifacts.js
+
   # Add script for Cloudflare
   cp -f cloudflare_deploy.sh build/
 }
diff --git a/package-lock.json b/package-lock.json
new file mode 100644
index 00000000..4124ce22
--- /dev/null
+++ b/package-lock.json
@@ -0,0 +1,888 @@
+{
+  "name": "killbill-slate-llm-artifacts",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "killbill-slate-llm-artifacts",
+      "version": "1.0.0",
+      "dependencies": {
+        "gray-matter": "4.0.3",
+        "mdast-util-to-string": "3.2.0",
+        "remark-parse": "10.0.2",
+        "unified": "10.1.2"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@types/debug": {
+      "version": "4.1.12",
+      "resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.12.tgz",
+      "integrity": "sha512-vIChWdVG3LG1SMxEvI/AK+FWJthlrqlTu7fbrlywTkkaONwk/UAGaULXRlf8vkzFBLVm0zkMdCquhL5aOjhXPQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/ms": "*"
+      }
+    },
+    "node_modules/@types/mdast": {
+      "version": "3.0.15",
+      "resolved": "https://registry.npmjs.org/@types/mdast/-/mdast-3.0.15.tgz",
+      "integrity": "sha512-LnwD+mUEfxWMa1QpDraczIn6k0Ee3SMicuYSSzS6ZYl2gKS09EClnJYGd8Du6rfc5r/GZEk5o1mRb8TaTj03sQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/unist": "^2"
+      }
+    },
+    "node_modules/@types/ms": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz",
+      "integrity": "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==",
+      "license": "MIT"
+    },
+    "node_modules/@types/unist": {
+      "version": "2.0.11",
+      "resolved": "https://registry.npmjs.org/@types/unist/-/unist-2.0.11.tgz",
+      "integrity": "sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==",
+      "license": "MIT"
+    },
+    "node_modules/argparse": {
+      "version": "1.0.10",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
+      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
+      "license": "MIT",
+      "dependencies": {
+        "sprintf-js": "~1.0.2"
+      }
+    },
+    "node_modules/bail": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/bail/-/bail-2.0.2.tgz",
+      "integrity": "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/wooorm"
+      }
+    },
+    "node_modules/character-entities": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/character-entities/-/character-entities-2.0.2.tgz",
+      "integrity": "sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/wooorm"
+      }
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/decode-named-character-reference": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/decode-named-character-reference/-/decode-named-character-reference-1.3.0.tgz",
+      "integrity": "sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q==",
+      "license": "MIT",
+      "dependencies": {
+        "character-entities": "^2.0.0"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/wooorm"
+      }
+    },
+    "node_modules/dequal": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz",
+      "integrity": "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/diff": {
+      "version": "5.2.2",
+      "resolved": "https://registry.npmjs.org/diff/-/diff-5.2.2.tgz",
+      "integrity": "sha512-vtcDfH3TOjP8UekytvnHH1o1P4FcUdt4eQ1Y+Abap1tk/OB2MWQvcwS2ClCd1zuIhc3JKOx6p3kod8Vfys3E+A==",
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.3.1"
+      }
+    },
+    "node_modules/esprima": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
+      "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==",
+      "license": "BSD-2-Clause",
+      "bin": {
+        "esparse": "bin/esparse.js",
+        "esvalidate": "bin/esvalidate.js"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/extend": {
+      "version": "3.0.2",
+      "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz",
+      "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==",
+      "license": "MIT"
+    },
+    "node_modules/extend-shallow": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/extend-shallow/-/extend-shallow-2.0.1.tgz",
+      "integrity": "sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug==",
+      "license": "MIT",
+      "dependencies": {
+        "is-extendable": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/gray-matter": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/gray-matter/-/gray-matter-4.0.3.tgz",
+      "integrity": "sha512-5v6yZd4JK3eMI3FqqCouswVqwugaA9r4dNZB1wwcmrD02QkV5H0y7XBQW8QwQqEaZY1pM9aqORSORhJRdNK44Q==",
+      "license": "MIT",
+      "dependencies": {
+        "js-yaml": "^3.13.1",
+        "kind-of": "^6.0.2",
+        "section-matter": "^1.0.0",
+        "strip-bom-string": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=6.0"
+      }
+    },
+    "node_modules/is-buffer": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/is-buffer/-/is-buffer-2.0.5.tgz",
+      "integrity": "sha512-i2R6zNFDwgEHJyQUtJEk0XFi1i0dPFn/oqjK3/vPCcDeJvW5NQ83V8QbicfF1SupOaB0h8ntgBC2YiE7dfyctQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/is-extendable": {
+      "version": "0.1.1",
+      "resolved": "https://registry.npmjs.org/is-extendable/-/is-extendable-0.1.1.tgz",
+      "integrity": "sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-plain-obj": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-4.1.0.tgz",
+      "integrity": "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/js-yaml": {
+      "version": "3.14.2",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.2.tgz",
+      "integrity": "sha512-PMSmkqxr106Xa156c2M265Z+FTrPl+oxd/rgOQy2tijQeK5TxQ43psO1ZCwhVOSdnn+RzkzlRz/eY4BgJBYVpg==",
+      "license": "MIT",
+      "dependencies": {
+        "argparse": "^1.0.7",
+        "esprima": "^4.0.0"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
+    "node_modules/kind-of": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz",
+      "integrity": "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/kleur": {
+      "version": "4.1.5",
+      "resolved": "https://registry.npmjs.org/kleur/-/kleur-4.1.5.tgz",
+      "integrity": "sha512-o+NO+8WrRiQEE4/7nwRJhN1HWpVmJm511pBHUxPLtp0BUISzlBplORYSmTclCnJvQq2tKu/sgl3xVpkc7ZWuQQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/mdast-util-from-markdown": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/mdast-util-from-markdown/-/mdast-util-from-markdown-1.3.1.tgz",
+      "integrity": "sha512-4xTO/M8c82qBcnQc1tgpNtubGUW/Y1tBQ1B0i5CtSoelOLKFYlElIr3bvgREYYO5iRqbMY1YuqZng0GVOI8Qww==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/mdast": "^3.0.0",
+        "@types/unist": "^2.0.0",
+        "decode-named-character-reference": "^1.0.0",
+        "mdast-util-to-string": "^3.1.0",
+        "micromark": "^3.0.0",
+        "micromark-util-decode-numeric-character-reference": "^1.0.0",
+        "micromark-util-decode-string": "^1.0.0",
+        "micromark-util-normalize-identifier": "^1.0.0",
+        "micromark-util-symbol": "^1.0.0",
+        "micromark-util-types": "^1.0.0",
+        "unist-util-stringify-position": "^3.0.0",
+        "uvu": "^0.5.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/unified"
+      }
+    },
+    "node_modules/mdast-util-to-string": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/mdast-util-to-string/-/mdast-util-to-string-3.2.0.tgz",
+      "integrity": "sha512-V4Zn/ncyN1QNSqSBxTrMOLpjr+IKdHl2v3KVLoWmDPscP4r9GcCi71gjgvUV1SFSKh92AjAG4peFuBl2/YgCJg==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/mdast": "^3.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/unified"
+      }
+    },
+    "node_modules/micromark": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/micromark/-/micromark-3.2.0.tgz",
+      "integrity": "sha512-uD66tJj54JLYq0De10AhWycZWGQNUvDI55xPgk2sQM5kn1JYlhbCMTtEeT27+vAhW2FBQxLlOmS3pmA7/2z4aA==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@types/debug": "^4.0.0",
+        "debug": "^4.0.0",
+        "decode-named-character-reference": "^1.0.0",
+        "micromark-core-commonmark": "^1.0.1",
+        "micromark-factory-space": "^1.0.0",
+        "micromark-util-character": "^1.0.0",
+        "micromark-util-chunked": "^1.0.0",
+        "micromark-util-combine-extensions": "^1.0.0",
+        "micromark-util-decode-numeric-character-reference": "^1.0.0",
+        "micromark-util-encode": "^1.0.0",
+        "micromark-util-normalize-identifier": "^1.0.0",
+        "micromark-util-resolve-all": "^1.0.0",
+        "micromark-util-sanitize-uri": "^1.0.0",
+        "micromark-util-subtokenize": "^1.0.0",
+        "micromark-util-symbol": "^1.0.0",
+        "micromark-util-types": "^1.0.1",
+        "uvu": "^0.5.0"
+      }
+    },
+    "node_modules/micromark-core-commonmark": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-core-commonmark/-/micromark-core-commonmark-1.1.0.tgz",
+      "integrity": "sha512-BgHO1aRbolh2hcrzL2d1La37V0Aoz73ymF8rAcKnohLy93titmv62E0gP8Hrx9PKcKrqCZ1BbLGbP3bEhoXYlw==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "decode-named-character-reference": "^1.0.0",
+        "micromark-factory-destination": "^1.0.0",
+        "micromark-factory-label": "^1.0.0",
+        "micromark-factory-space": "^1.0.0",
+        "micromark-factory-title": "^1.0.0",
+        "micromark-factory-whitespace": "^1.0.0",
+        "micromark-util-character": "^1.0.0",
+        "micromark-util-chunked": "^1.0.0",
+        "micromark-util-classify-character": "^1.0.0",
+        "micromark-util-html-tag-name": "^1.0.0",
+        "micromark-util-normalize-identifier": "^1.0.0",
+        "micromark-util-resolve-all": "^1.0.0",
+        "micromark-util-subtokenize": "^1.0.0",
+        "micromark-util-symbol": "^1.0.0",
+        "micromark-util-types": "^1.0.1",
+        "uvu": "^0.5.0"
+      }
+    },
+    "node_modules/micromark-factory-destination": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-factory-destination/-/micromark-factory-destination-1.1.0.tgz",
+      "integrity": "sha512-XaNDROBgx9SgSChd69pjiGKbV+nfHGDPVYFs5dOoDd7ZnMAE+Cuu91BCpsY8RT2NP9vo/B8pds2VQNCLiu0zhg==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "micromark-util-character": "^1.0.0",
+        "micromark-util-symbol": "^1.0.0",
+        "micromark-util-types": "^1.0.0"
+      }
+    },
+    "node_modules/micromark-factory-label": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-factory-label/-/micromark-factory-label-1.1.0.tgz",
+      "integrity": "sha512-OLtyez4vZo/1NjxGhcpDSbHQ+m0IIGnT8BoPamh+7jVlzLJBH98zzuCoUeMxvM6WsNeh8wx8cKvqLiPHEACn0w==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "micromark-util-character": "^1.0.0",
+        "micromark-util-symbol": "^1.0.0",
+        "micromark-util-types": "^1.0.0",
+        "uvu": "^0.5.0"
+      }
+    },
+    "node_modules/micromark-factory-space": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-factory-space/-/micromark-factory-space-1.1.0.tgz",
+      "integrity": "sha512-cRzEj7c0OL4Mw2v6nwzttyOZe8XY/Z8G0rzmWQZTBi/jjwyw/U4uqKtUORXQrR5bAZZnbTI/feRV/R7hc4jQYQ==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "micromark-util-character": "^1.0.0",
+        "micromark-util-types": "^1.0.0"
+      }
+    },
+    "node_modules/micromark-factory-title": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-factory-title/-/micromark-factory-title-1.1.0.tgz",
+      "integrity": "sha512-J7n9R3vMmgjDOCY8NPw55jiyaQnH5kBdV2/UXCtZIpnHH3P6nHUKaH7XXEYuWwx/xUJcawa8plLBEjMPU24HzQ==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "micromark-factory-space": "^1.0.0",
+        "micromark-util-character": "^1.0.0",
+        "micromark-util-symbol": "^1.0.0",
+        "micromark-util-types": "^1.0.0"
+      }
+    },
+    "node_modules/micromark-factory-whitespace": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-factory-whitespace/-/micromark-factory-whitespace-1.1.0.tgz",
+      "integrity": "sha512-v2WlmiymVSp5oMg+1Q0N1Lxmt6pMhIHD457whWM7/GUlEks1hI9xj5w3zbc4uuMKXGisksZk8DzP2UyGbGqNsQ==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "micromark-factory-space": "^1.0.0",
+        "micromark-util-character": "^1.0.0",
+        "micromark-util-symbol": "^1.0.0",
+        "micromark-util-types": "^1.0.0"
+      }
+    },
+    "node_modules/micromark-util-character": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/micromark-util-character/-/micromark-util-character-1.2.0.tgz",
+      "integrity": "sha512-lXraTwcX3yH/vMDaFWCQJP1uIszLVebzUa3ZHdrgxr7KEU/9mL4mVgCpGbyhvNLNlauROiNUq7WN5u7ndbY6xg==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "micromark-util-symbol": "^1.0.0",
+        "micromark-util-types": "^1.0.0"
+      }
+    },
+    "node_modules/micromark-util-chunked": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-util-chunked/-/micromark-util-chunked-1.1.0.tgz",
+      "integrity": "sha512-Ye01HXpkZPNcV6FiyoW2fGZDUw4Yc7vT0E9Sad83+bEDiCJ1uXu0S3mr8WLpsz3HaG3x2q0HM6CTuPdcZcluFQ==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "micromark-util-symbol": "^1.0.0"
+      }
+    },
+    "node_modules/micromark-util-classify-character": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-util-classify-character/-/micromark-util-classify-character-1.1.0.tgz",
+      "integrity": "sha512-SL0wLxtKSnklKSUplok1WQFoGhUdWYKggKUiqhX+Swala+BtptGCu5iPRc+xvzJ4PXE/hwM3FNXsfEVgoZsWbw==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "micromark-util-character": "^1.0.0",
+        "micromark-util-symbol": "^1.0.0",
+        "micromark-util-types": "^1.0.0"
+      }
+    },
+    "node_modules/micromark-util-combine-extensions": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-util-combine-extensions/-/micromark-util-combine-extensions-1.1.0.tgz",
+      "integrity": "sha512-Q20sp4mfNf9yEqDL50WwuWZHUrCO4fEyeDCnMGmG5Pr0Cz15Uo7KBs6jq+dq0EgX4DPwwrh9m0X+zPV1ypFvUA==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "micromark-util-chunked": "^1.0.0",
+        "micromark-util-types": "^1.0.0"
+      }
+    },
+    "node_modules/micromark-util-decode-numeric-character-reference": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-util-decode-numeric-character-reference/-/micromark-util-decode-numeric-character-reference-1.1.0.tgz",
+      "integrity": "sha512-m9V0ExGv0jB1OT21mrWcuf4QhP46pH1KkfWy9ZEezqHKAxkj4mPCy3nIH1rkbdMlChLHX531eOrymlwyZIf2iw==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "micromark-util-symbol": "^1.0.0"
+      }
+    },
+    "node_modules/micromark-util-decode-string": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-util-decode-string/-/micromark-util-decode-string-1.1.0.tgz",
+      "integrity": "sha512-YphLGCK8gM1tG1bd54azwyrQRjCFcmgj2S2GoJDNnh4vYtnL38JS8M4gpxzOPNyHdNEpheyWXCTnnTDY3N+NVQ==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "decode-named-character-reference": "^1.0.0",
+        "micromark-util-character": "^1.0.0",
+        "micromark-util-decode-numeric-character-reference": "^1.0.0",
+        "micromark-util-symbol": "^1.0.0"
+      }
+    },
+    "node_modules/micromark-util-encode": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-util-encode/-/micromark-util-encode-1.1.0.tgz",
+      "integrity": "sha512-EuEzTWSTAj9PA5GOAs992GzNh2dGQO52UvAbtSOMvXTxv3Criqb6IOzJUBCmEqrrXSblJIJBbFFv6zPxpreiJw==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/micromark-util-html-tag-name": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/micromark-util-html-tag-name/-/micromark-util-html-tag-name-1.2.0.tgz",
+      "integrity": "sha512-VTQzcuQgFUD7yYztuQFKXT49KghjtETQ+Wv/zUjGSGBioZnkA4P1XXZPT1FHeJA6RwRXSF47yvJ1tsJdoxwO+Q==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/micromark-util-normalize-identifier": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-util-normalize-identifier/-/micromark-util-normalize-identifier-1.1.0.tgz",
+      "integrity": "sha512-N+w5vhqrBihhjdpM8+5Xsxy71QWqGn7HYNUvch71iV2PM7+E3uWGox1Qp90loa1ephtCxG2ftRV/Conitc6P2Q==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "micromark-util-symbol": "^1.0.0"
+      }
+    },
+    "node_modules/micromark-util-resolve-all": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-util-resolve-all/-/micromark-util-resolve-all-1.1.0.tgz",
+      "integrity": "sha512-b/G6BTMSg+bX+xVCshPTPyAu2tmA0E4X98NSR7eIbeC6ycCqCeE7wjfDIgzEbkzdEVJXRtOG4FbEm/uGbCRouA==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "micromark-util-types": "^1.0.0"
+      }
+    },
+    "node_modules/micromark-util-sanitize-uri": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/micromark-util-sanitize-uri/-/micromark-util-sanitize-uri-1.2.0.tgz",
+      "integrity": "sha512-QO4GXv0XZfWey4pYFndLUKEAktKkG5kZTdUNaTAkzbuJxn2tNBOr+QtxR2XpWaMhbImT2dPzyLrPXLlPhph34A==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "micromark-util-character": "^1.0.0",
+        "micromark-util-encode": "^1.0.0",
+        "micromark-util-symbol": "^1.0.0"
+      }
+    },
+    "node_modules/micromark-util-subtokenize": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-util-subtokenize/-/micromark-util-subtokenize-1.1.0.tgz",
+      "integrity": "sha512-kUQHyzRoxvZO2PuLzMt2P/dwVsTiivCK8icYTeR+3WgbuPqfHgPPy7nFKbeqRivBvn/3N3GBiNC+JRTMSxEC7A==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "micromark-util-chunked": "^1.0.0",
+        "micromark-util-symbol": "^1.0.0",
+        "micromark-util-types": "^1.0.0",
+        "uvu": "^0.5.0"
+      }
+    },
+    "node_modules/micromark-util-symbol": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-util-symbol/-/micromark-util-symbol-1.1.0.tgz",
+      "integrity": "sha512-uEjpEYY6KMs1g7QfJ2eX1SQEV+ZT4rUD3UcF6l57acZvLNK7PBZL+ty82Z1qhK1/yXIY4bdx04FKMgR0g4IAag==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/micromark-util-types": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/micromark-util-types/-/micromark-util-types-1.1.0.tgz",
+      "integrity": "sha512-ukRBgie8TIAcacscVHSiddHjO4k/q3pnedmzMQ4iwDcK0FtFCohKOlFbaOL/mPgfnPsL3C1ZyxJa4sbWrBl3jg==",
+      "funding": [
+        {
+          "type": "GitHub Sponsors",
+          "url": "https://github.com/sponsors/unifiedjs"
+        },
+        {
+          "type": "OpenCollective",
+          "url": "https://opencollective.com/unified"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/mri": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/mri/-/mri-1.2.0.tgz",
+      "integrity": "sha512-tzzskb3bG8LvYGFF/mDTpq3jpI6Q9wc3LEmBaghu+DdCssd1FakN7Bc0hVNmEyGq1bq3RgfkCb3cmQLpNPOroA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "license": "MIT"
+    },
+    "node_modules/remark-parse": {
+      "version": "10.0.2",
+      "resolved": "https://registry.npmjs.org/remark-parse/-/remark-parse-10.0.2.tgz",
+      "integrity": "sha512-3ydxgHa/ZQzG8LvC7jTXccARYDcRld3VfcgIIFs7bI6vbRSxJJmzgLEIIoYKyrfhaY+ujuWaf/PJiMZXoiCXgw==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/mdast": "^3.0.0",
+        "mdast-util-from-markdown": "^1.0.0",
+        "unified": "^10.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/unified"
+      }
+    },
+    "node_modules/sade": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/sade/-/sade-1.8.1.tgz",
+      "integrity": "sha512-xal3CZX1Xlo/k4ApwCFrHVACi9fBqJ7V+mwhBsuf/1IOKbBy098Fex+Wa/5QMubw09pSZ/u8EY8PWgevJsXp1A==",
+      "license": "MIT",
+      "dependencies": {
+        "mri": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/section-matter": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/section-matter/-/section-matter-1.0.0.tgz",
+      "integrity": "sha512-vfD3pmTzGpufjScBh50YHKzEu2lxBWhVEHsNGoEXmCmn2hKGfeNLYMzCJpe8cD7gqX7TJluOVpBkAequ6dgMmA==",
+      "license": "MIT",
+      "dependencies": {
+        "extend-shallow": "^2.0.1",
+        "kind-of": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/sprintf-js": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
+      "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==",
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/strip-bom-string": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/strip-bom-string/-/strip-bom-string-1.0.0.tgz",
+      "integrity": "sha512-uCC2VHvQRYu+lMh4My/sFNmF2klFymLX1wHJeXnbEJERpV/ZsVuonzerjfrGpIGF7LBVa1O7i9kjiWvJiFck8g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/trough": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/trough/-/trough-2.2.0.tgz",
+      "integrity": "sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==",
+      "license": "MIT",
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/wooorm"
+      }
+    },
+    "node_modules/unified": {
+      "version": "10.1.2",
+      "resolved": "https://registry.npmjs.org/unified/-/unified-10.1.2.tgz",
+      "integrity": "sha512-pUSWAi/RAnVy1Pif2kAoeWNBa3JVrx0MId2LASj8G+7AiHWoKZNTomq6LG326T68U7/e263X6fTdcXIy7XnF7Q==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/unist": "^2.0.0",
+        "bail": "^2.0.0",
+        "extend": "^3.0.0",
+        "is-buffer": "^2.0.0",
+        "is-plain-obj": "^4.0.0",
+        "trough": "^2.0.0",
+        "vfile": "^5.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/unified"
+      }
+    },
+    "node_modules/unist-util-stringify-position": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/unist-util-stringify-position/-/unist-util-stringify-position-3.0.3.tgz",
+      "integrity": "sha512-k5GzIBZ/QatR8N5X2y+drfpWG8IDBzdnVj6OInRNWm1oXrzydiaAT2OQiA8DPRRZyAKb9b6I2a6PxYklZD0gKg==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/unist": "^2.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/unified"
+      }
+    },
+    "node_modules/uvu": {
+      "version": "0.5.6",
+      "resolved": "https://registry.npmjs.org/uvu/-/uvu-0.5.6.tgz",
+      "integrity": "sha512-+g8ENReyr8YsOc6fv/NVJs2vFdHBnBNdfE49rshrTzDWOlUx4Gq7KOS2GD8eqhy2j+Ejq29+SbKH8yjkAqXqoA==",
+      "license": "MIT",
+      "dependencies": {
+        "dequal": "^2.0.0",
+        "diff": "^5.0.0",
+        "kleur": "^4.0.3",
+        "sade": "^1.7.3"
+      },
+      "bin": {
+        "uvu": "bin.js"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/vfile": {
+      "version": "5.3.7",
+      "resolved": "https://registry.npmjs.org/vfile/-/vfile-5.3.7.tgz",
+      "integrity": "sha512-r7qlzkgErKjobAmyNIkkSpizsFPYiUPuJb5pNW1RB4JcYVZhs4lIbVqk8XPk033CV/1z8ss5pkax8SuhGpcG8g==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/unist": "^2.0.0",
+        "is-buffer": "^2.0.0",
+        "unist-util-stringify-position": "^3.0.0",
+        "vfile-message": "^3.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/unified"
+      }
+    },
+    "node_modules/vfile-message": {
+      "version": "3.1.4",
+      "resolved": "https://registry.npmjs.org/vfile-message/-/vfile-message-3.1.4.tgz",
+      "integrity": "sha512-fa0Z6P8HUrQN4BZaX05SIVXic+7kE3b05PWAtPuYP9QLHsLKYR7/AlLW3NtOrpXRLeawpDLMsVkmk5DG0NXgWw==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/unist": "^2.0.0",
+        "unist-util-stringify-position": "^3.0.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/unified"
+      }
+    }
+  }
+}
diff --git a/package.json b/package.json
new file mode 100644
index 00000000..e69f3701
--- /dev/null
+++ b/package.json
@@ -0,0 +1,18 @@
+{
+  "name": "killbill-slate-llm-artifacts",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Build-time LLM artifact generation for Kill Bill API docs",
+  "scripts": {
+    "generate-llm-artifacts": "node scripts/generate-llm-artifacts.js"
+  },
+  "dependencies": {
+    "gray-matter": "4.0.3",
+    "mdast-util-to-string": "3.2.0",
+    "remark-parse": "10.0.2",
+    "unified": "10.1.2"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}
diff --git a/scripts/generate-llm-artifacts.js b/scripts/generate-llm-artifacts.js
new file mode 100644
index 00000000..e04444f7
--- /dev/null
+++ b/scripts/generate-llm-artifacts.js
@@ -0,0 +1,715 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * generate-llm-artifacts.js
+ *
+ * Post-build script that reads Kill Bill Slate source markdown files and
+ * produces machine-consumable artifacts for LLM retrieval and MCP servers:
+ *
+ *   build/docs.jsonl        – chunked retrieval corpus (NDJSON)
+ *   build/docs-index.json   – lightweight search index
+ *   build/llms.txt          – machine-readable site descriptor
+ *
+ * Usage:
+ *   node scripts/generate-llm-artifacts.js
+ *
+ * Environment:
+ *   BASE_URL  – override the canonical site URL (default: https://apidocs.killbill.io)
+ *   VERSION   – override the version string (default: latest)
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { unified } = require('unified');
+const remarkParse = require('remark-parse');
+const { toString } = require('mdast-util-to-string');
+
+// ---------------------------------------------------------------------------
+// Configuration
+// ---------------------------------------------------------------------------
+
+const BASE_URL = (process.env.BASE_URL || 'https://apidocs.killbill.io').replace(/\/+$/, '');
+const VERSION = process.env.VERSION || 'latest';
+const TODAY = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
+
+const SOURCE_DIR = path.resolve(__dirname, '..', 'source');
+const INCLUDES_DIR = path.join(SOURCE_DIR, 'includes');
+const BUILD_DIR = path.resolve(__dirname, '..', 'build');
+
+const TARGET_MIN_TOKENS = 400;
+const TARGET_MAX_TOKENS = 1200;
+const HARD_MAX_TOKENS = 1500;
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/** Rough token estimate: ~4 chars per token for English + code. */
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+
+/** Replicate Slate's heading-id parameterization (see lib/unique_head.rb). */
+function parameterize(text) {
+  return text
+    .toLowerCase()
+    .replace(/[^a-z0-9\s-]/g, '')
+    .replace(/[\s]+/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '');
+}
+
+/** Extract first 1-2 sentences of prose from markdown (skip code, tables, HTML). */
+function extractSummary(markdown, maxLen = 200) {
+  const lines = markdown.split('\n');
+  const prose = [];
+  let inCode = false;
+
+  for (const line of lines) {
+    if (line.startsWith('```')) {
+      inCode = !inCode;
+      continue;
+    }
+    if (inCode) continue;
+    if (line.startsWith('#')) continue;
+    if (line.startsWith('|')) continue;
+    if (line.startsWith('<')) continue;
+    if (line.startsWith('>')) continue;
+    if (line.trim() === '') continue;
+
+    prose.push(line.trim());
+    const joined = prose.join(' ');
+    // Stop after 2 sentences or maxLen
+    const sentences = joined.match(/[.!?]\s/g);
+    if ((sentences && sentences.length >= 2) || joined.length >= maxLen) {
+      return joined.slice(0, maxLen).replace(/\s+$/, '');
+    }
+  }
+  return prose.join(' ').slice(0, maxLen).replace(/\s+$/, '');
+}
+
+/** Convert relative links in markdown to absolute URLs. */
+function absolutifyLinks(markdown, baseUrl) {
+  // [text](relative.html) → [text](BASE_URL/relative.html)
+  // [text](relative.html#anchor) → [text](BASE_URL/relative.html#anchor)
+  return markdown.replace(
+    /\[([^\]]*)\]\((?!https?:\/\/|#|mailto:)([^)]+)\)/g,
+    (match, text, href) => `[${text}](${baseUrl}/${href})`
+  );
+}
+
+/** Strip HTML aside blocks and normalize whitespace. */
+function cleanContent(markdown) {
+  let result = markdown;
+  // Convert <aside> blocks to plain text
+  result = result.replace(
+    /<aside[^>]*>\s*<span[^>]*>([^<]*)<\/span>\s*<span[^>]*>([^<]*)<\/span>\s*<\/aside>/g,
+    (_, label, content) => `**${label.trim()}** ${content.trim()}`
+  );
+  // Remove any remaining HTML tags (but preserve content within)
+  result = result.replace(/<\/?[^>]+>/g, '');
+  // Normalize multiple blank lines
+  result = result.replace(/\n{3,}/g, '\n\n');
+  return result.trim();
+}
+
+/**
+ * Extract keywords from headings, HTTP methods, and identifiable terms.
+ */
+function extractKeywords(headings, content) {
+  const kw = new Set();
+
+  // Words from headings
+  for (const h of headings) {
+    for (const word of h.toLowerCase().split(/\s+/)) {
+      const clean = word.replace(/[^a-z0-9-]/g, '');
+      if (clean.length > 2) kw.add(clean);
+    }
+  }
+
+  // HTTP methods mentioned
+  const methods = content.match(/\b(GET|POST|PUT|DELETE|PATCH)\s+http/gi);
+  if (methods) {
+    for (const m of methods) {
+      kw.add(m.split(/\s/)[0].toLowerCase());
+    }
+  }
+
+  // API path segments
+  const paths = content.match(/\/1\.0\/kb\/([a-z-]+)/gi);
+  if (paths) {
+    for (const p of paths) {
+      const segments = p.split('/').filter(Boolean);
+      for (const s of segments) {
+        if (s.length > 2 && s !== '1.0' && s !== 'kb') kw.add(s.toLowerCase());
+      }
+    }
+  }
+
+  return [...kw].sort();
+}
+
+// ---------------------------------------------------------------------------
+// Source file discovery
+// ---------------------------------------------------------------------------
+
+/**
+ * Discover source markdown files and their page mappings.
+ * Returns array of { page, includeFile, section }.
+ */
+function discoverSources() {
+  const sources = [];
+  const pageFiles = fs.readdirSync(SOURCE_DIR).filter(f => f.endsWith('.html.md'));
+
+  for (const pageFile of pageFiles) {
+    const frontmatterRaw = fs.readFileSync(path.join(SOURCE_DIR, pageFile), 'utf8');
+    const match = frontmatterRaw.match(/^---\n([\s\S]*?)\n---/);
+    if (!match) continue;
+
+    const fm = match[1];
+    // Extract includes list
+    const includesMatch = fm.match(/includes:\s*\n((?:\s+-\s+.+\n?)*)/);
+    if (!includesMatch) continue;
+
+    const includes = includesMatch[1]
+      .split('\n')
+      .map(l => l.replace(/^\s*-\s*/, '').trim())
+      .filter(Boolean);
+
+    // Extract current_page
+    const cpMatch = fm.match(/current_page:\s*(.+)/);
+    const currentPage = cpMatch ? cpMatch[1].trim() : pageFile.replace('.html.md', '');
+
+    for (const inc of includes) {
+      const includeFile = path.join(INCLUDES_DIR, `_${inc}.md`);
+      if (fs.existsSync(includeFile)) {
+        sources.push({
+          page: currentPage,
+          includeFile,
+          section: titleCase(inc.replace(/-/g, ' ').replace(/_/g, ' '))
+        });
+      }
+    }
+  }
+
+  return sources;
+}
+
+function titleCase(str) {
+  return str.replace(/\b\w/g, c => c.toUpperCase());
+}
+
+// ---------------------------------------------------------------------------
+// Markdown chunking
+// ---------------------------------------------------------------------------
+
+/**
+ * Split a markdown string into chunks based on headings.
+ * Primary split: H2. Sub-split on H3 if H2 chunk exceeds TARGET_MAX_TOKENS.
+ * Never splits code blocks or tables.
+ *
+ * Returns array of { depth, title, headings, content }.
+ */
+function chunkMarkdown(markdown, sectionTitle) {
+  const lines = markdown.split('\n');
+  const sections = [];
+  let currentSection = null;
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const headingMatch = line.match(/^(#{1,3})\s+(.+)$/);
+
+    if (headingMatch) {
+      const depth = headingMatch[1].length;
+      const title = headingMatch[2].trim();
+
+      if (currentSection) {
+        sections.push(currentSection);
+      }
+
+      currentSection = {
+        depth,
+        title,
+        headings: depth === 1 ? [title]
+          : depth === 2 ? [sectionTitle, title]
+          : [sectionTitle, null, title], // placeholder for H2 parent
+        contentLines: []
+      };
+    } else {
+      if (!currentSection) {
+        // Content before any heading — create an intro section
+        currentSection = {
+          depth: 0,
+          title: sectionTitle,
+          headings: [sectionTitle],
+          contentLines: []
+        };
+      }
+      currentSection.contentLines.push(line);
+    }
+  }
+
+  if (currentSection) {
+    sections.push(currentSection);
+  }
+
+  // Fill in H2 parent names for H3 sections
+  let lastH2 = sectionTitle;
+  for (const sec of sections) {
+    if (sec.depth <= 2 && sec.depth > 0) {
+      lastH2 = sec.title;
+    }
+    if (sec.depth === 3) {
+      sec.headings[1] = lastH2;
+    }
+    // Remove null placeholders
+    sec.headings = sec.headings.filter(Boolean);
+  }
+
+  // Now merge or split to get good chunk sizes
+  return buildChunks(sections, sectionTitle);
+}
+
+/**
+ * Merge small sections, split oversized ones.
+ * Returns final chunks with content as a single markdown string.
+ */
+function buildChunks(sections, sectionTitle) {
+  const chunks = [];
+  let pendingMerge = null;
+
+  for (let i = 0; i < sections.length; i++) {
+    const sec = sections[i];
+    const content = sec.contentLines.join('\n').trim();
+    const tokens = estimateTokens(content);
+
+    if (tokens === 0 && sec.depth > 0) {
+      // Empty section heading only — will be merged with next
+      if (pendingMerge) {
+        pendingMerge.contentLines.push('', `${'#'.repeat(sec.depth)} ${sec.title}`);
+        pendingMerge.headings = [...new Set([...pendingMerge.headings, ...sec.headings])];
+      } else {
+        pendingMerge = { ...sec };
+      }
+      continue;
+    }
+
+    // If there's a pending small section, try merging
+    if (pendingMerge) {
+      const mergedContent = pendingMerge.contentLines.join('\n').trim()
+        + '\n\n' + `${'#'.repeat(sec.depth)} ${sec.title}` + '\n' + content;
+      const mergedTokens = estimateTokens(mergedContent);
+
+      if (mergedTokens <= TARGET_MAX_TOKENS) {
+        // Merge
+        pendingMerge.contentLines = mergedContent.split('\n');
+        pendingMerge.headings = [...new Set([...pendingMerge.headings, ...sec.headings])];
+        continue;
+      } else {
+        // Flush pending, start fresh
+        const pc = pendingMerge.contentLines.join('\n').trim();
+        if (pc.length > 0) {
+          chunks.push(...finalizeSection(pendingMerge, sectionTitle));
+        }
+        pendingMerge = null;
+      }
+    }
+
+    if (tokens < TARGET_MIN_TOKENS && sec.depth > 0) {
+      // Too small — hold for merging with next
+      pendingMerge = { ...sec, contentLines: [...sec.contentLines] };
+      continue;
+    }
+
+    chunks.push(...finalizeSection(sec, sectionTitle));
+  }
+
+  // Flush any remaining pending
+  if (pendingMerge) {
+    const pc = pendingMerge.contentLines.join('\n').trim();
+    if (pc.length > 0) {
+      chunks.push(...finalizeSection(pendingMerge, sectionTitle));
+    }
+  }
+
+  return chunks;
+}
+
+function finalizeSection(sec, sectionTitle) {
+  const content = sec.contentLines.join('\n').trim();
+  const tokens = estimateTokens(content);
+
+  // If the section is oversized, try to split on code-block boundaries
+  if (tokens > HARD_MAX_TOKENS) {
+    const subChunks = splitOversizedChunk(sec, sectionTitle);
+    if (subChunks.length > 1) return subChunks;
+    // If still oversized after split attempt, return as-is with warning logged upstream
+  }
+
+  return [{
+    depth: sec.depth,
+    title: sec.title,
+    headings: sec.headings,
+    content,
+    tokens
+  }];
+}
+
+/**
+ * Split an oversized section by grouping content between code blocks.
+ * Strategy: split at logical boundaries — before markers like "Example Request",
+ * "Example Response", "**HTTP Request**", or between consecutive code fences.
+ * If a single code block is itself oversized (e.g. huge JSON response), split
+ * between each code block rather than grouping them.
+ */
+function splitOversizedChunk(sec, sectionTitle) {
+  const lines = sec.contentLines;
+  const content = lines.join('\n').trim();
+
+  // Find split points: lines that start a new logical sub-section
+  const splitMarkers = /^(\*\*HTTP Request\*\*|>\s*Example\s+(Request|Response)|>\s*Example|>\s*Response|\*\*Request Body\*\*|\*\*Query Parameters\*\*|\*\*Returns\*\*|\*\*Response\*\*)/i;
+
+  // Segment by: (1) logical markers, and (2) each code block boundary (close → next open)
+  const segments = [];
+  let currentSegment = [];
+  let inCodeBlock = false;
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+
+    if (line.startsWith('```')) {
+      if (inCodeBlock) {
+        // Closing fence — include it in current segment
+        currentSegment.push(lines[i]);
+        inCodeBlock = false;
+        // Always split after closing a code fence (more aggressive)
+        if (currentSegment.length > 0) {
+          segments.push(currentSegment);
+          currentSegment = [];
+        }
+        continue;
+      } else {
+        inCodeBlock = true;
+      }
+    }
+
+    // Split at logical markers (only outside code blocks)
+    if (!inCodeBlock && splitMarkers.test(line) && currentSegment.length > 0) {
+      segments.push(currentSegment);
+      currentSegment = [];
+    }
+
+    currentSegment.push(lines[i]);
+  }
+  if (currentSegment.length > 0) segments.push(currentSegment);
+
+  if (segments.length <= 1) {
+    // Can't split meaningfully — check if content has a large table we can split
+    const tableChunks = splitOnTableBoundary(sec);
+    if (tableChunks.length > 1) return tableChunks;
+
+    return [{
+      depth: sec.depth,
+      title: sec.title,
+      headings: sec.headings,
+      content,
+      tokens: estimateTokens(content)
+    }];
+  }
+
+  // Merge segments into chunks that stay under TARGET_MAX_TOKENS
+  const result = [];
+  let accumLines = [];
+  let partNum = 0;
+
+  for (const seg of segments) {
+    const combined = [...accumLines, ...seg].join('\n').trim();
+    if (estimateTokens(combined) > TARGET_MAX_TOKENS && accumLines.length > 0) {
+      partNum++;
+      const c = accumLines.join('\n').trim();
+      result.push({
+        depth: sec.depth,
+        title: partNum === 1 ? sec.title : `${sec.title} (part ${partNum})`,
+        headings: sec.headings,
+        content: c,
+        tokens: estimateTokens(c)
+      });
+      accumLines = [...seg];
+    } else {
+      accumLines.push(...seg);
+    }
+  }
+
+  if (accumLines.length > 0) {
+    partNum++;
+    const c = accumLines.join('\n').trim();
+    result.push({
+      depth: sec.depth,
+      title: partNum === 1 ? sec.title : `${sec.title} (part ${partNum})`,
+      headings: sec.headings,
+      content: c,
+      tokens: estimateTokens(c)
+    });
+  }
+
+  return result;
+}
+
+/**
+ * Split a section that contains a large table (many rows).
+ * Splits at table row boundaries, keeping the header in each part.
+ */
+function splitOnTableBoundary(sec) {
+  const lines = sec.contentLines;
+  // Find table boundaries: header row | separator | data rows
+  let tableStart = -1;
+  let tableHeaderLines = [];
+
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i].trim();
+    if (line.startsWith('|') && line.endsWith('|')) {
+      if (tableStart === -1) {
+        tableStart = i;
+        tableHeaderLines = [lines[i]];
+        // Next line should be separator
+        if (i + 1 < lines.length && lines[i + 1].trim().match(/^\|[\s:-]+\|/)) {
+          tableHeaderLines.push(lines[i + 1]);
+        }
+      }
+    }
+  }
+
+  if (tableStart === -1) return [sec]; // No table found
+
+  // Split: content before table, then table in parts, then content after
+  const beforeTable = lines.slice(0, tableStart);
+  let tableRows = [];
+  let tableEnd = tableStart;
+  for (let i = tableStart; i < lines.length; i++) {
+    if (lines[i].trim().startsWith('|') && lines[i].trim().endsWith('|')) {
+      tableRows.push(lines[i]);
+      tableEnd = i;
+    } else if (tableRows.length > 0) {
+      break;
+    }
+  }
+  const afterTable = lines.slice(tableEnd + 1);
+
+  // If table is small, don't split
+  const fullContent = lines.join('\n').trim();
+  if (estimateTokens(fullContent) <= HARD_MAX_TOKENS) return [sec];
+
+  // Split table rows (skip header + separator)
+  const dataRows = tableRows.slice(tableHeaderLines.length);
+  const rowsPerPart = Math.ceil(dataRows.length / Math.ceil(estimateTokens(tableRows.join('\n')) / TARGET_MAX_TOKENS));
+
+  const results = [];
+  let partNum = 0;
+
+  // Before-table content as its own chunk if substantial
+  if (beforeTable.join('\n').trim().length > 0) {
+    partNum++;
+    const c = beforeTable.join('\n').trim();
+    results.push({
+      depth: sec.depth,
+      title: sec.title,
+      headings: sec.headings,
+      content: c,
+      tokens: estimateTokens(c)
+    });
+  }
+
+  // Table parts
+  for (let i = 0; i < dataRows.length; i += rowsPerPart) {
+    partNum++;
+    const partRows = dataRows.slice(i, i + rowsPerPart);
+    const tableChunk = [...tableHeaderLines, ...partRows].join('\n');
+    results.push({
+      depth: sec.depth,
+      title: `${sec.title} (table part ${partNum})`,
+      headings: sec.headings,
+      content: tableChunk,
+      tokens: estimateTokens(tableChunk)
+    });
+  }
+
+  // After-table content
+  if (afterTable.join('\n').trim().length > 0) {
+    partNum++;
+    const c = afterTable.join('\n').trim();
+    results.push({
+      depth: sec.depth,
+      title: `${sec.title} (part ${partNum})`,
+      headings: sec.headings,
+      content: c,
+      tokens: estimateTokens(c)
+    });
+  }
+
+  return results.length > 1 ? results : [sec];
+}
+
+// ---------------------------------------------------------------------------
+// Main pipeline
+// ---------------------------------------------------------------------------
+
+function main() {
+  // Ensure build directory exists
+  if (!fs.existsSync(BUILD_DIR)) {
+    fs.mkdirSync(BUILD_DIR, { recursive: true });
+  }
+
+  const sources = discoverSources();
+  if (sources.length === 0) {
+    console.error('ERROR: No source files discovered in', INCLUDES_DIR);
+    process.exit(1);
+  }
+
+  console.log(`Discovered ${sources.length} source file(s)`);
+
+  const allChunks = [];
+  const usedIds = new Set();
+  let warnings = 0;
+
+  for (const source of sources) {
+    const raw = fs.readFileSync(source.includeFile, 'utf8');
+    const cleaned = cleanContent(raw);
+    const chunks = chunkMarkdown(cleaned, source.section);
+
+    for (const chunk of chunks) {
+      // Generate chunk ID
+      let id = `${source.page}-${parameterize(chunk.title)}`;
+      // Deduplicate IDs
+      if (usedIds.has(id)) {
+        let suffix = 2;
+        while (usedIds.has(`${id}-${suffix}`)) suffix++;
+        id = `${id}-${suffix}`;
+      }
+      usedIds.add(id);
+
+      // Build URL with fragment
+      const fragment = chunk.depth > 0 ? `#${parameterize(chunk.title)}` : '';
+      const url = `${BASE_URL}/${source.page}.html${fragment}`;
+
+      // Absolutify links in content
+      const absoluteContent = absolutifyLinks(chunk.content, BASE_URL);
+
+      // Token check
+      if (chunk.tokens > HARD_MAX_TOKENS) {
+        console.warn(`  WARN: chunk "${id}" is ~${chunk.tokens} tokens (exceeds ${HARD_MAX_TOKENS})`);
+        warnings++;
+      }
+
+      allChunks.push({
+        id,
+        title: chunk.title,
+        url,
+        section: source.section,
+        version: VERSION,
+        headings: chunk.headings,
+        content: absoluteContent,
+        keywords: extractKeywords(chunk.headings, absoluteContent),
+        lastUpdated: TODAY,
+        _tokens: estimateTokens(absoluteContent)
+      });
+    }
+  }
+
+  // --- Emit docs.jsonl ---
+  const jsonlPath = path.join(BUILD_DIR, 'docs.jsonl');
+  const jsonlLines = allChunks.map(c => {
+    // Strip internal _tokens field from output
+    const { _tokens, ...output } = c;
+    return JSON.stringify(output);
+  });
+  fs.writeFileSync(jsonlPath, jsonlLines.join('\n') + '\n', 'utf8');
+
+  // --- Emit docs-index.json ---
+  const indexPath = path.join(BUILD_DIR, 'docs-index.json');
+  const indexEntries = allChunks.map(c => ({
+    id: c.id,
+    title: c.title,
+    url: c.url,
+    keywords: c.keywords,
+    summary: extractSummary(c.content),
+    headings: c.headings
+  }));
+  fs.writeFileSync(indexPath, JSON.stringify(indexEntries, null, 2) + '\n', 'utf8');
+
+  // --- Emit llms.txt ---
+  const llmsTxtPath = path.join(BUILD_DIR, 'llms.txt');
+  const llmsTxt = `# Kill Bill Documentation for AI Systems
+
+Canonical docs:
+${BASE_URL}/
+
+LLM corpus:
+${BASE_URL}/docs.jsonl
+
+Search index:
+${BASE_URL}/docs-index.json
+
+Preferred version:
+${VERSION}
+`;
+  fs.writeFileSync(llmsTxtPath, llmsTxt, 'utf8');
+
+  // --- Summary ---
+  const totalTokens = allChunks.reduce((sum, c) => sum + (c._tokens || 0), 0);
+  const avgTokens = Math.round(totalTokens / allChunks.length);
+  const oversized = allChunks.filter(c => (c._tokens || 0) > HARD_MAX_TOKENS).length;
+
+  console.log('');
+  console.log('=== LLM Artifact Generation Complete ===');
+  console.log(`  Files processed : ${sources.length}`);
+  console.log(`  Chunks generated: ${allChunks.length}`);
+  console.log(`  Avg chunk size  : ~${avgTokens} tokens`);
+  console.log(`  Oversized chunks: ${oversized}`);
+  console.log(`  Warnings        : ${warnings}`);
+  console.log(`  Version         : ${VERSION}`);
+  console.log(`  Base URL        : ${BASE_URL}`);
+  console.log('');
+  console.log(`  ${jsonlPath}`);
+  console.log(`  ${indexPath}`);
+  console.log(`  ${llmsTxtPath}`);
+
+  // --- Validation ---
+  let valid = true;
+
+  // Validate JSONL
+  const jsonlContent = fs.readFileSync(jsonlPath, 'utf8').trim().split('\n');
+  for (let i = 0; i < jsonlContent.length; i++) {
+    try {
+      const obj = JSON.parse(jsonlContent[i]);
+      if (!obj.id || !obj.title || !obj.url || !obj.content) {
+        console.error(`  VALIDATION ERROR: line ${i + 1} missing required fields`);
+        valid = false;
+      }
+    } catch (e) {
+      console.error(`  VALIDATION ERROR: line ${i + 1} is not valid JSON: ${e.message}`);
+      valid = false;
+    }
+  }
+
+  // Validate index
+  try {
+    const idx = JSON.parse(fs.readFileSync(indexPath, 'utf8'));
+    if (!Array.isArray(idx) || idx.length !== allChunks.length) {
+      console.error('  VALIDATION ERROR: docs-index.json entry count mismatch');
+      valid = false;
+    }
+  } catch (e) {
+    console.error(`  VALIDATION ERROR: docs-index.json is not valid JSON: ${e.message}`);
+    valid = false;
+  }
+
+  if (valid) {
+    console.log('\n  ✓ All artifacts validated successfully');
+  } else {
+    console.error('\n  ✗ Validation failed');
+    process.exit(1);
+  }
+}
+
+main();