@x12i/xops-docs 0.1.3 → 0.1.4

package/dist/generated/bundle.d.ts

@@ -105,6 +105,12 @@ export declare const useCases: {
             readonly chapters: readonly ["the-mental-model", "one-contract-three-interfaces", "what-xops-owns", "hard-product-rules", "which-book-next"];
         }];
         readonly alsoSee: readonly ["00-platform-overview"];
+        readonly prerequisites: readonly [];
+        readonly successCriteria: readonly [];
+        readonly nextUseCases: readonly [];
+        readonly scenarioIds: readonly [];
+        readonly guideIds: readonly [];
+        readonly troubleshooting: readonly [];
     }, {
         readonly id: "install-and-doctor";
         readonly title: "Install xops and run doctor";
@@ -117,6 +123,12 @@ export declare const useCases: {
             readonly chapters: readonly ["install-the-cli", "confirm-on-path", "run-doctor", "workspace-install-once"];
         }];
         readonly alsoSee: readonly ["01-install-and-daily", "04-ops-and-tools"];
+        readonly prerequisites: readonly [];
+        readonly successCriteria: readonly [];
+        readonly nextUseCases: readonly [];
+        readonly scenarioIds: readonly [];
+        readonly guideIds: readonly [];
+        readonly troubleshooting: readonly [];
     }, {
         readonly id: "run-a-safe-release";
         readonly title: "Run a safe release";
@@ -129,6 +141,12 @@ export declare const useCases: {
             readonly chapters: readonly ["discovery-and-order", "safety-gates", "publish-and-push", "undo-and-recovery"];
         }];
         readonly alsoSee: readonly ["02-release-and-publish", "05-agents-and-safety"];
+        readonly prerequisites: readonly [];
+        readonly successCriteria: readonly [];
+        readonly nextUseCases: readonly [];
+        readonly scenarioIds: readonly [];
+        readonly guideIds: readonly [];
+        readonly troubleshooting: readonly [];
     }, {
         readonly id: "wire-sdk-or-mcp";
         readonly title: "Wire the SDK or MCP";
@@ -141,6 +159,12 @@ export declare const useCases: {
             readonly chapters: readonly ["ask-and-passthrough", "typed-sdk-results", "mcp-tools-and-resources", "plan-first-approvals"];
         }];
         readonly alsoSee: readonly ["03-cli-sdk-mcp", "05-agents-and-safety"];
+        readonly prerequisites: readonly [];
+        readonly successCriteria: readonly [];
+        readonly nextUseCases: readonly [];
+        readonly scenarioIds: readonly [];
+        readonly guideIds: readonly [];
+        readonly troubleshooting: readonly [];
     }, {
         readonly id: "operate-the-tool-catalog";
         readonly title: "Operate the tool catalog";
@@ -153,6 +177,12 @@ export declare const useCases: {
             readonly chapters: readonly ["ops-status", "recommendations", "seamless-tools", "playbooks"];
         }];
         readonly alsoSee: readonly ["04-ops-and-tools", "00-platform-overview"];
+        readonly prerequisites: readonly [];
+        readonly successCriteria: readonly [];
+        readonly nextUseCases: readonly [];
+        readonly scenarioIds: readonly [];
+        readonly guideIds: readonly [];
+        readonly troubleshooting: readonly [];
     }, {
         readonly id: "brief-a-coding-agent";
         readonly title: "Brief a coding agent";
@@ -165,6 +195,12 @@ export declare const useCases: {
             readonly chapters: readonly ["ai-packs", "agent-call-shape", "publish-and-secret-safety", "knowledge-sdk"];
         }];
         readonly alsoSee: readonly ["05-agents-and-safety", "03-cli-sdk-mcp"];
+        readonly prerequisites: readonly [];
+        readonly successCriteria: readonly [];
+        readonly nextUseCases: readonly [];
+        readonly scenarioIds: readonly [];
+        readonly guideIds: readonly [];
+        readonly troubleshooting: readonly [];
     }];
 };
 export declare const site: {
@@ -341,5 +377,23 @@ export declare const manifest: {
             readonly chapters: readonly ["ai-packs", "agent-call-shape", "publish-and-secret-safety", "knowledge-sdk"];
         }];
     }];
+    readonly indexes: {
+        readonly indexMd: "INDEX.md";
+        readonly searchJson: "SEARCH.json";
+    };
+    readonly concepts: readonly [];
+    readonly guides: readonly [];
+    readonly scenarios: readonly [];
+    readonly decisions: readonly [];
+    readonly glossary: readonly [];
+    readonly visuals: readonly [];
+    readonly diagrams: readonly [];
+    readonly relationships: readonly [];
+    readonly tutorials: readonly [];
+    readonly examples: readonly [];
+    readonly sampleData: readonly [];
+    readonly uiClients: readonly [];
+    readonly apis: readonly [];
+    readonly packs: readonly [];
 };
 export declare const files: Record<string, string>;

