@x12i/docify 1.1.0 → 1.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -767,7 +767,7 @@ export declare const knowledge: {
|
|
|
767
767
|
export declare const search: {
|
|
768
768
|
readonly version: 1;
|
|
769
769
|
readonly product: "docify";
|
|
770
|
-
readonly generatedAt: "2026-07-
|
|
770
|
+
readonly generatedAt: "2026-07-26T11:12:57.655Z";
|
|
771
771
|
readonly records: readonly [{
|
|
772
772
|
readonly id: "explicit-authoring";
|
|
773
773
|
readonly type: "concept";
|
package/dist/generated/bundle.js
CHANGED
|
@@ -1156,7 +1156,7 @@ export const knowledge = {
|
|
|
1156
1156
|
export const search = {
|
|
1157
1157
|
"version": 1,
|
|
1158
1158
|
"product": "docify",
|
|
1159
|
-
"generatedAt": "2026-07-
|
|
1159
|
+
"generatedAt": "2026-07-26T11:12:57.655Z",
|
|
1160
1160
|
"records": [
|
|
1161
1161
|
{
|
|
1162
1162
|
"id": "explicit-authoring",
|
|
@@ -1700,8 +1700,8 @@ export const files = {
|
|
|
1700
1700
|
"downloads/use-cases/wire-product-library.md": "# Wire a product docs library\n\n> **Use case id:** `wire-product-library`\n> **Goal:** Add books, data/*.json, site-pages, and build scripts in another monorepo without forking theme or web.\n> **Audiences:** developers, builders\n> **Tags:** authoring, getting-started\n\n## Reading path\n\n1. **Authoring a Library** (developers) → chapters: `1-recipe`, `2-content-layout`, `3-data-contracts`, `4-build-pipeline`\n\n## From: Authoring a Library — 1. Recipe\n\n1. Depend on `@x12i/docify-{core,theme,render,export,sdk,web}` — do **not** fork theme or web app.\n2. Author books as `NN-slug/{audience}/BOOK.md`.\n3. Add product data:\n - `data/site.json` — `product`, `brand`, `brandAccent`, `siteUrl`, `knowledgePackage`\n - `data/catalog.json` — roles, families, books (kickers / colors / titles)\n - `data/use-cases.json` — task → book + chapter slugs\n4. Add `site-pages/*.md` with YAML front-matter (`product-home`, `docs-home`, …).\n5. Wire build scripts to import platform packages (see `memorix-docs/scripts/` or `x12i-docify/scripts/`).\n6. Publish `@your-scope/<product>-docs` as a **devDependency** knowledge SDK.\n7. Deploy `dist/web` for humans; ship MD + `agent-manifest.json` for agents.\n\n---\n\n## From: Authoring a Library — 2. Content layout\n\n```\n<product>-docs/\n data/{site,catalog,use-cases}.json\n site-pages/*.md\n NN-slug/\n developers/BOOK.md\n builders/BOOK.md # optional twin\n site-pages/landing.md\n diagrams/ … screenshots/\n packages/<product>-docs/ # published knowledge SDK\n scripts/build-bundle.mjs\n scripts/build-knowledge.mjs\n scripts/docs.mjs\n```\n\n---\n\n## From: Authoring a Library — 3. Data contracts\n\n| File | Owns |\n|---|---|\n| `site.json` | Brand chrome, accent CSS colors, nav, knowledge package name |\n| `catalog.json` | Roles (`developers` \\| `builders`), families, book metadata |\n| `use-cases.json` | Stable use-case ids + reading paths (bookId, audience, chapter slugs) |\n\nChapter slugs are produced by slugifying `##` headings in `BOOK.md`. Broken use-case paths **fail the bundle build**.\n\n---\n\n## From: Authoring a Library — 4. Build pipeline\n\nTypical scripts:\n\n| Script | Job |\n|---|---|\n| `build-bundle.mjs` | `buildContentBundle` → `dist/bundle` + assemble `dist/web` |\n| `build-knowledge.mjs` | Embed downloads + JSON into `packages/<sdk>/src/generated/bundle.ts` |\n| `docs.mjs` | Build if needed, `docify-web serve dist/web`, open browser |\n\nEnv: set `EBOOKS_PDF=0` or `DOCIFY_PDF=0` to skip PDF when `wkhtmltopdf` is unavailable.\n\n---\n\n## Also see\n\n- **Authoring a Library** (`02-authoring`) — Recipe to ship a product docs library: BOOK.md layout, data/*.json, site-pages, and the build pipeline.\n- **Design System** (`05-design`) — Shared theme tokens and surfaces — products change naming and content only.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
|
|
1701
1701
|
"agent/INDEX.md": "# docify — knowledge index\n\nPackage: `@x12i/docify`\n\n## How to choose\n\n- **Concept** — what it is and why it exists\n- **Guide** — bounded task procedure\n- **Scenario** — state + evidence → which path\n- **Use case** — end-to-end outcome\n- **Tutorial** — learn by doing\n- **Decision** — options and recommended default\n- **Reference / API** — exact technical detail\n\n## Manifest and search\n\n- `agent-manifest.json`\n- `SEARCH.json`\n\n## Concepts\n\n- `explicit-authoring` — **Explicit authoring** — Docify only builds knowledge that authors declare — it never discovers product truth from source. — [concepts/explicit-authoring.md](concepts/explicit-authoring.md)\n- `open-markdown` — **Open Markdown baseline** — Every knowledge item ships as readable Markdown plus indexes — the SDK is optional. — [concepts/open-markdown.md](concepts/open-markdown.md)\n- `guide-vs-scenario` — **Guides vs scenarios vs journeys** — Guides are bounded procedures; scenarios branch on state; journeys compose an end-to-end outcome. — [concepts/guide-vs-scenario.md](concepts/guide-vs-scenario.md)\n\n## Guides\n\n- `scaffold-concept` — **Scaffold a concept page** — Create a validated concept with problem, why, and mental model. — [guides/scaffold-concept.md](guides/scaffold-concept.md)\n\n## Scenarios\n\n- `choose-content-type` — **Choose the right Docify content type** — Pick concept, guide, scenario, journey, tutorial, or reference from the reader goal. — [scenarios/choose-content-type.md](scenarios/choose-content-type.md)\n\n## Diagrams\n\n- `docify-dual-audience` — **One library, two consumption surfaces** — Explicitly authored content becomes a human website and an agent knowledge package. — [diagrams/docify-dual-audience.md](diagrams/docify-dual-audience.md)\n\n## Tutorials\n\n_None authored yet._\n",
|
|
1702
1702
|
"INDEX.md": "# docify — knowledge index\n\nPackage: `@x12i/docify`\n\n## How to choose\n\n- **Concept** — what it is and why it exists\n- **Guide** — bounded task procedure\n- **Scenario** — state + evidence → which path\n- **Use case** — end-to-end outcome\n- **Tutorial** — learn by doing\n- **Decision** — options and recommended default\n- **Reference / API** — exact technical detail\n\n## Manifest and search\n\n- `agent-manifest.json`\n- `SEARCH.json`\n\n## Concepts\n\n- `explicit-authoring` — **Explicit authoring** — Docify only builds knowledge that authors declare — it never discovers product truth from source. — [concepts/explicit-authoring.md](concepts/explicit-authoring.md)\n- `open-markdown` — **Open Markdown baseline** — Every knowledge item ships as readable Markdown plus indexes — the SDK is optional. — [concepts/open-markdown.md](concepts/open-markdown.md)\n- `guide-vs-scenario` — **Guides vs scenarios vs journeys** — Guides are bounded procedures; scenarios branch on state; journeys compose an end-to-end outcome. — [concepts/guide-vs-scenario.md](concepts/guide-vs-scenario.md)\n\n## Guides\n\n- `scaffold-concept` — **Scaffold a concept page** — Create a validated concept with problem, why, and mental model. — [guides/scaffold-concept.md](guides/scaffold-concept.md)\n\n## Scenarios\n\n- `choose-content-type` — **Choose the right Docify content type** — Pick concept, guide, scenario, journey, tutorial, or reference from the reader goal. — [scenarios/choose-content-type.md](scenarios/choose-content-type.md)\n\n## Diagrams\n\n- `docify-dual-audience` — **One library, two consumption surfaces** — Explicitly authored content becomes a human website and an agent knowledge package. — [diagrams/docify-dual-audience.md](diagrams/docify-dual-audience.md)\n\n## Tutorials\n\n_None authored yet._\n",
|
|
1703
|
-
"agent/SEARCH.json": "{\n \"version\": 1,\n \"product\": \"docify\",\n \"generatedAt\": \"2026-07-26T10:51:47.660Z\",\n \"records\": [\n {\n \"id\": \"explicit-authoring\",\n \"type\": \"concept\",\n \"title\": \"Explicit authoring\",\n \"summary\": \"Docify only builds knowledge that authors declare — it never discovers product truth from source.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"authoring\",\n \"boundary\"\n ],\n \"goals\": [],\n \"path\": \"concepts/explicit-authoring.md\",\n \"webPath\": \"/concepts/explicit-authoring\",\n \"prerequisites\": [],\n \"related\": [\n \"open-markdown\",\n \"knowledge-relationships\"\n ],\n \"packIds\": [\n \"concept/explicit-authoring\"\n ]\n },\n {\n \"id\": \"open-markdown\",\n \"type\": \"concept\",\n \"title\": \"Open Markdown baseline\",\n \"summary\": \"Every knowledge item ships as readable Markdown plus indexes — the SDK is optional.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\"\n ],\n \"tags\": [\n \"agents\",\n \"packaging\"\n ],\n \"goals\": [],\n \"path\": \"concepts/open-markdown.md\",\n \"webPath\": \"/concepts/open-markdown\",\n \"prerequisites\": [],\n \"related\": [\n \"explicit-authoring\"\n ],\n \"packIds\": [\n \"concept/open-markdown\"\n ]\n },\n {\n \"id\": \"guide-vs-scenario\",\n \"type\": \"concept\",\n \"title\": \"Guides vs scenarios vs journeys\",\n \"summary\": \"Guides are bounded procedures; scenarios branch on state; journeys compose an end-to-end outcome.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"authoring\"\n ],\n \"goals\": [],\n \"path\": \"concepts/guide-vs-scenario.md\",\n \"webPath\": \"/concepts/guide-vs-scenario\",\n \"prerequisites\": [],\n \"related\": [\n \"explicit-authoring\"\n ],\n \"packIds\": [\n \"concept/guide-vs-scenario\"\n ]\n },\n {\n \"id\": \"scaffold-concept\",\n \"type\": \"guide\",\n \"title\": \"Scaffold a concept page\",\n \"summary\": \"Create a validated concept with problem, why, and mental model.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"authoring\"\n ],\n \"goals\": [],\n \"path\": \"guides/scaffold-concept.md\",\n \"webPath\": \"/guides/scaffold-concept\",\n \"prerequisites\": [],\n \"related\": [\n \"explicit-authoring\"\n ],\n \"packIds\": [\n \"guide/scaffold-concept\"\n ]\n },\n {\n \"id\": \"choose-content-type\",\n \"type\": \"scenario\",\n \"title\": \"Choose the right Docify content type\",\n \"summary\": \"Pick concept, guide, scenario, journey, tutorial, or reference from the reader goal.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [],\n \"goals\": [\n \"Which Docify content type fits this goal?\"\n ],\n \"path\": \"scenarios/choose-content-type.md\",\n \"webPath\": \"/scenarios/choose-content-type\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": [\n \"scenario/choose-content-type\"\n ]\n },\n {\n \"id\": \"docify\",\n \"type\": \"glossary\",\n \"title\": \"Docify\",\n \"summary\": \"x12i framework that turns explicitly authored product knowledge into a website and agent package.\",\n \"aliases\": [\n \"x12i-docify\"\n ],\n \"audiences\": [],\n \"tags\": [],\n \"goals\": [],\n \"path\": \"glossary/docify.md\",\n \"prerequisites\": [],\n \"related\": [\n \"explicit-authoring\"\n ],\n \"packIds\": []\n },\n {\n \"id\": \"search-json\",\n \"type\": \"glossary\",\n \"title\": \"SEARCH.json\",\n \"summary\": \"Deterministic local search index over all addressable knowledge items.\",\n \"aliases\": [\n \"search index\"\n ],\n \"audiences\": [],\n \"tags\": [],\n \"goals\": [],\n \"path\": \"glossary/search-json.md\",\n \"prerequisites\": [],\n \"related\": [\n \"open-markdown\"\n ],\n \"packIds\": []\n },\n {\n \"id\": \"docify-dual-audience\",\n \"type\": \"diagram\",\n \"title\": \"One library, two consumption surfaces\",\n \"summary\": \"Explicitly authored content becomes a human website and an agent knowledge package.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"platform\"\n ],\n \"goals\": [],\n \"path\": \"diagrams/docify-dual-audience.md\",\n \"webPath\": \"/diagrams/docify-dual-audience\",\n \"prerequisites\": [],\n \"related\": [\n \"explicit-authoring\",\n \"open-markdown\"\n ],\n \"packIds\": []\n },\n {\n \"id\": \"orient-docify\",\n \"type\": \"use-case\",\n \"title\": \"Orient on x12i-docify\",\n \"summary\": \"Understand the dual-audience platform and where product libraries fit.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"platform\",\n \"start-here\"\n ],\n \"goals\": [\n \"Understand the dual-audience platform and where product libraries fit.\"\n ],\n \"path\": \"use-cases/orient-docify.md\",\n \"webPath\": \"/use-cases#orient-docify\",\n \"prerequisites\": [],\n \"related\": [\n \"00-platform-overview\"\n ],\n \"packIds\": [\n \"use-case/orient-docify\"\n ]\n },\n {\n \"id\": \"map-packages\",\n \"type\": \"use-case\",\n \"title\": \"Map the @x12i/docify-* packages\",\n \"summary\": \"Know which package owns schemas, theme, render, export, SDK, web, and screenshots.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\"\n ],\n \"tags\": [\n \"packages\",\n \"npm\"\n ],\n \"goals\": [\n \"Know which package owns schemas, theme, render, export, SDK, web, and screenshots.\"\n ],\n \"path\": \"use-cases/map-packages.md\",\n \"webPath\": \"/use-cases#map-packages\",\n \"prerequisites\": [],\n \"related\": [\n \"01-packages\"\n ],\n \"packIds\": [\n \"use-case/map-packages\"\n ]\n },\n {\n \"id\": \"wire-product-library\",\n \"type\": \"use-case\",\n \"title\": \"Wire a product docs library\",\n \"summary\": \"Add books, data/*.json, site-pages, and build scripts in another monorepo without forking theme or web.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"authoring\",\n \"getting-started\"\n ],\n \"goals\": [\n \"Add books, data/*.json, site-pages, and build scripts in another monorepo without forking theme or web.\"\n ],\n \"path\": \"use-cases/wire-product-library.md\",\n \"webPath\": \"/use-cases#wire-product-library\",\n \"prerequisites\": [],\n \"related\": [\n \"02-authoring\",\n \"05-design\"\n ],\n \"packIds\": [\n \"use-case/wire-product-library\"\n ]\n },\n {\n \"id\": \"ship-human-site\",\n \"type\": \"use-case\",\n \"title\": \"Ship the human web app\",\n \"summary\": \"Build and serve dist/web with roles, use cases, catalog, and chapter reader.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"humans\",\n \"web\"\n ],\n \"goals\": [\n \"Build and serve dist/web with roles, use cases, catalog, and chapter reader.\"\n ],\n \"path\": \"use-cases/ship-human-site.md\",\n \"webPath\": \"/use-cases#ship-human-site\",\n \"prerequisites\": [],\n \"related\": [\n \"03-for-humans\"\n ],\n \"packIds\": [\n \"use-case/ship-human-site\"\n ]\n },\n {\n \"id\": \"ship-agent-packs\",\n \"type\": \"use-case\",\n \"title\": \"Ship agent markdown and knowledge SDK\",\n \"summary\": \"Export MD packs, agent-manifest.json, and a product @…-docs package for npm i -D.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\"\n ],\n \"tags\": [\n \"agents\",\n \"sdk\"\n ],\n \"goals\": [\n \"Export MD packs, agent-manifest.json, and a product @…-docs package for npm i -D.\"\n ],\n \"path\": \"use-cases/ship-agent-packs.md\",\n \"webPath\": \"/use-cases#ship-agent-packs\",\n \"prerequisites\": [],\n \"related\": [\n \"04-for-agents\"\n ],\n \"packIds\": [\n \"use-case/ship-agent-packs\"\n ]\n },\n {\n \"id\": \"keep-one-design\",\n \"type\": \"use-case\",\n \"title\": \"Keep one design system\",\n \"summary\": \"Change product naming and content only — never fork theme or invent a competing palette.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"design\",\n \"theme\"\n ],\n \"goals\": [\n \"Change product naming and content only — never fork theme or invent a competing palette.\"\n ],\n \"path\": \"use-cases/keep-one-design.md\",\n \"webPath\": \"/use-cases#keep-one-design\",\n \"prerequisites\": [],\n \"related\": [\n \"05-design\"\n ],\n \"packIds\": [\n \"use-case/keep-one-design\"\n ]\n },\n {\n \"id\": \"00-platform-overview\",\n \"type\": \"book\",\n \"title\": \"Platform Overview\",\n \"summary\": \"What x12i-docify is, who it serves, and how product libraries plug in without forking UI.\",\n \"aliases\": [\n \"CASE FILE · DOC-00\"\n ],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"platform\",\n \"start-here\",\n \"overview\"\n ],\n \"goals\": [],\n \"path\": \"books/00-platform-overview/\",\n \"webPath\": \"/books/00-platform-overview\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": []\n },\n {\n \"id\": \"01-packages\",\n \"type\": \"book\",\n \"title\": \"Packages\",\n \"summary\": \"Core, theme, render, export, SDK, web, and screenshots — what each package owns.\",\n \"aliases\": [\n \"CASE FILE · DOC-01\"\n ],\n \"audiences\": [\n \"developers\"\n ],\n \"tags\": [\n \"packages\",\n \"npm\",\n \"platform\"\n ],\n \"goals\": [],\n \"path\": \"books/01-packages/\",\n \"webPath\": \"/books/01-packages\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": []\n },\n {\n \"id\": \"02-authoring\",\n \"type\": \"book\",\n \"title\": \"Authoring a Library\",\n \"summary\": \"Recipe to ship a product docs library: BOOK.md layout, data/*.json, site-pages, and the build pipeline.\",\n \"aliases\": [\n \"CASE FILE · DOC-02\"\n ],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"authoring\",\n \"content\",\n \"getting-started\"\n ],\n \"goals\": [],\n \"path\": \"books/02-authoring/\",\n \"webPath\": \"/books/02-authoring\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": []\n },\n {\n \"id\": \"03-for-humans\",\n \"type\": \"book\",\n \"title\": \"For Humans\",\n \"summary\": \"How people use @x12i/docify-web — roles, use cases, catalog, chapter reader, downloads.\",\n \"aliases\": [\n \"CASE FILE · DOC-03\"\n ],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"humans\",\n \"web\",\n \"reader\"\n ],\n \"goals\": [],\n \"path\": \"books/03-for-humans/\",\n \"webPath\": \"/books/03-for-humans\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": []\n },\n {\n \"id\": \"04-for-agents\",\n \"type\": \"book\",\n \"title\": \"For Agents\",\n \"summary\": \"MD packs, chapter indexes, agent-manifest.json, and createEbooksSdk — install knowledge as a devDependency.\",\n \"aliases\": [\n \"CASE FILE · DOC-04\"\n ],\n \"audiences\": [\n \"developers\"\n ],\n \"tags\": [\n \"agents\",\n \"sdk\",\n \"markdown\"\n ],\n \"goals\": [],\n \"path\": \"books/04-for-agents/\",\n \"webPath\": \"/books/04-for-agents\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": []\n },\n {\n \"id\": \"05-design\",\n \"type\": \"book\",\n \"title\": \"Design System\",\n \"summary\": \"Shared theme tokens and surfaces — products change naming and content only.\",\n \"aliases\": [\n \"CASE FILE · DOC-05\"\n ],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"design\",\n \"theme\",\n \"brand\"\n ],\n \"goals\": [],\n \"path\": \"books/05-design/\",\n \"webPath\": \"/books/05-design\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": []\n },\n {\n \"id\": \"06-getting-started-and-tutorials\",\n \"type\": \"book\",\n \"title\": \"Getting Started & Tutorials\",\n \"summary\": \"Start here — why agents install @x12i/docify as a devDependency, the authoring order, and hands-on tutorials.\",\n \"aliases\": [\n \"CASE FILE · DOC-06\"\n ],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"getting-started\",\n \"tutorials\",\n \"install\",\n \"start-here\"\n ],\n \"goals\": [],\n \"path\": \"books/06-getting-started-and-tutorials/\",\n \"webPath\": \"/books/06-getting-started-and-tutorials\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": []\n }\n ]\n}",
|
|
1704
|
-
"SEARCH.json": "{\"version\":1,\"product\":\"docify\",\"generatedAt\":\"2026-07-26T10:51:47.660Z\",\"records\":[{\"id\":\"explicit-authoring\",\"type\":\"concept\",\"title\":\"Explicit authoring\",\"summary\":\"Docify only builds knowledge that authors declare — it never discovers product truth from source.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"authoring\",\"boundary\"],\"goals\":[],\"path\":\"concepts/explicit-authoring.md\",\"webPath\":\"/concepts/explicit-authoring\",\"prerequisites\":[],\"related\":[\"open-markdown\",\"knowledge-relationships\"],\"packIds\":[\"concept/explicit-authoring\"]},{\"id\":\"open-markdown\",\"type\":\"concept\",\"title\":\"Open Markdown baseline\",\"summary\":\"Every knowledge item ships as readable Markdown plus indexes — the SDK is optional.\",\"aliases\":[],\"audiences\":[\"developers\"],\"tags\":[\"agents\",\"packaging\"],\"goals\":[],\"path\":\"concepts/open-markdown.md\",\"webPath\":\"/concepts/open-markdown\",\"prerequisites\":[],\"related\":[\"explicit-authoring\"],\"packIds\":[\"concept/open-markdown\"]},{\"id\":\"guide-vs-scenario\",\"type\":\"concept\",\"title\":\"Guides vs scenarios vs journeys\",\"summary\":\"Guides are bounded procedures; scenarios branch on state; journeys compose an end-to-end outcome.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"authoring\"],\"goals\":[],\"path\":\"concepts/guide-vs-scenario.md\",\"webPath\":\"/concepts/guide-vs-scenario\",\"prerequisites\":[],\"related\":[\"explicit-authoring\"],\"packIds\":[\"concept/guide-vs-scenario\"]},{\"id\":\"scaffold-concept\",\"type\":\"guide\",\"title\":\"Scaffold a concept page\",\"summary\":\"Create a validated concept with problem, why, and mental model.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"authoring\"],\"goals\":[],\"path\":\"guides/scaffold-concept.md\",\"webPath\":\"/guides/scaffold-concept\",\"prerequisites\":[],\"related\":[\"explicit-authoring\"],\"packIds\":[\"guide/scaffold-concept\"]},{\"id\":\"choose-content-type\",\"type\":\"scenario\",\"title\":\"Choose the right Docify content type\",\"summary\":\"Pick concept, guide, scenario, journey, tutorial, or reference from the reader goal.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[],\"goals\":[\"Which Docify content type fits this goal?\"],\"path\":\"scenarios/choose-content-type.md\",\"webPath\":\"/scenarios/choose-content-type\",\"prerequisites\":[],\"related\":[],\"packIds\":[\"scenario/choose-content-type\"]},{\"id\":\"docify\",\"type\":\"glossary\",\"title\":\"Docify\",\"summary\":\"x12i framework that turns explicitly authored product knowledge into a website and agent package.\",\"aliases\":[\"x12i-docify\"],\"audiences\":[],\"tags\":[],\"goals\":[],\"path\":\"glossary/docify.md\",\"prerequisites\":[],\"related\":[\"explicit-authoring\"],\"packIds\":[]},{\"id\":\"search-json\",\"type\":\"glossary\",\"title\":\"SEARCH.json\",\"summary\":\"Deterministic local search index over all addressable knowledge items.\",\"aliases\":[\"search index\"],\"audiences\":[],\"tags\":[],\"goals\":[],\"path\":\"glossary/search-json.md\",\"prerequisites\":[],\"related\":[\"open-markdown\"],\"packIds\":[]},{\"id\":\"docify-dual-audience\",\"type\":\"diagram\",\"title\":\"One library, two consumption surfaces\",\"summary\":\"Explicitly authored content becomes a human website and an agent knowledge package.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"platform\"],\"goals\":[],\"path\":\"diagrams/docify-dual-audience.md\",\"webPath\":\"/diagrams/docify-dual-audience\",\"prerequisites\":[],\"related\":[\"explicit-authoring\",\"open-markdown\"],\"packIds\":[]},{\"id\":\"orient-docify\",\"type\":\"use-case\",\"title\":\"Orient on x12i-docify\",\"summary\":\"Understand the dual-audience platform and where product libraries fit.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"platform\",\"start-here\"],\"goals\":[\"Understand the dual-audience platform and where product libraries fit.\"],\"path\":\"use-cases/orient-docify.md\",\"webPath\":\"/use-cases#orient-docify\",\"prerequisites\":[],\"related\":[\"00-platform-overview\"],\"packIds\":[\"use-case/orient-docify\"]},{\"id\":\"map-packages\",\"type\":\"use-case\",\"title\":\"Map the @x12i/docify-* packages\",\"summary\":\"Know which package owns schemas, theme, render, export, SDK, web, and screenshots.\",\"aliases\":[],\"audiences\":[\"developers\"],\"tags\":[\"packages\",\"npm\"],\"goals\":[\"Know which package owns schemas, theme, render, export, SDK, web, and screenshots.\"],\"path\":\"use-cases/map-packages.md\",\"webPath\":\"/use-cases#map-packages\",\"prerequisites\":[],\"related\":[\"01-packages\"],\"packIds\":[\"use-case/map-packages\"]},{\"id\":\"wire-product-library\",\"type\":\"use-case\",\"title\":\"Wire a product docs library\",\"summary\":\"Add books, data/*.json, site-pages, and build scripts in another monorepo without forking theme or web.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"authoring\",\"getting-started\"],\"goals\":[\"Add books, data/*.json, site-pages, and build scripts in another monorepo without forking theme or web.\"],\"path\":\"use-cases/wire-product-library.md\",\"webPath\":\"/use-cases#wire-product-library\",\"prerequisites\":[],\"related\":[\"02-authoring\",\"05-design\"],\"packIds\":[\"use-case/wire-product-library\"]},{\"id\":\"ship-human-site\",\"type\":\"use-case\",\"title\":\"Ship the human web app\",\"summary\":\"Build and serve dist/web with roles, use cases, catalog, and chapter reader.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"humans\",\"web\"],\"goals\":[\"Build and serve dist/web with roles, use cases, catalog, and chapter reader.\"],\"path\":\"use-cases/ship-human-site.md\",\"webPath\":\"/use-cases#ship-human-site\",\"prerequisites\":[],\"related\":[\"03-for-humans\"],\"packIds\":[\"use-case/ship-human-site\"]},{\"id\":\"ship-agent-packs\",\"type\":\"use-case\",\"title\":\"Ship agent markdown and knowledge SDK\",\"summary\":\"Export MD packs, agent-manifest.json, and a product @…-docs package for npm i -D.\",\"aliases\":[],\"audiences\":[\"developers\"],\"tags\":[\"agents\",\"sdk\"],\"goals\":[\"Export MD packs, agent-manifest.json, and a product @…-docs package for npm i -D.\"],\"path\":\"use-cases/ship-agent-packs.md\",\"webPath\":\"/use-cases#ship-agent-packs\",\"prerequisites\":[],\"related\":[\"04-for-agents\"],\"packIds\":[\"use-case/ship-agent-packs\"]},{\"id\":\"keep-one-design\",\"type\":\"use-case\",\"title\":\"Keep one design system\",\"summary\":\"Change product naming and content only — never fork theme or invent a competing palette.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"design\",\"theme\"],\"goals\":[\"Change product naming and content only — never fork theme or invent a competing palette.\"],\"path\":\"use-cases/keep-one-design.md\",\"webPath\":\"/use-cases#keep-one-design\",\"prerequisites\":[],\"related\":[\"05-design\"],\"packIds\":[\"use-case/keep-one-design\"]},{\"id\":\"00-platform-overview\",\"type\":\"book\",\"title\":\"Platform Overview\",\"summary\":\"What x12i-docify is, who it serves, and how product libraries plug in without forking UI.\",\"aliases\":[\"CASE FILE · DOC-00\"],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"platform\",\"start-here\",\"overview\"],\"goals\":[],\"path\":\"books/00-platform-overview/\",\"webPath\":\"/books/00-platform-overview\",\"prerequisites\":[],\"related\":[],\"packIds\":[]},{\"id\":\"01-packages\",\"type\":\"book\",\"title\":\"Packages\",\"summary\":\"Core, theme, render, export, SDK, web, and screenshots — what each package owns.\",\"aliases\":[\"CASE FILE · DOC-01\"],\"audiences\":[\"developers\"],\"tags\":[\"packages\",\"npm\",\"platform\"],\"goals\":[],\"path\":\"books/01-packages/\",\"webPath\":\"/books/01-packages\",\"prerequisites\":[],\"related\":[],\"packIds\":[]},{\"id\":\"02-authoring\",\"type\":\"book\",\"title\":\"Authoring a Library\",\"summary\":\"Recipe to ship a product docs library: BOOK.md layout, data/*.json, site-pages, and the build pipeline.\",\"aliases\":[\"CASE FILE · DOC-02\"],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"authoring\",\"content\",\"getting-started\"],\"goals\":[],\"path\":\"books/02-authoring/\",\"webPath\":\"/books/02-authoring\",\"prerequisites\":[],\"related\":[],\"packIds\":[]},{\"id\":\"03-for-humans\",\"type\":\"book\",\"title\":\"For Humans\",\"summary\":\"How people use @x12i/docify-web — roles, use cases, catalog, chapter reader, downloads.\",\"aliases\":[\"CASE FILE · DOC-03\"],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"humans\",\"web\",\"reader\"],\"goals\":[],\"path\":\"books/03-for-humans/\",\"webPath\":\"/books/03-for-humans\",\"prerequisites\":[],\"related\":[],\"packIds\":[]},{\"id\":\"04-for-agents\",\"type\":\"book\",\"title\":\"For Agents\",\"summary\":\"MD packs, chapter indexes, agent-manifest.json, and createEbooksSdk — install knowledge as a devDependency.\",\"aliases\":[\"CASE FILE · DOC-04\"],\"audiences\":[\"developers\"],\"tags\":[\"agents\",\"sdk\",\"markdown\"],\"goals\":[],\"path\":\"books/04-for-agents/\",\"webPath\":\"/books/04-for-agents\",\"prerequisites\":[],\"related\":[],\"packIds\":[]},{\"id\":\"05-design\",\"type\":\"book\",\"title\":\"Design System\",\"summary\":\"Shared theme tokens and surfaces — products change naming and content only.\",\"aliases\":[\"CASE FILE · DOC-05\"],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"design\",\"theme\",\"brand\"],\"goals\":[],\"path\":\"books/05-design/\",\"webPath\":\"/books/05-design\",\"prerequisites\":[],\"related\":[],\"packIds\":[]},{\"id\":\"06-getting-started-and-tutorials\",\"type\":\"book\",\"title\":\"Getting Started & Tutorials\",\"summary\":\"Start here — why agents install @x12i/docify as a devDependency, the authoring order, and hands-on tutorials.\",\"aliases\":[\"CASE FILE · DOC-06\"],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"getting-started\",\"tutorials\",\"install\",\"start-here\"],\"goals\":[],\"path\":\"books/06-getting-started-and-tutorials/\",\"webPath\":\"/books/06-getting-started-and-tutorials\",\"prerequisites\":[],\"related\":[],\"packIds\":[]}]}",
|
|
1703
|
+
"agent/SEARCH.json": "{\n \"version\": 1,\n \"product\": \"docify\",\n \"generatedAt\": \"2026-07-26T11:12:57.655Z\",\n \"records\": [\n {\n \"id\": \"explicit-authoring\",\n \"type\": \"concept\",\n \"title\": \"Explicit authoring\",\n \"summary\": \"Docify only builds knowledge that authors declare — it never discovers product truth from source.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"authoring\",\n \"boundary\"\n ],\n \"goals\": [],\n \"path\": \"concepts/explicit-authoring.md\",\n \"webPath\": \"/concepts/explicit-authoring\",\n \"prerequisites\": [],\n \"related\": [\n \"open-markdown\",\n \"knowledge-relationships\"\n ],\n \"packIds\": [\n \"concept/explicit-authoring\"\n ]\n },\n {\n \"id\": \"open-markdown\",\n \"type\": \"concept\",\n \"title\": \"Open Markdown baseline\",\n \"summary\": \"Every knowledge item ships as readable Markdown plus indexes — the SDK is optional.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\"\n ],\n \"tags\": [\n \"agents\",\n \"packaging\"\n ],\n \"goals\": [],\n \"path\": \"concepts/open-markdown.md\",\n \"webPath\": \"/concepts/open-markdown\",\n \"prerequisites\": [],\n \"related\": [\n \"explicit-authoring\"\n ],\n \"packIds\": [\n \"concept/open-markdown\"\n ]\n },\n {\n \"id\": \"guide-vs-scenario\",\n \"type\": \"concept\",\n \"title\": \"Guides vs scenarios vs journeys\",\n \"summary\": \"Guides are bounded procedures; scenarios branch on state; journeys compose an end-to-end outcome.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"authoring\"\n ],\n \"goals\": [],\n \"path\": \"concepts/guide-vs-scenario.md\",\n \"webPath\": \"/concepts/guide-vs-scenario\",\n \"prerequisites\": [],\n \"related\": [\n \"explicit-authoring\"\n ],\n \"packIds\": [\n \"concept/guide-vs-scenario\"\n ]\n },\n {\n \"id\": \"scaffold-concept\",\n \"type\": \"guide\",\n \"title\": \"Scaffold a concept page\",\n \"summary\": \"Create a validated concept with problem, why, and mental model.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"authoring\"\n ],\n \"goals\": [],\n \"path\": \"guides/scaffold-concept.md\",\n \"webPath\": \"/guides/scaffold-concept\",\n \"prerequisites\": [],\n \"related\": [\n \"explicit-authoring\"\n ],\n \"packIds\": [\n \"guide/scaffold-concept\"\n ]\n },\n {\n \"id\": \"choose-content-type\",\n \"type\": \"scenario\",\n \"title\": \"Choose the right Docify content type\",\n \"summary\": \"Pick concept, guide, scenario, journey, tutorial, or reference from the reader goal.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [],\n \"goals\": [\n \"Which Docify content type fits this goal?\"\n ],\n \"path\": \"scenarios/choose-content-type.md\",\n \"webPath\": \"/scenarios/choose-content-type\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": [\n \"scenario/choose-content-type\"\n ]\n },\n {\n \"id\": \"docify\",\n \"type\": \"glossary\",\n \"title\": \"Docify\",\n \"summary\": \"x12i framework that turns explicitly authored product knowledge into a website and agent package.\",\n \"aliases\": [\n \"x12i-docify\"\n ],\n \"audiences\": [],\n \"tags\": [],\n \"goals\": [],\n \"path\": \"glossary/docify.md\",\n \"prerequisites\": [],\n \"related\": [\n \"explicit-authoring\"\n ],\n \"packIds\": []\n },\n {\n \"id\": \"search-json\",\n \"type\": \"glossary\",\n \"title\": \"SEARCH.json\",\n \"summary\": \"Deterministic local search index over all addressable knowledge items.\",\n \"aliases\": [\n \"search index\"\n ],\n \"audiences\": [],\n \"tags\": [],\n \"goals\": [],\n \"path\": \"glossary/search-json.md\",\n \"prerequisites\": [],\n \"related\": [\n \"open-markdown\"\n ],\n \"packIds\": []\n },\n {\n \"id\": \"docify-dual-audience\",\n \"type\": \"diagram\",\n \"title\": \"One library, two consumption surfaces\",\n \"summary\": \"Explicitly authored content becomes a human website and an agent knowledge package.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"platform\"\n ],\n \"goals\": [],\n \"path\": \"diagrams/docify-dual-audience.md\",\n \"webPath\": \"/diagrams/docify-dual-audience\",\n \"prerequisites\": [],\n \"related\": [\n \"explicit-authoring\",\n \"open-markdown\"\n ],\n \"packIds\": []\n },\n {\n \"id\": \"orient-docify\",\n \"type\": \"use-case\",\n \"title\": \"Orient on x12i-docify\",\n \"summary\": \"Understand the dual-audience platform and where product libraries fit.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"platform\",\n \"start-here\"\n ],\n \"goals\": [\n \"Understand the dual-audience platform and where product libraries fit.\"\n ],\n \"path\": \"use-cases/orient-docify.md\",\n \"webPath\": \"/use-cases#orient-docify\",\n \"prerequisites\": [],\n \"related\": [\n \"00-platform-overview\"\n ],\n \"packIds\": [\n \"use-case/orient-docify\"\n ]\n },\n {\n \"id\": \"map-packages\",\n \"type\": \"use-case\",\n \"title\": \"Map the @x12i/docify-* packages\",\n \"summary\": \"Know which package owns schemas, theme, render, export, SDK, web, and screenshots.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\"\n ],\n \"tags\": [\n \"packages\",\n \"npm\"\n ],\n \"goals\": [\n \"Know which package owns schemas, theme, render, export, SDK, web, and screenshots.\"\n ],\n \"path\": \"use-cases/map-packages.md\",\n \"webPath\": \"/use-cases#map-packages\",\n \"prerequisites\": [],\n \"related\": [\n \"01-packages\"\n ],\n \"packIds\": [\n \"use-case/map-packages\"\n ]\n },\n {\n \"id\": \"wire-product-library\",\n \"type\": \"use-case\",\n \"title\": \"Wire a product docs library\",\n \"summary\": \"Add books, data/*.json, site-pages, and build scripts in another monorepo without forking theme or web.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"authoring\",\n \"getting-started\"\n ],\n \"goals\": [\n \"Add books, data/*.json, site-pages, and build scripts in another monorepo without forking theme or web.\"\n ],\n \"path\": \"use-cases/wire-product-library.md\",\n \"webPath\": \"/use-cases#wire-product-library\",\n \"prerequisites\": [],\n \"related\": [\n \"02-authoring\",\n \"05-design\"\n ],\n \"packIds\": [\n \"use-case/wire-product-library\"\n ]\n },\n {\n \"id\": \"ship-human-site\",\n \"type\": \"use-case\",\n \"title\": \"Ship the human web app\",\n \"summary\": \"Build and serve dist/web with roles, use cases, catalog, and chapter reader.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"humans\",\n \"web\"\n ],\n \"goals\": [\n \"Build and serve dist/web with roles, use cases, catalog, and chapter reader.\"\n ],\n \"path\": \"use-cases/ship-human-site.md\",\n \"webPath\": \"/use-cases#ship-human-site\",\n \"prerequisites\": [],\n \"related\": [\n \"03-for-humans\"\n ],\n \"packIds\": [\n \"use-case/ship-human-site\"\n ]\n },\n {\n \"id\": \"ship-agent-packs\",\n \"type\": \"use-case\",\n \"title\": \"Ship agent markdown and knowledge SDK\",\n \"summary\": \"Export MD packs, agent-manifest.json, and a product @…-docs package for npm i -D.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\"\n ],\n \"tags\": [\n \"agents\",\n \"sdk\"\n ],\n \"goals\": [\n \"Export MD packs, agent-manifest.json, and a product @…-docs package for npm i -D.\"\n ],\n \"path\": \"use-cases/ship-agent-packs.md\",\n \"webPath\": \"/use-cases#ship-agent-packs\",\n \"prerequisites\": [],\n \"related\": [\n \"04-for-agents\"\n ],\n \"packIds\": [\n \"use-case/ship-agent-packs\"\n ]\n },\n {\n \"id\": \"keep-one-design\",\n \"type\": \"use-case\",\n \"title\": \"Keep one design system\",\n \"summary\": \"Change product naming and content only — never fork theme or invent a competing palette.\",\n \"aliases\": [],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"design\",\n \"theme\"\n ],\n \"goals\": [\n \"Change product naming and content only — never fork theme or invent a competing palette.\"\n ],\n \"path\": \"use-cases/keep-one-design.md\",\n \"webPath\": \"/use-cases#keep-one-design\",\n \"prerequisites\": [],\n \"related\": [\n \"05-design\"\n ],\n \"packIds\": [\n \"use-case/keep-one-design\"\n ]\n },\n {\n \"id\": \"00-platform-overview\",\n \"type\": \"book\",\n \"title\": \"Platform Overview\",\n \"summary\": \"What x12i-docify is, who it serves, and how product libraries plug in without forking UI.\",\n \"aliases\": [\n \"CASE FILE · DOC-00\"\n ],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"platform\",\n \"start-here\",\n \"overview\"\n ],\n \"goals\": [],\n \"path\": \"books/00-platform-overview/\",\n \"webPath\": \"/books/00-platform-overview\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": []\n },\n {\n \"id\": \"01-packages\",\n \"type\": \"book\",\n \"title\": \"Packages\",\n \"summary\": \"Core, theme, render, export, SDK, web, and screenshots — what each package owns.\",\n \"aliases\": [\n \"CASE FILE · DOC-01\"\n ],\n \"audiences\": [\n \"developers\"\n ],\n \"tags\": [\n \"packages\",\n \"npm\",\n \"platform\"\n ],\n \"goals\": [],\n \"path\": \"books/01-packages/\",\n \"webPath\": \"/books/01-packages\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": []\n },\n {\n \"id\": \"02-authoring\",\n \"type\": \"book\",\n \"title\": \"Authoring a Library\",\n \"summary\": \"Recipe to ship a product docs library: BOOK.md layout, data/*.json, site-pages, and the build pipeline.\",\n \"aliases\": [\n \"CASE FILE · DOC-02\"\n ],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"authoring\",\n \"content\",\n \"getting-started\"\n ],\n \"goals\": [],\n \"path\": \"books/02-authoring/\",\n \"webPath\": \"/books/02-authoring\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": []\n },\n {\n \"id\": \"03-for-humans\",\n \"type\": \"book\",\n \"title\": \"For Humans\",\n \"summary\": \"How people use @x12i/docify-web — roles, use cases, catalog, chapter reader, downloads.\",\n \"aliases\": [\n \"CASE FILE · DOC-03\"\n ],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"humans\",\n \"web\",\n \"reader\"\n ],\n \"goals\": [],\n \"path\": \"books/03-for-humans/\",\n \"webPath\": \"/books/03-for-humans\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": []\n },\n {\n \"id\": \"04-for-agents\",\n \"type\": \"book\",\n \"title\": \"For Agents\",\n \"summary\": \"MD packs, chapter indexes, agent-manifest.json, and createEbooksSdk — install knowledge as a devDependency.\",\n \"aliases\": [\n \"CASE FILE · DOC-04\"\n ],\n \"audiences\": [\n \"developers\"\n ],\n \"tags\": [\n \"agents\",\n \"sdk\",\n \"markdown\"\n ],\n \"goals\": [],\n \"path\": \"books/04-for-agents/\",\n \"webPath\": \"/books/04-for-agents\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": []\n },\n {\n \"id\": \"05-design\",\n \"type\": \"book\",\n \"title\": \"Design System\",\n \"summary\": \"Shared theme tokens and surfaces — products change naming and content only.\",\n \"aliases\": [\n \"CASE FILE · DOC-05\"\n ],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"design\",\n \"theme\",\n \"brand\"\n ],\n \"goals\": [],\n \"path\": \"books/05-design/\",\n \"webPath\": \"/books/05-design\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": []\n },\n {\n \"id\": \"06-getting-started-and-tutorials\",\n \"type\": \"book\",\n \"title\": \"Getting Started & Tutorials\",\n \"summary\": \"Start here — why agents install @x12i/docify as a devDependency, the authoring order, and hands-on tutorials.\",\n \"aliases\": [\n \"CASE FILE · DOC-06\"\n ],\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"tags\": [\n \"getting-started\",\n \"tutorials\",\n \"install\",\n \"start-here\"\n ],\n \"goals\": [],\n \"path\": \"books/06-getting-started-and-tutorials/\",\n \"webPath\": \"/books/06-getting-started-and-tutorials\",\n \"prerequisites\": [],\n \"related\": [],\n \"packIds\": []\n }\n ]\n}",
|
|
1704
|
+
"SEARCH.json": "{\"version\":1,\"product\":\"docify\",\"generatedAt\":\"2026-07-26T11:12:57.655Z\",\"records\":[{\"id\":\"explicit-authoring\",\"type\":\"concept\",\"title\":\"Explicit authoring\",\"summary\":\"Docify only builds knowledge that authors declare — it never discovers product truth from source.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"authoring\",\"boundary\"],\"goals\":[],\"path\":\"concepts/explicit-authoring.md\",\"webPath\":\"/concepts/explicit-authoring\",\"prerequisites\":[],\"related\":[\"open-markdown\",\"knowledge-relationships\"],\"packIds\":[\"concept/explicit-authoring\"]},{\"id\":\"open-markdown\",\"type\":\"concept\",\"title\":\"Open Markdown baseline\",\"summary\":\"Every knowledge item ships as readable Markdown plus indexes — the SDK is optional.\",\"aliases\":[],\"audiences\":[\"developers\"],\"tags\":[\"agents\",\"packaging\"],\"goals\":[],\"path\":\"concepts/open-markdown.md\",\"webPath\":\"/concepts/open-markdown\",\"prerequisites\":[],\"related\":[\"explicit-authoring\"],\"packIds\":[\"concept/open-markdown\"]},{\"id\":\"guide-vs-scenario\",\"type\":\"concept\",\"title\":\"Guides vs scenarios vs journeys\",\"summary\":\"Guides are bounded procedures; scenarios branch on state; journeys compose an end-to-end outcome.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"authoring\"],\"goals\":[],\"path\":\"concepts/guide-vs-scenario.md\",\"webPath\":\"/concepts/guide-vs-scenario\",\"prerequisites\":[],\"related\":[\"explicit-authoring\"],\"packIds\":[\"concept/guide-vs-scenario\"]},{\"id\":\"scaffold-concept\",\"type\":\"guide\",\"title\":\"Scaffold a concept page\",\"summary\":\"Create a validated concept with problem, why, and mental model.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"authoring\"],\"goals\":[],\"path\":\"guides/scaffold-concept.md\",\"webPath\":\"/guides/scaffold-concept\",\"prerequisites\":[],\"related\":[\"explicit-authoring\"],\"packIds\":[\"guide/scaffold-concept\"]},{\"id\":\"choose-content-type\",\"type\":\"scenario\",\"title\":\"Choose the right Docify content type\",\"summary\":\"Pick concept, guide, scenario, journey, tutorial, or reference from the reader goal.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[],\"goals\":[\"Which Docify content type fits this goal?\"],\"path\":\"scenarios/choose-content-type.md\",\"webPath\":\"/scenarios/choose-content-type\",\"prerequisites\":[],\"related\":[],\"packIds\":[\"scenario/choose-content-type\"]},{\"id\":\"docify\",\"type\":\"glossary\",\"title\":\"Docify\",\"summary\":\"x12i framework that turns explicitly authored product knowledge into a website and agent package.\",\"aliases\":[\"x12i-docify\"],\"audiences\":[],\"tags\":[],\"goals\":[],\"path\":\"glossary/docify.md\",\"prerequisites\":[],\"related\":[\"explicit-authoring\"],\"packIds\":[]},{\"id\":\"search-json\",\"type\":\"glossary\",\"title\":\"SEARCH.json\",\"summary\":\"Deterministic local search index over all addressable knowledge items.\",\"aliases\":[\"search index\"],\"audiences\":[],\"tags\":[],\"goals\":[],\"path\":\"glossary/search-json.md\",\"prerequisites\":[],\"related\":[\"open-markdown\"],\"packIds\":[]},{\"id\":\"docify-dual-audience\",\"type\":\"diagram\",\"title\":\"One library, two consumption surfaces\",\"summary\":\"Explicitly authored content becomes a human website and an agent knowledge package.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"platform\"],\"goals\":[],\"path\":\"diagrams/docify-dual-audience.md\",\"webPath\":\"/diagrams/docify-dual-audience\",\"prerequisites\":[],\"related\":[\"explicit-authoring\",\"open-markdown\"],\"packIds\":[]},{\"id\":\"orient-docify\",\"type\":\"use-case\",\"title\":\"Orient on x12i-docify\",\"summary\":\"Understand the dual-audience platform and where product libraries fit.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"platform\",\"start-here\"],\"goals\":[\"Understand the dual-audience platform and where product libraries fit.\"],\"path\":\"use-cases/orient-docify.md\",\"webPath\":\"/use-cases#orient-docify\",\"prerequisites\":[],\"related\":[\"00-platform-overview\"],\"packIds\":[\"use-case/orient-docify\"]},{\"id\":\"map-packages\",\"type\":\"use-case\",\"title\":\"Map the @x12i/docify-* packages\",\"summary\":\"Know which package owns schemas, theme, render, export, SDK, web, and screenshots.\",\"aliases\":[],\"audiences\":[\"developers\"],\"tags\":[\"packages\",\"npm\"],\"goals\":[\"Know which package owns schemas, theme, render, export, SDK, web, and screenshots.\"],\"path\":\"use-cases/map-packages.md\",\"webPath\":\"/use-cases#map-packages\",\"prerequisites\":[],\"related\":[\"01-packages\"],\"packIds\":[\"use-case/map-packages\"]},{\"id\":\"wire-product-library\",\"type\":\"use-case\",\"title\":\"Wire a product docs library\",\"summary\":\"Add books, data/*.json, site-pages, and build scripts in another monorepo without forking theme or web.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"authoring\",\"getting-started\"],\"goals\":[\"Add books, data/*.json, site-pages, and build scripts in another monorepo without forking theme or web.\"],\"path\":\"use-cases/wire-product-library.md\",\"webPath\":\"/use-cases#wire-product-library\",\"prerequisites\":[],\"related\":[\"02-authoring\",\"05-design\"],\"packIds\":[\"use-case/wire-product-library\"]},{\"id\":\"ship-human-site\",\"type\":\"use-case\",\"title\":\"Ship the human web app\",\"summary\":\"Build and serve dist/web with roles, use cases, catalog, and chapter reader.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"humans\",\"web\"],\"goals\":[\"Build and serve dist/web with roles, use cases, catalog, and chapter reader.\"],\"path\":\"use-cases/ship-human-site.md\",\"webPath\":\"/use-cases#ship-human-site\",\"prerequisites\":[],\"related\":[\"03-for-humans\"],\"packIds\":[\"use-case/ship-human-site\"]},{\"id\":\"ship-agent-packs\",\"type\":\"use-case\",\"title\":\"Ship agent markdown and knowledge SDK\",\"summary\":\"Export MD packs, agent-manifest.json, and a product @…-docs package for npm i -D.\",\"aliases\":[],\"audiences\":[\"developers\"],\"tags\":[\"agents\",\"sdk\"],\"goals\":[\"Export MD packs, agent-manifest.json, and a product @…-docs package for npm i -D.\"],\"path\":\"use-cases/ship-agent-packs.md\",\"webPath\":\"/use-cases#ship-agent-packs\",\"prerequisites\":[],\"related\":[\"04-for-agents\"],\"packIds\":[\"use-case/ship-agent-packs\"]},{\"id\":\"keep-one-design\",\"type\":\"use-case\",\"title\":\"Keep one design system\",\"summary\":\"Change product naming and content only — never fork theme or invent a competing palette.\",\"aliases\":[],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"design\",\"theme\"],\"goals\":[\"Change product naming and content only — never fork theme or invent a competing palette.\"],\"path\":\"use-cases/keep-one-design.md\",\"webPath\":\"/use-cases#keep-one-design\",\"prerequisites\":[],\"related\":[\"05-design\"],\"packIds\":[\"use-case/keep-one-design\"]},{\"id\":\"00-platform-overview\",\"type\":\"book\",\"title\":\"Platform Overview\",\"summary\":\"What x12i-docify is, who it serves, and how product libraries plug in without forking UI.\",\"aliases\":[\"CASE FILE · DOC-00\"],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"platform\",\"start-here\",\"overview\"],\"goals\":[],\"path\":\"books/00-platform-overview/\",\"webPath\":\"/books/00-platform-overview\",\"prerequisites\":[],\"related\":[],\"packIds\":[]},{\"id\":\"01-packages\",\"type\":\"book\",\"title\":\"Packages\",\"summary\":\"Core, theme, render, export, SDK, web, and screenshots — what each package owns.\",\"aliases\":[\"CASE FILE · DOC-01\"],\"audiences\":[\"developers\"],\"tags\":[\"packages\",\"npm\",\"platform\"],\"goals\":[],\"path\":\"books/01-packages/\",\"webPath\":\"/books/01-packages\",\"prerequisites\":[],\"related\":[],\"packIds\":[]},{\"id\":\"02-authoring\",\"type\":\"book\",\"title\":\"Authoring a Library\",\"summary\":\"Recipe to ship a product docs library: BOOK.md layout, data/*.json, site-pages, and the build pipeline.\",\"aliases\":[\"CASE FILE · DOC-02\"],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"authoring\",\"content\",\"getting-started\"],\"goals\":[],\"path\":\"books/02-authoring/\",\"webPath\":\"/books/02-authoring\",\"prerequisites\":[],\"related\":[],\"packIds\":[]},{\"id\":\"03-for-humans\",\"type\":\"book\",\"title\":\"For Humans\",\"summary\":\"How people use @x12i/docify-web — roles, use cases, catalog, chapter reader, downloads.\",\"aliases\":[\"CASE FILE · DOC-03\"],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"humans\",\"web\",\"reader\"],\"goals\":[],\"path\":\"books/03-for-humans/\",\"webPath\":\"/books/03-for-humans\",\"prerequisites\":[],\"related\":[],\"packIds\":[]},{\"id\":\"04-for-agents\",\"type\":\"book\",\"title\":\"For Agents\",\"summary\":\"MD packs, chapter indexes, agent-manifest.json, and createEbooksSdk — install knowledge as a devDependency.\",\"aliases\":[\"CASE FILE · DOC-04\"],\"audiences\":[\"developers\"],\"tags\":[\"agents\",\"sdk\",\"markdown\"],\"goals\":[],\"path\":\"books/04-for-agents/\",\"webPath\":\"/books/04-for-agents\",\"prerequisites\":[],\"related\":[],\"packIds\":[]},{\"id\":\"05-design\",\"type\":\"book\",\"title\":\"Design System\",\"summary\":\"Shared theme tokens and surfaces — products change naming and content only.\",\"aliases\":[\"CASE FILE · DOC-05\"],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"design\",\"theme\",\"brand\"],\"goals\":[],\"path\":\"books/05-design/\",\"webPath\":\"/books/05-design\",\"prerequisites\":[],\"related\":[],\"packIds\":[]},{\"id\":\"06-getting-started-and-tutorials\",\"type\":\"book\",\"title\":\"Getting Started & Tutorials\",\"summary\":\"Start here — why agents install @x12i/docify as a devDependency, the authoring order, and hands-on tutorials.\",\"aliases\":[\"CASE FILE · DOC-06\"],\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"getting-started\",\"tutorials\",\"install\",\"start-here\"],\"goals\":[],\"path\":\"books/06-getting-started-and-tutorials/\",\"webPath\":\"/books/06-getting-started-and-tutorials\",\"prerequisites\":[],\"related\":[],\"packIds\":[]}]}",
|
|
1705
1705
|
"agent/agent-manifest.json": "{\n \"version\": 1,\n \"product\": \"docify\",\n \"site\": \"https://docs.docify.x12i.com\",\n \"knowledgePackage\": \"@x12i/docify\",\n \"roles\": [\n \"developers\",\n \"builders\"\n ],\n \"books\": [\n {\n \"id\": \"00-platform-overview\",\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"md\": {\n \"developers\": \"downloads/books/00-platform-overview/developers.md\",\n \"builders\": \"downloads/books/00-platform-overview/builders.md\"\n },\n \"pdf\": {\n \"developers\": null,\n \"builders\": null\n },\n \"chapters\": {\n \"developers\": \"downloads/books/00-platform-overview/developers.chapters.json\",\n \"builders\": \"downloads/books/00-platform-overview/builders.chapters.json\"\n }\n },\n {\n \"id\": \"01-packages\",\n \"audiences\": [\n \"developers\"\n ],\n \"md\": {\n \"developers\": \"downloads/books/01-packages/developers.md\"\n },\n \"pdf\": {\n \"developers\": null\n },\n \"chapters\": {\n \"developers\": \"downloads/books/01-packages/developers.chapters.json\"\n }\n },\n {\n \"id\": \"02-authoring\",\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"md\": {\n \"developers\": \"downloads/books/02-authoring/developers.md\",\n \"builders\": \"downloads/books/02-authoring/builders.md\"\n },\n \"pdf\": {\n \"developers\": null,\n \"builders\": null\n },\n \"chapters\": {\n \"developers\": \"downloads/books/02-authoring/developers.chapters.json\",\n \"builders\": \"downloads/books/02-authoring/builders.chapters.json\"\n }\n },\n {\n \"id\": \"03-for-humans\",\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"md\": {\n \"developers\": \"downloads/books/03-for-humans/developers.md\",\n \"builders\": \"downloads/books/03-for-humans/builders.md\"\n },\n \"pdf\": {\n \"developers\": null,\n \"builders\": null\n },\n \"chapters\": {\n \"developers\": \"downloads/books/03-for-humans/developers.chapters.json\",\n \"builders\": \"downloads/books/03-for-humans/builders.chapters.json\"\n }\n },\n {\n \"id\": \"04-for-agents\",\n \"audiences\": [\n \"developers\"\n ],\n \"md\": {\n \"developers\": \"downloads/books/04-for-agents/developers.md\"\n },\n \"pdf\": {\n \"developers\": null\n },\n \"chapters\": {\n \"developers\": \"downloads/books/04-for-agents/developers.chapters.json\"\n }\n },\n {\n \"id\": \"05-design\",\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"md\": {\n \"developers\": \"downloads/books/05-design/developers.md\",\n \"builders\": \"downloads/books/05-design/builders.md\"\n },\n \"pdf\": {\n \"developers\": null,\n \"builders\": null\n },\n \"chapters\": {\n \"developers\": \"downloads/books/05-design/developers.chapters.json\",\n \"builders\": \"downloads/books/05-design/builders.chapters.json\"\n }\n },\n {\n \"id\": \"06-getting-started-and-tutorials\",\n \"audiences\": [\n \"developers\",\n \"builders\"\n ],\n \"md\": {\n \"developers\": \"downloads/books/06-getting-started-and-tutorials/developers.md\",\n \"builders\": \"downloads/books/06-getting-started-and-tutorials/builders.md\"\n },\n \"pdf\": {\n \"developers\": null,\n \"builders\": null\n },\n \"chapters\": {\n \"developers\": \"downloads/books/06-getting-started-and-tutorials/developers.chapters.json\",\n \"builders\": \"downloads/books/06-getting-started-and-tutorials/builders.chapters.json\"\n }\n }\n ],\n \"useCases\": [\n {\n \"id\": \"orient-docify\",\n \"title\": \"Orient on x12i-docify\",\n \"md\": \"downloads/use-cases/orient-docify.md\",\n \"path\": [\n {\n \"bookId\": \"00-platform-overview\",\n \"audience\": \"developers\",\n \"chapters\": [\n \"the-central-idea\",\n \"1-what-x12i-docify-is\",\n \"2-layers\",\n \"4-where-to-go-next\"\n ]\n }\n ]\n },\n {\n \"id\": \"map-packages\",\n \"title\": \"Map the @x12i/docify-* packages\",\n \"md\": \"downloads/use-cases/map-packages.md\",\n \"path\": [\n {\n \"bookId\": \"01-packages\",\n \"audience\": \"developers\",\n \"chapters\": [\n \"1-package-table\",\n \"2-dependency-shape\",\n \"3-publish-and-install\"\n ]\n }\n ]\n },\n {\n \"id\": \"wire-product-library\",\n \"title\": \"Wire a product docs library\",\n \"md\": \"downloads/use-cases/wire-product-library.md\",\n \"path\": [\n {\n \"bookId\": \"02-authoring\",\n \"audience\": \"developers\",\n \"chapters\": [\n \"1-recipe\",\n \"2-content-layout\",\n \"3-data-contracts\",\n \"4-build-pipeline\"\n ]\n }\n ]\n },\n {\n \"id\": \"ship-human-site\",\n \"title\": \"Ship the human web app\",\n \"md\": \"downloads/use-cases/ship-human-site.md\",\n \"path\": [\n {\n \"bookId\": \"03-for-humans\",\n \"audience\": \"developers\",\n \"chapters\": [\n \"1-best-form-for-humans\",\n \"2-typical-flow\",\n \"3-what-the-bundle-emits\"\n ]\n }\n ]\n },\n {\n \"id\": \"ship-agent-packs\",\n \"title\": \"Ship agent markdown and knowledge SDK\",\n \"md\": \"downloads/use-cases/ship-agent-packs.md\",\n \"path\": [\n {\n \"bookId\": \"04-for-agents\",\n \"audience\": \"developers\",\n \"chapters\": [\n \"1-best-form-for-agents\",\n \"2-discovery\",\n \"3-knowledge-sdk\",\n \"4-install-contract\"\n ]\n }\n ]\n },\n {\n \"id\": \"keep-one-design\",\n \"title\": \"Keep one design system\",\n \"md\": \"downloads/use-cases/keep-one-design.md\",\n \"path\": [\n {\n \"bookId\": \"05-design\",\n \"audience\": \"builders\",\n \"chapters\": [\n \"1-principle\",\n \"2-identity\",\n \"3-surfaces\",\n \"4-do-not\"\n ]\n }\n ]\n }\n ],\n \"indexes\": {\n \"indexMd\": \"INDEX.md\",\n \"searchJson\": \"SEARCH.json\"\n },\n \"concepts\": [\n {\n \"id\": \"explicit-authoring\",\n \"title\": \"Explicit authoring\",\n \"md\": \"concepts/explicit-authoring.md\"\n },\n {\n \"id\": \"open-markdown\",\n \"title\": \"Open Markdown baseline\",\n \"md\": \"concepts/open-markdown.md\"\n },\n {\n \"id\": \"guide-vs-scenario\",\n \"title\": \"Guides vs scenarios vs journeys\",\n \"md\": \"concepts/guide-vs-scenario.md\"\n }\n ],\n \"guides\": [\n {\n \"id\": \"scaffold-concept\",\n \"title\": \"Scaffold a concept page\",\n \"md\": \"guides/scaffold-concept.md\"\n }\n ],\n \"scenarios\": [\n {\n \"id\": \"choose-content-type\",\n \"title\": \"Choose the right Docify content type\",\n \"md\": \"scenarios/choose-content-type.md\"\n }\n ],\n \"decisions\": [],\n \"glossary\": [\n {\n \"id\": \"docify\",\n \"term\": \"Docify\",\n \"md\": \"glossary/docify.md\"\n },\n {\n \"id\": \"search-json\",\n \"term\": \"SEARCH.json\",\n \"md\": \"glossary/search-json.md\"\n }\n ],\n \"visuals\": [],\n \"diagrams\": [\n {\n \"id\": \"docify-dual-audience\",\n \"title\": \"One library, two consumption surfaces\",\n \"md\": \"diagrams/docify-dual-audience.md\",\n \"source\": \"diagrams/sources/docify-dual-audience.mmd\"\n }\n ],\n \"relationships\": [\n {\n \"id\": \"explicit-to-open-md\",\n \"type\": \"prerequisiteOf\",\n \"from\": \"explicit-authoring\",\n \"to\": \"open-markdown\"\n },\n {\n \"id\": \"types-related\",\n \"type\": \"relatedTo\",\n \"from\": \"guide-vs-scenario\",\n \"to\": \"explicit-authoring\"\n }\n ],\n \"tutorials\": [],\n \"examples\": [],\n \"sampleData\": [],\n \"uiClients\": [],\n \"apis\": [],\n \"packs\": [\n {\n \"id\": \"concept/explicit-authoring\",\n \"type\": \"concept\",\n \"path\": \"packs/concept/explicit-authoring\"\n },\n {\n \"id\": \"concept/open-markdown\",\n \"type\": \"concept\",\n \"path\": \"packs/concept/open-markdown\"\n },\n {\n \"id\": \"concept/guide-vs-scenario\",\n \"type\": \"concept\",\n \"path\": \"packs/concept/guide-vs-scenario\"\n },\n {\n \"id\": \"guide/scaffold-concept\",\n \"type\": \"guide\",\n \"path\": \"packs/guide/scaffold-concept\"\n },\n {\n \"id\": \"scenario/choose-content-type\",\n \"type\": \"scenario\",\n \"path\": \"packs/scenario/choose-content-type\"\n }\n ]\n}",
|
|
1706
1706
|
"agent-manifest.json": "{\"version\":1,\"product\":\"docify\",\"site\":\"https://docs.docify.x12i.com\",\"knowledgePackage\":\"@x12i/docify\",\"roles\":[\"developers\",\"builders\"],\"books\":[{\"id\":\"00-platform-overview\",\"audiences\":[\"developers\",\"builders\"],\"md\":{\"developers\":\"downloads/books/00-platform-overview/developers.md\",\"builders\":\"downloads/books/00-platform-overview/builders.md\"},\"pdf\":{\"developers\":null,\"builders\":null},\"chapters\":{\"developers\":\"downloads/books/00-platform-overview/developers.chapters.json\",\"builders\":\"downloads/books/00-platform-overview/builders.chapters.json\"}},{\"id\":\"01-packages\",\"audiences\":[\"developers\"],\"md\":{\"developers\":\"downloads/books/01-packages/developers.md\"},\"pdf\":{\"developers\":null},\"chapters\":{\"developers\":\"downloads/books/01-packages/developers.chapters.json\"}},{\"id\":\"02-authoring\",\"audiences\":[\"developers\",\"builders\"],\"md\":{\"developers\":\"downloads/books/02-authoring/developers.md\",\"builders\":\"downloads/books/02-authoring/builders.md\"},\"pdf\":{\"developers\":null,\"builders\":null},\"chapters\":{\"developers\":\"downloads/books/02-authoring/developers.chapters.json\",\"builders\":\"downloads/books/02-authoring/builders.chapters.json\"}},{\"id\":\"03-for-humans\",\"audiences\":[\"developers\",\"builders\"],\"md\":{\"developers\":\"downloads/books/03-for-humans/developers.md\",\"builders\":\"downloads/books/03-for-humans/builders.md\"},\"pdf\":{\"developers\":null,\"builders\":null},\"chapters\":{\"developers\":\"downloads/books/03-for-humans/developers.chapters.json\",\"builders\":\"downloads/books/03-for-humans/builders.chapters.json\"}},{\"id\":\"04-for-agents\",\"audiences\":[\"developers\"],\"md\":{\"developers\":\"downloads/books/04-for-agents/developers.md\"},\"pdf\":{\"developers\":null},\"chapters\":{\"developers\":\"downloads/books/04-for-agents/developers.chapters.json\"}},{\"id\":\"05-design\",\"audiences\":[\"developers\",\"builders\"],\"md\":{\"developers\":\"downloads/books/05-design/developers.md\",\"builders\":\"downloads/books/05-design/builders.md\"},\"pdf\":{\"developers\":null,\"builders\":null},\"chapters\":{\"developers\":\"downloads/books/05-design/developers.chapters.json\",\"builders\":\"downloads/books/05-design/builders.chapters.json\"}},{\"id\":\"06-getting-started-and-tutorials\",\"audiences\":[\"developers\",\"builders\"],\"md\":{\"developers\":\"downloads/books/06-getting-started-and-tutorials/developers.md\",\"builders\":\"downloads/books/06-getting-started-and-tutorials/builders.md\"},\"pdf\":{\"developers\":null,\"builders\":null},\"chapters\":{\"developers\":\"downloads/books/06-getting-started-and-tutorials/developers.chapters.json\",\"builders\":\"downloads/books/06-getting-started-and-tutorials/builders.chapters.json\"}}],\"useCases\":[{\"id\":\"orient-docify\",\"title\":\"Orient on x12i-docify\",\"md\":\"downloads/use-cases/orient-docify.md\",\"path\":[{\"bookId\":\"00-platform-overview\",\"audience\":\"developers\",\"chapters\":[\"the-central-idea\",\"1-what-x12i-docify-is\",\"2-layers\",\"4-where-to-go-next\"]}]},{\"id\":\"map-packages\",\"title\":\"Map the @x12i/docify-* packages\",\"md\":\"downloads/use-cases/map-packages.md\",\"path\":[{\"bookId\":\"01-packages\",\"audience\":\"developers\",\"chapters\":[\"1-package-table\",\"2-dependency-shape\",\"3-publish-and-install\"]}]},{\"id\":\"wire-product-library\",\"title\":\"Wire a product docs library\",\"md\":\"downloads/use-cases/wire-product-library.md\",\"path\":[{\"bookId\":\"02-authoring\",\"audience\":\"developers\",\"chapters\":[\"1-recipe\",\"2-content-layout\",\"3-data-contracts\",\"4-build-pipeline\"]}]},{\"id\":\"ship-human-site\",\"title\":\"Ship the human web app\",\"md\":\"downloads/use-cases/ship-human-site.md\",\"path\":[{\"bookId\":\"03-for-humans\",\"audience\":\"developers\",\"chapters\":[\"1-best-form-for-humans\",\"2-typical-flow\",\"3-what-the-bundle-emits\"]}]},{\"id\":\"ship-agent-packs\",\"title\":\"Ship agent markdown and knowledge SDK\",\"md\":\"downloads/use-cases/ship-agent-packs.md\",\"path\":[{\"bookId\":\"04-for-agents\",\"audience\":\"developers\",\"chapters\":[\"1-best-form-for-agents\",\"2-discovery\",\"3-knowledge-sdk\",\"4-install-contract\"]}]},{\"id\":\"keep-one-design\",\"title\":\"Keep one design system\",\"md\":\"downloads/use-cases/keep-one-design.md\",\"path\":[{\"bookId\":\"05-design\",\"audience\":\"builders\",\"chapters\":[\"1-principle\",\"2-identity\",\"3-surfaces\",\"4-do-not\"]}]}],\"indexes\":{\"indexMd\":\"INDEX.md\",\"searchJson\":\"SEARCH.json\"},\"concepts\":[{\"id\":\"explicit-authoring\",\"title\":\"Explicit authoring\",\"md\":\"concepts/explicit-authoring.md\"},{\"id\":\"open-markdown\",\"title\":\"Open Markdown baseline\",\"md\":\"concepts/open-markdown.md\"},{\"id\":\"guide-vs-scenario\",\"title\":\"Guides vs scenarios vs journeys\",\"md\":\"concepts/guide-vs-scenario.md\"}],\"guides\":[{\"id\":\"scaffold-concept\",\"title\":\"Scaffold a concept page\",\"md\":\"guides/scaffold-concept.md\"}],\"scenarios\":[{\"id\":\"choose-content-type\",\"title\":\"Choose the right Docify content type\",\"md\":\"scenarios/choose-content-type.md\"}],\"decisions\":[],\"glossary\":[{\"id\":\"docify\",\"term\":\"Docify\",\"md\":\"glossary/docify.md\"},{\"id\":\"search-json\",\"term\":\"SEARCH.json\",\"md\":\"glossary/search-json.md\"}],\"visuals\":[],\"diagrams\":[{\"id\":\"docify-dual-audience\",\"title\":\"One library, two consumption surfaces\",\"md\":\"diagrams/docify-dual-audience.md\",\"source\":\"diagrams/sources/docify-dual-audience.mmd\"}],\"relationships\":[{\"id\":\"explicit-to-open-md\",\"type\":\"prerequisiteOf\",\"from\":\"explicit-authoring\",\"to\":\"open-markdown\"},{\"id\":\"types-related\",\"type\":\"relatedTo\",\"from\":\"guide-vs-scenario\",\"to\":\"explicit-authoring\"}],\"tutorials\":[],\"examples\":[],\"sampleData\":[],\"uiClients\":[],\"apis\":[],\"packs\":[{\"id\":\"concept/explicit-authoring\",\"type\":\"concept\",\"path\":\"packs/concept/explicit-authoring\"},{\"id\":\"concept/open-markdown\",\"type\":\"concept\",\"path\":\"packs/concept/open-markdown\"},{\"id\":\"concept/guide-vs-scenario\",\"type\":\"concept\",\"path\":\"packs/concept/guide-vs-scenario\"},{\"id\":\"guide/scaffold-concept\",\"type\":\"guide\",\"path\":\"packs/guide/scaffold-concept\"},{\"id\":\"scenario/choose-content-type\",\"type\":\"scenario\",\"path\":\"packs/scenario/choose-content-type\"}]}",
|
|
1707
1707
|
"agent/concepts/explicit-authoring.md": "---\nid: \"explicit-authoring\"\ntype: \"concept\"\ntitle: \"Explicit authoring\"\nsummary: \"Docify only builds knowledge that authors declare — it never discovers product truth from source.\"\nproblem: \"Auto-scanning repositories invents incomplete or wrong documentation.\"\nwhy: \"Accessibility requires intentional explanations, relationships, and confirmation boundaries.\"\nmentalModel: \"Authors understand; Docify packages and presents.\"\naudiences: [\"developers\", \"builders\"]\nrelated: [\"open-markdown\", \"knowledge-relationships\"]\nnext: [\"open-markdown\"]\n---\n# Explicit authoring\n\nDocify only builds knowledge that authors declare — it never discovers product truth from source.\n\n## Problem\n\nAuto-scanning repositories invents incomplete or wrong documentation.\n\n## Why\n\nAccessibility requires intentional explanations, relationships, and confirmation boundaries.\n\n## Mental model\n\nAuthors understand; Docify packages and presents.\n",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@x12i/docify",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.1",
|
|
4
4
|
"description": "Docify framework CLI + dogfood knowledge SDK. Install as a devDependency.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "./dist/index.js",
|
|
@@ -29,9 +29,9 @@
|
|
|
29
29
|
"node": ">=18.0.0"
|
|
30
30
|
},
|
|
31
31
|
"dependencies": {
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
32
|
+
"@x12i/docify-core": "^1.1.0",
|
|
33
|
+
"@x12i/docify-export": "^1.1.0",
|
|
34
|
+
"@x12i/docify-sdk": "^1.1.0"
|
|
35
35
|
},
|
|
36
36
|
"devDependencies": {
|
|
37
37
|
"@types/node": "^20.14.0",
|