package/dist/generated/bundle.js

@@ -171,7 +171,13 @@ export const useCases = {
             ],
             "alsoSee": [
                 "00-platform-overview"
-            ]
+            ],
+            "prerequisites": [],
+            "successCriteria": [],
+            "nextUseCases": [],
+            "scenarioIds": [],
+            "guideIds": [],
+            "troubleshooting": []
         },
         {
             "id": "install-and-doctor",
@@ -200,7 +206,13 @@ export const useCases = {
             "alsoSee": [
                 "01-install-and-daily",
                 "04-ops-and-tools"
-            ]
+            ],
+            "prerequisites": [],
+            "successCriteria": [],
+            "nextUseCases": [],
+            "scenarioIds": [],
+            "guideIds": [],
+            "troubleshooting": []
         },
         {
             "id": "run-a-safe-release",
@@ -228,7 +240,13 @@ export const useCases = {
             "alsoSee": [
                 "02-release-and-publish",
                 "05-agents-and-safety"
-            ]
+            ],
+            "prerequisites": [],
+            "successCriteria": [],
+            "nextUseCases": [],
+            "scenarioIds": [],
+            "guideIds": [],
+            "troubleshooting": []
         },
         {
             "id": "wire-sdk-or-mcp",
@@ -257,7 +275,13 @@ export const useCases = {
             "alsoSee": [
                 "03-cli-sdk-mcp",
                 "05-agents-and-safety"
-            ]
+            ],
+            "prerequisites": [],
+            "successCriteria": [],
+            "nextUseCases": [],
+            "scenarioIds": [],
+            "guideIds": [],
+            "troubleshooting": []
         },
         {
             "id": "operate-the-tool-catalog",
@@ -286,7 +310,13 @@ export const useCases = {
             "alsoSee": [
                 "04-ops-and-tools",
                 "00-platform-overview"
-            ]
+            ],
+            "prerequisites": [],
+            "successCriteria": [],
+            "nextUseCases": [],
+            "scenarioIds": [],
+            "guideIds": [],
+            "troubleshooting": []
         },
         {
             "id": "brief-a-coding-agent",
@@ -315,7 +345,13 @@ export const useCases = {
             "alsoSee": [
                 "05-agents-and-safety",
                 "03-cli-sdk-mcp"
-            ]
+            ],
+            "prerequisites": [],
+            "successCriteria": [],
+            "nextUseCases": [],
+            "scenarioIds": [],
+            "guideIds": [],
+            "troubleshooting": []
         }
     ]
 };
@@ -575,7 +611,25 @@ export const manifest = {
                 }
             ]
         }
-    ]
+    ],
+    "indexes": {
+        "indexMd": "INDEX.md",
+        "searchJson": "SEARCH.json"
+    },
+    "concepts": [],
+    "guides": [],
+    "scenarios": [],
+    "decisions": [],
+    "glossary": [],
+    "visuals": [],
+    "diagrams": [],
+    "relationships": [],
+    "tutorials": [],
+    "examples": [],
+    "sampleData": [],
+    "uiClients": [],
+    "apis": [],
+    "packs": []
 };
 export const files = {
     "downloads/books/00-platform-overview/builders.chapters.json": "[\n  {\n    \"slug\": \"preamble\",\n    \"title\": \"Introduction\",\n    \"level\": 2,\n    \"order\": 0\n  },\n  {\n    \"slug\": \"the-mental-model\",\n    \"title\": \"The mental model\",\n    \"level\": 2,\n    \"order\": 1\n  },\n  {\n    \"slug\": \"one-contract-three-interfaces\",\n    \"title\": \"One contract, three interfaces\",\n    \"level\": 2,\n    \"order\": 2\n  },\n  {\n    \"slug\": \"what-operators-own-day-to-day\",\n    \"title\": \"What operators own day to day\",\n    \"level\": 2,\n    \"order\": 3\n  },\n  {\n    \"slug\": \"hard-product-rules\",\n    \"title\": \"Hard product rules\",\n    \"level\": 2,\n    \"order\": 4\n  },\n  {\n    \"slug\": \"which-book-next\",\n    \"title\": \"Which book next\",\n    \"level\": 2,\n    \"order\": 5\n  }\n]",
@@ -599,7 +653,7 @@ export const files = {
     "downloads/use-cases/run-a-safe-release.md": "# Run a safe release\n\n> **Use case id:** `run-a-safe-release`\n> **Goal:** Plan, approve, publish, and undo a monorepo or single-package release.\n> **Audiences:** developers\n> **Tags:** release, publish\n\n## Reading path\n\n1. **Release and Publish** (developers) → chapters: `discovery-and-order`, `safety-gates`, `publish-and-push`, `undo-and-recovery`\n\n## From: Release and Publish — Discovery and order\n\nxops discovers packages in the repo (single package, packages root, or workspaces), builds a dependency-aware publish order, and plans the release before mutating anything.\n\n```bash\nxops release --dry-run\nxops map\n```\n\nAgents and CI should prefer structured / JSON outputs and dry-run plans over scraping terminal prose.\n\n---\n\n## From: Release and Publish — Safety gates\n\nBefore publish, xops applies safety checks that include (among others):\n\n- gitignore rules for `.env*` (and related patterns)\n- pack validation so secrets and junk do not ship in the tarball\n- registry / version consistency expectations for the planned packages\n\nIf a gate fails, fix the reported issue — do not bypass with force flags unless you explicitly understand the risk.\n\n---\n\n## From: Release and Publish — Publish and push\n\nTypical human path:\n\n```bash\nxops release\n# or more explicit publish/push flows from the CLI once the plan is approved\n```\n\nTypical agent path: call the SDK / MCP release tools with an explicit approval profile. Risky operations return `approval-required` instead of blocking forever or publishing silently.\n\n---\n\n## From: Release and Publish — Undo and recovery\n\nWhen a release step needs reversal, use the product undo path rather than ad-hoc git surgery:\n\n```bash\nxops undo\n```\n\nFor install/tree corruption, prefer root reinstall hygiene (`node_modules` + lock policy) and `xops validate` / `xops validate --build` after recovery. `xops clean` clears xops state — it is not a full `node_modules` wipe unless documented otherwise.\n\n## Also see\n\n- **Release and Publish** (`02-release-and-publish`) — Discovery, dependency order, safety, publish, push, and undo for humans and agents.\n- **Agents and Safety** (`05-agents-and-safety`) — AI context packs, safety gates, and how agents should call xops without scraping terminals.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
     "downloads/use-cases/wire-sdk-or-mcp.md": "# Wire the SDK or MCP\n\n> **Use case id:** `wire-sdk-or-mcp`\n> **Goal:** Call the same operating layer from TypeScript or an MCP host with plan-first approvals.\n> **Audiences:** developers\n> **Tags:** sdk, mcp, agents\n\n## Reading path\n\n1. **CLI, SDK, and MCP** (developers) → chapters: `ask-and-passthrough`, `typed-sdk-results`, `mcp-tools-and-resources`, `plan-first-approvals`\n\n## From: CLI, SDK, and MCP — Ask and passthrough\n\n`xops ask` resolves plain-English requests to automation, npm/pnpm, or git. Native project package-manager and git subcommands also pass through (for example `xops run build`, `xops status`).\n\n```bash\nxops ask \"show parallel branches\"\nxops ask \"is this package publishable?\"\n```\n\nPrefer ask when the caller does not know the exact verb; prefer explicit commands when the verb is known.\n\n---\n\n## From: CLI, SDK, and MCP — Typed SDK results\n\n```ts\nimport {\n  detectRepository,\n  runCheck,\n  runAskPlan,\n  runValidate,\n  runRelease,\n  runAiPack,\n  listPlaybooks,\n  planPlaybook,\n  runPlaybook,\n} from \"@x12i/xops\";\n```\n\nSDK functions return structured results with issues, tool runs, recommendations, reports, repository context, duration, and stable status values. Agents should consume JSON — not scrape CLI text.\n\n---\n\n## From: CLI, SDK, and MCP — MCP tools and resources\n\n```bash\nxops mcp --stdio\nxops mcp start --stdio\nxops agent mcp --stdio\nxops agent mcp --http --port 7331 --profile readonly\nxops mcp --list-tools\nxops mcp --list-resources\n```\n\nTools cover `xops.repo.*`, `xops.pkg.*`, `xops.deps.*`, `xops.security.*`, `xops.release.*`, `xops.ai.*`, `xops.net.*`, `xops.system.*`, `xops.node.*`, `xops.tools.*`, `xops.reports.*`, `xops.playbooks.*`, and `xops.plan.*`.\n\nResources include `xops://repo/context`, `xops://tools/catalog`, `xops://playbooks/catalog`, `xops://reports/latest`, and related URIs.\n\nMCP does **not** expose unrestricted shell as its primary interface.\n\n---\n\n## From: CLI, SDK, and MCP — Plan-first approvals\n\nRisky MCP operations (mutations, publish/release, tool installation, network exposure scans) return structured `approval-required` or `authorization-required` unless the caller supplies explicit approval inputs and a profile that allows the action.\n\nSystem-native tools such as Nmap or Trivy are not silently installed; MCP returns missing-tool / setup guidance the same way the CLI agent mode does.\n\n## Also see\n\n- **CLI, SDK, and MCP** (`03-cli-sdk-mcp`) — Ask, typed SDK results, MCP tools/resources, and plan-first approvals for agents.\n- **Agents and Safety** (`05-agents-and-safety`) — AI context packs, safety gates, and how agents should call xops without scraping terminals.\n\n---\n\n_Generated use-case pack for agents and humans. See `agent-manifest.json` for discovery._\n",
     "catalog.json": "{\"roles\":[{\"id\":\"developers\",\"label\":\"Developers\",\"tagline\":\"Run xops every day\",\"description\":\"Humans and coding agents who install, release, ask, and operate Node.js repositories through xops.\"},{\"id\":\"builders\",\"label\":\"Operators\",\"tagline\":\"Set up PATH, CI, and the operating contract\",\"description\":\"People who bootstrap the CLI, wire CI/agent hosts, and keep doctor/ops status green.\"}],\"families\":[{\"id\":\"xops\",\"name\":\"xops\",\"tagline\":\"The operating layer for Node.js repositories.\",\"description\":\"Detects repo state, routes work to native owners, plans risky actions, executes approved workflows, and reports what happened — via CLI, SDK, and MCP.\",\"color\":\"#1a2f45\"}],\"books\":[{\"id\":\"00-platform-overview\",\"familyId\":\"xops\",\"audiences\":[\"developers\",\"builders\"],\"status\":\"available\",\"kicker\":\"CASE FILE · XOPS-00\",\"title\":\"Platform Overview\",\"subtitle\":\"Mental model and surfaces\",\"blurb\":\"What xops is, the operating contract, three interfaces, and which book to open next.\",\"tags\":[\"platform\",\"start-here\"],\"color\":\"#1a2f45\",\"dir\":\"00-platform-overview\"},{\"id\":\"01-install-and-daily\",\"familyId\":\"xops\",\"audiences\":[\"developers\"],\"status\":\"available\",\"kicker\":\"CASE FILE · XOPS-01\",\"title\":\"Install and Daily CLI\",\"subtitle\":\"Get xops on PATH and use it every day\",\"blurb\":\"Global install, doctor, workspace install-once, and the daily command surface.\",\"tags\":[\"install\",\"cli\",\"workspaces\"],\"color\":\"#b14a2c\",\"dir\":\"01-install-and-daily\"},{\"id\":\"02-release-and-publish\",\"familyId\":\"xops\",\"audiences\":[\"developers\"],\"status\":\"available\",\"kicker\":\"CASE FILE · XOPS-02\",\"title\":\"Release and Publish\",\"subtitle\":\"The original wedge\",\"blurb\":\"Discovery, dependency order, safety, publish, push, and undo for humans and agents.\",\"tags\":[\"release\",\"publish\",\"safety\"],\"color\":\"#1f6e5c\",\"dir\":\"02-release-and-publish\"},{\"id\":\"03-cli-sdk-mcp\",\"familyId\":\"xops\",\"audiences\":[\"developers\"],\"status\":\"available\",\"kicker\":\"CASE FILE · XOPS-03\",\"title\":\"CLI, SDK, and MCP\",\"subtitle\":\"One contract, three interfaces\",\"blurb\":\"Ask, typed SDK results, MCP tools/resources, and plan-first approvals for agents.\",\"tags\":[\"sdk\",\"mcp\",\"ask\",\"agents\"],\"color\":\"#a5710f\",\"dir\":\"03-cli-sdk-mcp\"},{\"id\":\"04-ops-and-tools\",\"familyId\":\"xops\",\"audiences\":[\"builders\"],\"status\":\"available\",\"kicker\":\"CASE FILE · XOPS-04\",\"title\":\"Ops and Tools\",\"subtitle\":\"Catalog, recommendations, playbooks\",\"blurb\":\"ops status, recommendations, seamless tools, and operational playbooks.\",\"tags\":[\"ops\",\"tools\",\"playbooks\"],\"color\":\"#2c5f7a\",\"dir\":\"04-ops-and-tools\",\"buildersPrimary\":true},{\"id\":\"05-agents-and-safety\",\"familyId\":\"xops\",\"audiences\":[\"developers\"],\"status\":\"available\",\"kicker\":\"CASE FILE · XOPS-05\",\"title\":\"Agents and Safety\",\"subtitle\":\"Agent packs, gitignore, publish safety\",\"blurb\":\"AI context packs, safety gates, and how agents should call xops without scraping terminals.\",\"tags\":[\"agents\",\"safety\",\"ai-pack\"],\"color\":\"#4a3f6b\",\"dir\":\"05-agents-and-safety\"}]}",
-    "use-cases.json": "{\"useCases\":[{\"id\":\"orient-xops\",\"title\":\"Orient on xops\",\"goal\":\"Understand the operating layer, three interfaces, and which book to open next.\",\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"platform\",\"start-here\"],\"path\":[{\"bookId\":\"00-platform-overview\",\"audience\":\"developers\",\"chapters\":[\"the-mental-model\",\"one-contract-three-interfaces\",\"what-xops-owns\",\"hard-product-rules\",\"which-book-next\"]}],\"alsoSee\":[\"00-platform-overview\"]},{\"id\":\"install-and-doctor\",\"title\":\"Install xops and run doctor\",\"goal\":\"Get @x12i/xops on PATH, confirm shims, and clear doctor checks.\",\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"install\",\"doctor\"],\"path\":[{\"bookId\":\"01-install-and-daily\",\"audience\":\"developers\",\"chapters\":[\"install-the-cli\",\"confirm-on-path\",\"run-doctor\",\"workspace-install-once\"]}],\"alsoSee\":[\"01-install-and-daily\",\"04-ops-and-tools\"]},{\"id\":\"run-a-safe-release\",\"title\":\"Run a safe release\",\"goal\":\"Plan, approve, publish, and undo a monorepo or single-package release.\",\"audiences\":[\"developers\"],\"tags\":[\"release\",\"publish\"],\"path\":[{\"bookId\":\"02-release-and-publish\",\"audience\":\"developers\",\"chapters\":[\"discovery-and-order\",\"safety-gates\",\"publish-and-push\",\"undo-and-recovery\"]}],\"alsoSee\":[\"02-release-and-publish\",\"05-agents-and-safety\"]},{\"id\":\"wire-sdk-or-mcp\",\"title\":\"Wire the SDK or MCP\",\"goal\":\"Call the same operating layer from TypeScript or an MCP host with plan-first approvals.\",\"audiences\":[\"developers\"],\"tags\":[\"sdk\",\"mcp\",\"agents\"],\"path\":[{\"bookId\":\"03-cli-sdk-mcp\",\"audience\":\"developers\",\"chapters\":[\"ask-and-passthrough\",\"typed-sdk-results\",\"mcp-tools-and-resources\",\"plan-first-approvals\"]}],\"alsoSee\":[\"03-cli-sdk-mcp\",\"05-agents-and-safety\"]},{\"id\":\"operate-the-tool-catalog\",\"title\":\"Operate the tool catalog\",\"goal\":\"Read ops status, apply recommendations, and run playbooks without inventing a second ops stack.\",\"audiences\":[\"builders\"],\"tags\":[\"ops\",\"tools\",\"playbooks\"],\"path\":[{\"bookId\":\"04-ops-and-tools\",\"audience\":\"builders\",\"chapters\":[\"ops-status\",\"recommendations\",\"seamless-tools\",\"playbooks\"]}],\"alsoSee\":[\"04-ops-and-tools\",\"00-platform-overview\"]},{\"id\":\"brief-a-coding-agent\",\"title\":\"Brief a coding agent\",\"goal\":\"Generate AI context packs and teach an agent to use xops safely.\",\"audiences\":[\"developers\"],\"tags\":[\"agents\",\"ai-pack\",\"safety\"],\"path\":[{\"bookId\":\"05-agents-and-safety\",\"audience\":\"developers\",\"chapters\":[\"ai-packs\",\"agent-call-shape\",\"publish-and-secret-safety\",\"knowledge-sdk\"]}],\"alsoSee\":[\"05-agents-and-safety\",\"03-cli-sdk-mcp\"]}]}",
+    "use-cases.json": "{\"useCases\":[{\"id\":\"orient-xops\",\"title\":\"Orient on xops\",\"goal\":\"Understand the operating layer, three interfaces, and which book to open next.\",\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"platform\",\"start-here\"],\"path\":[{\"bookId\":\"00-platform-overview\",\"audience\":\"developers\",\"chapters\":[\"the-mental-model\",\"one-contract-three-interfaces\",\"what-xops-owns\",\"hard-product-rules\",\"which-book-next\"]}],\"alsoSee\":[\"00-platform-overview\"],\"prerequisites\":[],\"successCriteria\":[],\"nextUseCases\":[],\"scenarioIds\":[],\"guideIds\":[],\"troubleshooting\":[]},{\"id\":\"install-and-doctor\",\"title\":\"Install xops and run doctor\",\"goal\":\"Get @x12i/xops on PATH, confirm shims, and clear doctor checks.\",\"audiences\":[\"developers\",\"builders\"],\"tags\":[\"install\",\"doctor\"],\"path\":[{\"bookId\":\"01-install-and-daily\",\"audience\":\"developers\",\"chapters\":[\"install-the-cli\",\"confirm-on-path\",\"run-doctor\",\"workspace-install-once\"]}],\"alsoSee\":[\"01-install-and-daily\",\"04-ops-and-tools\"],\"prerequisites\":[],\"successCriteria\":[],\"nextUseCases\":[],\"scenarioIds\":[],\"guideIds\":[],\"troubleshooting\":[]},{\"id\":\"run-a-safe-release\",\"title\":\"Run a safe release\",\"goal\":\"Plan, approve, publish, and undo a monorepo or single-package release.\",\"audiences\":[\"developers\"],\"tags\":[\"release\",\"publish\"],\"path\":[{\"bookId\":\"02-release-and-publish\",\"audience\":\"developers\",\"chapters\":[\"discovery-and-order\",\"safety-gates\",\"publish-and-push\",\"undo-and-recovery\"]}],\"alsoSee\":[\"02-release-and-publish\",\"05-agents-and-safety\"],\"prerequisites\":[],\"successCriteria\":[],\"nextUseCases\":[],\"scenarioIds\":[],\"guideIds\":[],\"troubleshooting\":[]},{\"id\":\"wire-sdk-or-mcp\",\"title\":\"Wire the SDK or MCP\",\"goal\":\"Call the same operating layer from TypeScript or an MCP host with plan-first approvals.\",\"audiences\":[\"developers\"],\"tags\":[\"sdk\",\"mcp\",\"agents\"],\"path\":[{\"bookId\":\"03-cli-sdk-mcp\",\"audience\":\"developers\",\"chapters\":[\"ask-and-passthrough\",\"typed-sdk-results\",\"mcp-tools-and-resources\",\"plan-first-approvals\"]}],\"alsoSee\":[\"03-cli-sdk-mcp\",\"05-agents-and-safety\"],\"prerequisites\":[],\"successCriteria\":[],\"nextUseCases\":[],\"scenarioIds\":[],\"guideIds\":[],\"troubleshooting\":[]},{\"id\":\"operate-the-tool-catalog\",\"title\":\"Operate the tool catalog\",\"goal\":\"Read ops status, apply recommendations, and run playbooks without inventing a second ops stack.\",\"audiences\":[\"builders\"],\"tags\":[\"ops\",\"tools\",\"playbooks\"],\"path\":[{\"bookId\":\"04-ops-and-tools\",\"audience\":\"builders\",\"chapters\":[\"ops-status\",\"recommendations\",\"seamless-tools\",\"playbooks\"]}],\"alsoSee\":[\"04-ops-and-tools\",\"00-platform-overview\"],\"prerequisites\":[],\"successCriteria\":[],\"nextUseCases\":[],\"scenarioIds\":[],\"guideIds\":[],\"troubleshooting\":[]},{\"id\":\"brief-a-coding-agent\",\"title\":\"Brief a coding agent\",\"goal\":\"Generate AI context packs and teach an agent to use xops safely.\",\"audiences\":[\"developers\"],\"tags\":[\"agents\",\"ai-pack\",\"safety\"],\"path\":[{\"bookId\":\"05-agents-and-safety\",\"audience\":\"developers\",\"chapters\":[\"ai-packs\",\"agent-call-shape\",\"publish-and-secret-safety\",\"knowledge-sdk\"]}],\"alsoSee\":[\"05-agents-and-safety\",\"03-cli-sdk-mcp\"],\"prerequisites\":[],\"successCriteria\":[],\"nextUseCases\":[],\"scenarioIds\":[],\"guideIds\":[],\"troubleshooting\":[]}]}",
     "site.json": "{\"product\":\"xops\",\"brand\":\"xops · docs\",\"brandAccent\":\"docs\",\"siteUrl\":\"https://docs.xops.x12i.com\",\"knowledgePackage\":\"@x12i/xops-docs\",\"footer\":\"XOPS FIELD GUIDES · OPERATING LAYER\",\"accent\":\"oklch(42% 0.09 250)\",\"accentAlt\":\"oklch(52% 0.11 35)\",\"productUrl\":\"https://github.com/x12i/npm\",\"nav\":[{\"label\":\"Getting started\",\"href\":\"/getting-started\"},{\"label\":\"Use cases\",\"href\":\"/use-cases\"},{\"label\":\"Catalog\",\"href\":\"/catalog\"}],\"footerLinks\":[{\"label\":\"Docs home\",\"href\":\"/docs\"},{\"label\":\"Getting started\",\"href\":\"/getting-started\"},{\"label\":\"Use cases\",\"href\":\"/use-cases\"},{\"label\":\"Catalog\",\"href\":\"/catalog\"},{\"label\":\"Agents/SDK\",\"href\":\"/agents\"}]}",
-    "agent-manifest.json": "{\"version\":1,\"product\":\"xops\",\"site\":\"https://docs.xops.x12i.com\",\"knowledgePackage\":\"@x12i/xops-docs\",\"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-install-and-daily\",\"audiences\":[\"developers\"],\"md\":{\"developers\":\"downloads/books/01-install-and-daily/developers.md\"},\"pdf\":{\"developers\":null},\"chapters\":{\"developers\":\"downloads/books/01-install-and-daily/developers.chapters.json\"}},{\"id\":\"02-release-and-publish\",\"audiences\":[\"developers\"],\"md\":{\"developers\":\"downloads/books/02-release-and-publish/developers.md\"},\"pdf\":{\"developers\":null},\"chapters\":{\"developers\":\"downloads/books/02-release-and-publish/developers.chapters.json\"}},{\"id\":\"03-cli-sdk-mcp\",\"audiences\":[\"developers\"],\"md\":{\"developers\":\"downloads/books/03-cli-sdk-mcp/developers.md\"},\"pdf\":{\"developers\":null},\"chapters\":{\"developers\":\"downloads/books/03-cli-sdk-mcp/developers.chapters.json\"}},{\"id\":\"04-ops-and-tools\",\"audiences\":[\"builders\"],\"md\":{\"builders\":\"downloads/books/04-ops-and-tools/builders.md\"},\"pdf\":{\"builders\":null},\"chapters\":{\"builders\":\"downloads/books/04-ops-and-tools/builders.chapters.json\"}},{\"id\":\"05-agents-and-safety\",\"audiences\":[\"developers\"],\"md\":{\"developers\":\"downloads/books/05-agents-and-safety/developers.md\"},\"pdf\":{\"developers\":null},\"chapters\":{\"developers\":\"downloads/books/05-agents-and-safety/developers.chapters.json\"}}],\"useCases\":[{\"id\":\"orient-xops\",\"title\":\"Orient on xops\",\"md\":\"downloads/use-cases/orient-xops.md\",\"path\":[{\"bookId\":\"00-platform-overview\",\"audience\":\"developers\",\"chapters\":[\"the-mental-model\",\"one-contract-three-interfaces\",\"what-xops-owns\",\"hard-product-rules\",\"which-book-next\"]}]},{\"id\":\"install-and-doctor\",\"title\":\"Install xops and run doctor\",\"md\":\"downloads/use-cases/install-and-doctor.md\",\"path\":[{\"bookId\":\"01-install-and-daily\",\"audience\":\"developers\",\"chapters\":[\"install-the-cli\",\"confirm-on-path\",\"run-doctor\",\"workspace-install-once\"]}]},{\"id\":\"run-a-safe-release\",\"title\":\"Run a safe release\",\"md\":\"downloads/use-cases/run-a-safe-release.md\",\"path\":[{\"bookId\":\"02-release-and-publish\",\"audience\":\"developers\",\"chapters\":[\"discovery-and-order\",\"safety-gates\",\"publish-and-push\",\"undo-and-recovery\"]}]},{\"id\":\"wire-sdk-or-mcp\",\"title\":\"Wire the SDK or MCP\",\"md\":\"downloads/use-cases/wire-sdk-or-mcp.md\",\"path\":[{\"bookId\":\"03-cli-sdk-mcp\",\"audience\":\"developers\",\"chapters\":[\"ask-and-passthrough\",\"typed-sdk-results\",\"mcp-tools-and-resources\",\"plan-first-approvals\"]}]},{\"id\":\"operate-the-tool-catalog\",\"title\":\"Operate the tool catalog\",\"md\":\"downloads/use-cases/operate-the-tool-catalog.md\",\"path\":[{\"bookId\":\"04-ops-and-tools\",\"audience\":\"builders\",\"chapters\":[\"ops-status\",\"recommendations\",\"seamless-tools\",\"playbooks\"]}]},{\"id\":\"brief-a-coding-agent\",\"title\":\"Brief a coding agent\",\"md\":\"downloads/use-cases/brief-a-coding-agent.md\",\"path\":[{\"bookId\":\"05-agents-and-safety\",\"audience\":\"developers\",\"chapters\":[\"ai-packs\",\"agent-call-shape\",\"publish-and-secret-safety\",\"knowledge-sdk\"]}]}]}"
+    "agent-manifest.json": "{\"version\":1,\"product\":\"xops\",\"site\":\"https://docs.xops.x12i.com\",\"knowledgePackage\":\"@x12i/xops-docs\",\"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-install-and-daily\",\"audiences\":[\"developers\"],\"md\":{\"developers\":\"downloads/books/01-install-and-daily/developers.md\"},\"pdf\":{\"developers\":null},\"chapters\":{\"developers\":\"downloads/books/01-install-and-daily/developers.chapters.json\"}},{\"id\":\"02-release-and-publish\",\"audiences\":[\"developers\"],\"md\":{\"developers\":\"downloads/books/02-release-and-publish/developers.md\"},\"pdf\":{\"developers\":null},\"chapters\":{\"developers\":\"downloads/books/02-release-and-publish/developers.chapters.json\"}},{\"id\":\"03-cli-sdk-mcp\",\"audiences\":[\"developers\"],\"md\":{\"developers\":\"downloads/books/03-cli-sdk-mcp/developers.md\"},\"pdf\":{\"developers\":null},\"chapters\":{\"developers\":\"downloads/books/03-cli-sdk-mcp/developers.chapters.json\"}},{\"id\":\"04-ops-and-tools\",\"audiences\":[\"builders\"],\"md\":{\"builders\":\"downloads/books/04-ops-and-tools/builders.md\"},\"pdf\":{\"builders\":null},\"chapters\":{\"builders\":\"downloads/books/04-ops-and-tools/builders.chapters.json\"}},{\"id\":\"05-agents-and-safety\",\"audiences\":[\"developers\"],\"md\":{\"developers\":\"downloads/books/05-agents-and-safety/developers.md\"},\"pdf\":{\"developers\":null},\"chapters\":{\"developers\":\"downloads/books/05-agents-and-safety/developers.chapters.json\"}}],\"useCases\":[{\"id\":\"orient-xops\",\"title\":\"Orient on xops\",\"md\":\"downloads/use-cases/orient-xops.md\",\"path\":[{\"bookId\":\"00-platform-overview\",\"audience\":\"developers\",\"chapters\":[\"the-mental-model\",\"one-contract-three-interfaces\",\"what-xops-owns\",\"hard-product-rules\",\"which-book-next\"]}]},{\"id\":\"install-and-doctor\",\"title\":\"Install xops and run doctor\",\"md\":\"downloads/use-cases/install-and-doctor.md\",\"path\":[{\"bookId\":\"01-install-and-daily\",\"audience\":\"developers\",\"chapters\":[\"install-the-cli\",\"confirm-on-path\",\"run-doctor\",\"workspace-install-once\"]}]},{\"id\":\"run-a-safe-release\",\"title\":\"Run a safe release\",\"md\":\"downloads/use-cases/run-a-safe-release.md\",\"path\":[{\"bookId\":\"02-release-and-publish\",\"audience\":\"developers\",\"chapters\":[\"discovery-and-order\",\"safety-gates\",\"publish-and-push\",\"undo-and-recovery\"]}]},{\"id\":\"wire-sdk-or-mcp\",\"title\":\"Wire the SDK or MCP\",\"md\":\"downloads/use-cases/wire-sdk-or-mcp.md\",\"path\":[{\"bookId\":\"03-cli-sdk-mcp\",\"audience\":\"developers\",\"chapters\":[\"ask-and-passthrough\",\"typed-sdk-results\",\"mcp-tools-and-resources\",\"plan-first-approvals\"]}]},{\"id\":\"operate-the-tool-catalog\",\"title\":\"Operate the tool catalog\",\"md\":\"downloads/use-cases/operate-the-tool-catalog.md\",\"path\":[{\"bookId\":\"04-ops-and-tools\",\"audience\":\"builders\",\"chapters\":[\"ops-status\",\"recommendations\",\"seamless-tools\",\"playbooks\"]}]},{\"id\":\"brief-a-coding-agent\",\"title\":\"Brief a coding agent\",\"md\":\"downloads/use-cases/brief-a-coding-agent.md\",\"path\":[{\"bookId\":\"05-agents-and-safety\",\"audience\":\"developers\",\"chapters\":[\"ai-packs\",\"agent-call-shape\",\"publish-and-secret-safety\",\"knowledge-sdk\"]}]}],\"indexes\":{\"indexMd\":\"INDEX.md\",\"searchJson\":\"SEARCH.json\"},\"concepts\":[],\"guides\":[],\"scenarios\":[],\"decisions\":[],\"glossary\":[],\"visuals\":[],\"diagrams\":[],\"relationships\":[],\"tutorials\":[],\"examples\":[],\"sampleData\":[],\"uiClients\":[],\"apis\":[],\"packs\":[]}"
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/xops-docs",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "xops docs knowledge SDK — install as a devDependency only. Catalog, use cases, and markdown packs for humans and agents.",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,8 +29,13 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@x12i/docify-core": "^1.0.1",
-    "@x12i/docify-sdk": "^1.0.1"
+    "@x12i/docify-core": "^1.1.1",
+    "@x12i/docify-sdk": "^1.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
   },
   "publishConfig": {
     "access": "public",