@x12i/catalox-docs 1.1.0

package/dist/generated/bundle.d.ts

@@ -0,0 +1,749 @@
+export declare const catalog: {
+    readonly roles: readonly [{
+        readonly id: "developers";
+        readonly label: "Developers";
+        readonly tagline: "Embed, operate, integrate";
+        readonly description: "Engineers who embed Catalox, run the CLI, deploy catalox-service, and wire Authix or host context.";
+    }];
+    readonly families: readonly [{
+        readonly id: "catalox";
+        readonly name: "Catalox";
+        readonly tagline: "Governed catalogs as platform infrastructure.";
+        readonly description: "Reusable item inventories that apps discover, render, search, and validate — without rebuilding catalog plumbing.";
+        readonly color: "#1a3a52";
+    }];
+    readonly books: readonly [{
+        readonly id: "00-overview";
+        readonly familyId: "catalox";
+        readonly audiences: readonly ["developers"];
+        readonly status: "available";
+        readonly kicker: "CASE FILE · CAT-00";
+        readonly title: "Overview";
+        readonly subtitle: "Why Catalox exists";
+        readonly blurb: "Product rationale, what Catalox is and is not, fit vs misfit, and FAQ highlights.";
+        readonly tags: readonly ["platform", "start-here", "overview"];
+        readonly color: "#1a3a52";
+        readonly dir: "00-overview";
+    }, {
+        readonly id: "01-content-backend";
+        readonly familyId: "catalox";
+        readonly audiences: readonly ["developers"];
+        readonly status: "available";
+        readonly kicker: "CASE FILE · CAT-01";
+        readonly title: "Content Backend";
+        readonly subtitle: "Apps and agents on one catalog layer";
+        readonly blurb: "Recommended integration pattern: BFFs and agent runtimes share Catalox as the content/metadata API.";
+        readonly tags: readonly ["integration", "bff", "agents"];
+        readonly color: "#1f5c4a";
+        readonly dir: "01-content-backend";
+    }, {
+        readonly id: "02-persistence";
+        readonly familyId: "catalox";
+        readonly audiences: readonly ["developers"];
+        readonly status: "available";
+        readonly kicker: "CASE FILE · CAT-02";
+        readonly title: "Persistence";
+        readonly subtitle: "MongoDB as primary store";
+        readonly blurb: "createCataloxFromEnv, collection layout, env vars, and operator notes for Mongo-backed estates.";
+        readonly tags: readonly ["mongo", "storage", "ops"];
+        readonly color: "#8a5a12";
+        readonly dir: "02-persistence";
+    }, {
+        readonly id: "03-deploy-ops";
+        readonly familyId: "catalox";
+        readonly audiences: readonly ["developers"];
+        readonly status: "available";
+        readonly kicker: "CASE FILE · CAT-03";
+        readonly title: "Deploy & Ops";
+        readonly subtitle: "Embed, CLI, HTTP, onboard";
+        readonly blurb: "Deployment modes, private vs public HTTP, onboarding happy path, and environment reference.";
+        readonly tags: readonly ["deploy", "http", "onboarding"];
+        readonly color: "#8b3a28";
+        readonly dir: "03-deploy-ops";
+    }, {
+        readonly id: "04-auth-identity";
+        readonly familyId: "catalox";
+        readonly audiences: readonly ["developers"];
+        readonly status: "available";
+        readonly kicker: "CASE FILE · CAT-04";
+        readonly title: "Auth & Identity";
+        readonly subtitle: "Context, bindings, outcomes";
+        readonly blurb: "Orthogonal identity axes, superAdmin, catalog/item visibility, and empty vs denied vs misconfigured.";
+        readonly tags: readonly ["auth", "identity", "bindings"];
+        readonly color: "#4a3a6e";
+        readonly dir: "04-auth-identity";
+    }, {
+        readonly id: "05-cli-toolbox";
+        readonly familyId: "catalox";
+        readonly audiences: readonly ["developers"];
+        readonly status: "available";
+        readonly kicker: "CASE FILE · CAT-05";
+        readonly title: "CLI & Toolbox";
+        readonly subtitle: "Operator commands";
+        readonly blurb: "Elevated CLI access, items CRUD, toolbox diagnostics, and seed workflows.";
+        readonly tags: readonly ["cli", "ops", "seed"];
+        readonly color: "#2a4a62";
+        readonly dir: "05-cli-toolbox";
+    }];
+};
+export declare const useCases: {
+    readonly useCases: readonly [{
+        readonly id: "orient-catalox";
+        readonly title: "Orient on Catalox";
+        readonly goal: "Understand why Catalox exists, what it owns, and when not to use it.";
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["platform", "start-here"];
+        readonly path: readonly [{
+            readonly bookId: "00-overview";
+            readonly audience: "developers";
+            readonly chapters: readonly ["1-why-catalox-exists", "2-what-catalox-is", "3-fit-vs-misfit"];
+        }];
+        readonly alsoSee: readonly ["01-content-backend"];
+        readonly prerequisites: readonly [];
+        readonly successCriteria: readonly [];
+        readonly nextUseCases: readonly [];
+        readonly scenarioIds: readonly [];
+        readonly guideIds: readonly [];
+        readonly troubleshooting: readonly [];
+    }, {
+        readonly id: "embed-content-backend";
+        readonly title: "Embed as content backend";
+        readonly goal: "Wire a BFF and agent runtime so humans and agents share one catalog layer.";
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["integration", "bff", "agents"];
+        readonly path: readonly [{
+            readonly bookId: "01-content-backend";
+            readonly audience: "developers";
+            readonly chapters: readonly ["1-the-pattern", "2-architecture", "3-product-use-cases"];
+        }];
+        readonly alsoSee: readonly ["00-overview", "04-auth-identity"];
+        readonly prerequisites: readonly [];
+        readonly successCriteria: readonly [];
+        readonly nextUseCases: readonly [];
+        readonly scenarioIds: readonly [];
+        readonly guideIds: readonly [];
+        readonly troubleshooting: readonly [];
+    }, {
+        readonly id: "mongo-onboard";
+        readonly title: "Onboard with Mongo";
+        readonly goal: "Connect Mongo, probe, seed a preset, and validate catalogs for a new appId.";
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["mongo", "onboarding", "ops"];
+        readonly path: readonly [{
+            readonly bookId: "02-persistence";
+            readonly audience: "developers";
+            readonly chapters: readonly ["1-mongo-quick-start", "2-environment"];
+        }, {
+            readonly bookId: "03-deploy-ops";
+            readonly audience: "developers";
+            readonly chapters: readonly ["4-onboarding-happy-path"];
+        }];
+        readonly alsoSee: readonly ["05-cli-toolbox"];
+        readonly prerequisites: readonly [];
+        readonly successCriteria: readonly [];
+        readonly nextUseCases: readonly [];
+        readonly scenarioIds: readonly [];
+        readonly guideIds: readonly [];
+        readonly troubleshooting: readonly [];
+    }, {
+        readonly id: "auth-context";
+        readonly title: "Map host auth to Catalox context";
+        readonly goal: "Provide CataloxContext axes correctly and distinguish empty, denied, and misconfigured.";
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["auth", "identity"];
+        readonly path: readonly [{
+            readonly bookId: "04-auth-identity";
+            readonly audience: "developers";
+            readonly chapters: readonly ["1-identity-axes", "2-super-admin", "3-catalog-and-item-visibility", "4-empty-vs-denied"];
+        }];
+        readonly alsoSee: readonly ["01-content-backend"];
+        readonly prerequisites: readonly [];
+        readonly successCriteria: readonly [];
+        readonly nextUseCases: readonly [];
+        readonly scenarioIds: readonly [];
+        readonly guideIds: readonly [];
+        readonly troubleshooting: readonly [];
+    }, {
+        readonly id: "cli-seed-items";
+        readonly title: "Operate with CLI items and seed";
+        readonly goal: "Use elevated CLI access, items commands, and seed manifests safely.";
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["cli", "seed", "ops"];
+        readonly path: readonly [{
+            readonly bookId: "05-cli-toolbox";
+            readonly audience: "developers";
+            readonly chapters: readonly ["1-cli-access", "2-items-commands", "4-seed-workflow"];
+        }];
+        readonly alsoSee: readonly ["03-deploy-ops"];
+        readonly prerequisites: readonly [];
+        readonly successCriteria: readonly [];
+        readonly nextUseCases: readonly [];
+        readonly scenarioIds: readonly [];
+        readonly guideIds: readonly [];
+        readonly troubleshooting: readonly [];
+    }];
+};
+export declare const site: {
+    readonly product: "catalox";
+    readonly brand: "x12i · catalox";
+    readonly brandAccent: "catalox";
+    readonly siteUrl: "https://docs.catalox.x12i.com";
+    readonly knowledgePackage: "@x12i/catalox-docs";
+    readonly footer: "x12i · Catalox";
+    readonly accent: "oklch(45% 0.08 230)";
+    readonly accentAlt: "oklch(55% 0.12 160)";
+    readonly productUrl: "https://github.com/x12i/catalox";
+    readonly nav: readonly [{
+        readonly label: "Getting started";
+        readonly href: "/getting-started";
+    }, {
+        readonly label: "Use cases";
+        readonly href: "/use-cases";
+    }, {
+        readonly label: "Catalog";
+        readonly href: "/catalog";
+    }];
+    readonly footerLinks: readonly [{
+        readonly label: "Docs home";
+        readonly href: "/docs";
+    }, {
+        readonly label: "Getting started";
+        readonly href: "/getting-started";
+    }, {
+        readonly label: "Use cases";
+        readonly href: "/use-cases";
+    }, {
+        readonly label: "Catalog";
+        readonly href: "/catalog";
+    }, {
+        readonly label: "Agents/SDK";
+        readonly href: "/agents";
+    }, {
+        readonly label: "Repo";
+        readonly href: "https://github.com/x12i/catalox";
+    }];
+};
+export declare const manifest: {
+    readonly version: 1;
+    readonly product: "catalox";
+    readonly site: "https://docs.catalox.x12i.com";
+    readonly knowledgePackage: "@x12i/catalox-docs";
+    readonly roles: readonly ["developers"];
+    readonly books: readonly [{
+        readonly id: "00-overview";
+        readonly audiences: readonly ["developers"];
+        readonly md: {
+            readonly developers: "downloads/books/00-overview/developers.md";
+        };
+        readonly pdf: {
+            readonly developers: null;
+        };
+        readonly chapters: {
+            readonly developers: "downloads/books/00-overview/developers.chapters.json";
+        };
+    }, {
+        readonly id: "01-content-backend";
+        readonly audiences: readonly ["developers"];
+        readonly md: {
+            readonly developers: "downloads/books/01-content-backend/developers.md";
+        };
+        readonly pdf: {
+            readonly developers: null;
+        };
+        readonly chapters: {
+            readonly developers: "downloads/books/01-content-backend/developers.chapters.json";
+        };
+    }, {
+        readonly id: "02-persistence";
+        readonly audiences: readonly ["developers"];
+        readonly md: {
+            readonly developers: "downloads/books/02-persistence/developers.md";
+        };
+        readonly pdf: {
+            readonly developers: null;
+        };
+        readonly chapters: {
+            readonly developers: "downloads/books/02-persistence/developers.chapters.json";
+        };
+    }, {
+        readonly id: "03-deploy-ops";
+        readonly audiences: readonly ["developers"];
+        readonly md: {
+            readonly developers: "downloads/books/03-deploy-ops/developers.md";
+        };
+        readonly pdf: {
+            readonly developers: null;
+        };
+        readonly chapters: {
+            readonly developers: "downloads/books/03-deploy-ops/developers.chapters.json";
+        };
+    }, {
+        readonly id: "04-auth-identity";
+        readonly audiences: readonly ["developers"];
+        readonly md: {
+            readonly developers: "downloads/books/04-auth-identity/developers.md";
+        };
+        readonly pdf: {
+            readonly developers: null;
+        };
+        readonly chapters: {
+            readonly developers: "downloads/books/04-auth-identity/developers.chapters.json";
+        };
+    }, {
+        readonly id: "05-cli-toolbox";
+        readonly audiences: readonly ["developers"];
+        readonly md: {
+            readonly developers: "downloads/books/05-cli-toolbox/developers.md";
+        };
+        readonly pdf: {
+            readonly developers: null;
+        };
+        readonly chapters: {
+            readonly developers: "downloads/books/05-cli-toolbox/developers.chapters.json";
+        };
+    }];
+    readonly useCases: readonly [{
+        readonly id: "orient-catalox";
+        readonly title: "Orient on Catalox";
+        readonly md: "downloads/use-cases/orient-catalox.md";
+        readonly path: readonly [{
+            readonly bookId: "00-overview";
+            readonly audience: "developers";
+            readonly chapters: readonly ["1-why-catalox-exists", "2-what-catalox-is", "3-fit-vs-misfit"];
+        }];
+    }, {
+        readonly id: "embed-content-backend";
+        readonly title: "Embed as content backend";
+        readonly md: "downloads/use-cases/embed-content-backend.md";
+        readonly path: readonly [{
+            readonly bookId: "01-content-backend";
+            readonly audience: "developers";
+            readonly chapters: readonly ["1-the-pattern", "2-architecture", "3-product-use-cases"];
+        }];
+    }, {
+        readonly id: "mongo-onboard";
+        readonly title: "Onboard with Mongo";
+        readonly md: "downloads/use-cases/mongo-onboard.md";
+        readonly path: readonly [{
+            readonly bookId: "02-persistence";
+            readonly audience: "developers";
+            readonly chapters: readonly ["1-mongo-quick-start", "2-environment"];
+        }, {
+            readonly bookId: "03-deploy-ops";
+            readonly audience: "developers";
+            readonly chapters: readonly ["4-onboarding-happy-path"];
+        }];
+    }, {
+        readonly id: "auth-context";
+        readonly title: "Map host auth to Catalox context";
+        readonly md: "downloads/use-cases/auth-context.md";
+        readonly path: readonly [{
+            readonly bookId: "04-auth-identity";
+            readonly audience: "developers";
+            readonly chapters: readonly ["1-identity-axes", "2-super-admin", "3-catalog-and-item-visibility", "4-empty-vs-denied"];
+        }];
+    }, {
+        readonly id: "cli-seed-items";
+        readonly title: "Operate with CLI items and seed";
+        readonly md: "downloads/use-cases/cli-seed-items.md";
+        readonly path: readonly [{
+            readonly bookId: "05-cli-toolbox";
+            readonly audience: "developers";
+            readonly chapters: readonly ["1-cli-access", "2-items-commands", "4-seed-workflow"];
+        }];
+    }];
+    readonly indexes: {
+        readonly indexMd: "INDEX.md";
+        readonly searchJson: "SEARCH.json";
+    };
+    readonly concepts: readonly [{
+        readonly id: "catalog-as-platform";
+        readonly title: "Catalog as platform";
+        readonly md: "concepts/catalog-as-platform.md";
+    }, {
+        readonly id: "mongo-primary";
+        readonly title: "MongoDB is primary persistence";
+        readonly md: "concepts/mongo-primary.md";
+    }];
+    readonly guides: readonly [{
+        readonly id: "embed-catalox";
+        readonly title: "Embed Catalox from env";
+        readonly md: "guides/embed-catalox.md";
+    }];
+    readonly scenarios: readonly [{
+        readonly id: "choose-deploy-mode";
+        readonly title: "Choose embed vs HTTP service";
+        readonly md: "scenarios/choose-deploy-mode.md";
+    }];
+    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 [{
+        readonly id: "concept/catalog-as-platform";
+        readonly type: "concept";
+        readonly path: "packs/concept/catalog-as-platform";
+    }, {
+        readonly id: "concept/mongo-primary";
+        readonly type: "concept";
+        readonly path: "packs/concept/mongo-primary";
+    }, {
+        readonly id: "guide/embed-catalox";
+        readonly type: "guide";
+        readonly path: "packs/guide/embed-catalox";
+    }, {
+        readonly id: "scenario/choose-deploy-mode";
+        readonly type: "scenario";
+        readonly path: "packs/scenario/choose-deploy-mode";
+    }];
+};
+export declare const knowledge: {
+    readonly concepts: readonly [{
+        readonly summary: "Catalox owns governed catalog definitions so product backends do not rebuild catalog plumbing.";
+        readonly problem: "Every app reinvents schemas, list/get APIs, admin field metadata, access rules, and agent-readable descriptors.";
+        readonly why: "Shared catalogs keep discovery, visibility, and validation consistent across web BFFs and agent runtimes.";
+        readonly mentalModel: "Catalox stores the selectable definition; the host stores the transaction, run, or event that uses it.";
+        readonly audiences: readonly ["developers"];
+        readonly whenItMatters: readonly [];
+        readonly whenNotToUse: readonly [];
+        readonly prerequisites: readonly [];
+        readonly related: readonly ["mongo-primary"];
+        readonly next: readonly ["embed-catalox"];
+        readonly exampleIds: readonly [];
+        readonly commonMistakes: readonly [];
+        readonly successCriteria: readonly [];
+        readonly invariants: readonly [];
+        readonly alternatives: readonly [];
+        readonly tags: readonly [];
+        readonly id: "catalog-as-platform";
+        readonly type: "concept";
+        readonly title: "Catalog as platform";
+        readonly visualIds: readonly [];
+        readonly diagramIds: readonly [];
+        readonly referenceIds: readonly [];
+    }, {
+        readonly summary: "Catalox 6 stores catalogs and items in MongoDB; Firestore operators are migration-only.";
+        readonly problem: "Dual-write or Firestore-first assumptions break onboarding and ops scripts.";
+        readonly why: "One primary store simplifies estate layout, CLI probes, and production deploys.";
+        readonly mentalModel: "createCataloxFromEnv → Mongo collections; R2 is optional object history, not the catalog DB.";
+        readonly audiences: readonly ["developers"];
+        readonly whenItMatters: readonly [];
+        readonly whenNotToUse: readonly [];
+        readonly prerequisites: readonly ["catalog-as-platform"];
+        readonly related: readonly [];
+        readonly next: readonly ["embed-catalox"];
+        readonly exampleIds: readonly [];
+        readonly commonMistakes: readonly [];
+        readonly successCriteria: readonly [];
+        readonly invariants: readonly [];
+        readonly alternatives: readonly [];
+        readonly tags: readonly [];
+        readonly id: "mongo-primary";
+        readonly type: "concept";
+        readonly title: "MongoDB is primary persistence";
+        readonly visualIds: readonly [];
+        readonly diagramIds: readonly [];
+        readonly referenceIds: readonly [];
+    }];
+    readonly guides: readonly [{
+        readonly summary: "Create an in-process Catalox client from environment variables and verify Mongo connectivity.";
+        readonly why: "Embedding is the default integration — HTTP service is optional.";
+        readonly audiences: readonly ["developers"];
+        readonly whenItMatters: readonly [];
+        readonly whenNotToUse: readonly [];
+        readonly prerequisites: readonly ["catalog-as-platform", "mongo-primary"];
+        readonly related: readonly ["choose-deploy-mode"];
+        readonly next: readonly [];
+        readonly exampleIds: readonly [];
+        readonly commonMistakes: readonly [];
+        readonly successCriteria: readonly [];
+        readonly invariants: readonly ["Mongo is the primary store", "appId selects the catalog tenant, not the cloud project id"];
+        readonly alternatives: readonly [];
+        readonly confirmationRequired: false;
+        readonly tags: readonly [];
+        readonly id: "embed-catalox";
+        readonly type: "guide";
+        readonly title: "Embed Catalox from env";
+        readonly useWhen: readonly [];
+        readonly doNotUseWhen: readonly [];
+        readonly inputs: readonly [];
+        readonly permissions: readonly [];
+        readonly steps: readonly [];
+        readonly verification: readonly [];
+        readonly recovery: readonly [];
+        readonly tutorialIds: readonly [];
+        readonly referenceIds: readonly [];
+        readonly scenarioIds: readonly [];
+    }];
+    readonly scenarios: readonly [{
+        readonly summary: "Decide whether to embed Catalox in-process or expose catalox-service.";
+        readonly audiences: readonly ["developers"];
+        readonly whenItMatters: readonly [];
+        readonly whenNotToUse: readonly [];
+        readonly prerequisites: readonly [];
+        readonly related: readonly [];
+        readonly next: readonly [];
+        readonly exampleIds: readonly [];
+        readonly commonMistakes: readonly [];
+        readonly successCriteria: readonly [];
+        readonly invariants: readonly ["Same Mongo estate either way", "Authix gates public HTTP; embed still needs host context"];
+        readonly alternatives: readonly [];
+        readonly tags: readonly [];
+        readonly id: "choose-deploy-mode";
+        readonly type: "scenario";
+        readonly title: "Choose embed vs HTTP service";
+        readonly situation: "You are integrating Catalox into a product and must pick embed vs HTTP service.";
+        readonly preconditions: readonly [];
+        readonly signals: readonly [];
+        readonly decisionQuestion: "Should this product embed Catalox or deploy catalox-service?";
+        readonly paths: readonly [{
+            readonly id: "embed";
+            readonly label: "Embed in-process";
+            readonly when: "One Node service owns catalog access and host identity.";
+            readonly rationale: "Prefer createCataloxFromEnv and CataloxContext inside the BFF.";
+            readonly guideIds: readonly ["embed-catalox"];
+        }, {
+            readonly id: "http-service";
+            readonly label: "HTTP service";
+            readonly when: "Other runtimes or networks must call Catalox over HTTP.";
+            readonly rationale: "Deploy catalox-service against the same Mongo estate; gate public routes with Authix.";
+            readonly guideIds: readonly ["embed-catalox"];
+        }];
+        readonly verification: readonly [];
+        readonly recovery: 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 [];
+};
+export declare const search: {
+    readonly version: 1;
+    readonly product: "catalox";
+    readonly generatedAt: "2026-07-26T13:09:13.535Z";
+    readonly records: readonly [{
+        readonly id: "catalog-as-platform";
+        readonly type: "concept";
+        readonly title: "Catalog as platform";
+        readonly summary: "Catalox owns governed catalog definitions so product backends do not rebuild catalog plumbing.";
+        readonly aliases: readonly [];
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly [];
+        readonly goals: readonly [];
+        readonly path: "concepts/catalog-as-platform.md";
+        readonly webPath: "/concepts/catalog-as-platform";
+        readonly prerequisites: readonly [];
+        readonly related: readonly ["mongo-primary"];
+        readonly packIds: readonly ["concept/catalog-as-platform"];
+    }, {
+        readonly id: "mongo-primary";
+        readonly type: "concept";
+        readonly title: "MongoDB is primary persistence";
+        readonly summary: "Catalox 6 stores catalogs and items in MongoDB; Firestore operators are migration-only.";
+        readonly aliases: readonly [];
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly [];
+        readonly goals: readonly [];
+        readonly path: "concepts/mongo-primary.md";
+        readonly webPath: "/concepts/mongo-primary";
+        readonly prerequisites: readonly ["catalog-as-platform"];
+        readonly related: readonly [];
+        readonly packIds: readonly ["concept/mongo-primary"];
+    }, {
+        readonly id: "embed-catalox";
+        readonly type: "guide";
+        readonly title: "Embed Catalox from env";
+        readonly summary: "Create an in-process Catalox client from environment variables and verify Mongo connectivity.";
+        readonly aliases: readonly [];
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly [];
+        readonly goals: readonly [];
+        readonly path: "guides/embed-catalox.md";
+        readonly webPath: "/guides/embed-catalox";
+        readonly prerequisites: readonly ["catalog-as-platform", "mongo-primary"];
+        readonly related: readonly ["choose-deploy-mode"];
+        readonly packIds: readonly ["guide/embed-catalox"];
+    }, {
+        readonly id: "choose-deploy-mode";
+        readonly type: "scenario";
+        readonly title: "Choose embed vs HTTP service";
+        readonly summary: "Decide whether to embed Catalox in-process or expose catalox-service.";
+        readonly aliases: readonly [];
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly [];
+        readonly goals: readonly ["Should this product embed Catalox or deploy catalox-service?"];
+        readonly path: "scenarios/choose-deploy-mode.md";
+        readonly webPath: "/scenarios/choose-deploy-mode";
+        readonly prerequisites: readonly [];
+        readonly related: readonly [];
+        readonly packIds: readonly ["scenario/choose-deploy-mode"];
+    }, {
+        readonly id: "orient-catalox";
+        readonly type: "use-case";
+        readonly title: "Orient on Catalox";
+        readonly summary: "Understand why Catalox exists, what it owns, and when not to use it.";
+        readonly aliases: readonly [];
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["platform", "start-here"];
+        readonly goals: readonly ["Understand why Catalox exists, what it owns, and when not to use it."];
+        readonly path: "use-cases/orient-catalox.md";
+        readonly webPath: "/use-cases#orient-catalox";
+        readonly prerequisites: readonly [];
+        readonly related: readonly ["01-content-backend"];
+        readonly packIds: readonly ["use-case/orient-catalox"];
+    }, {
+        readonly id: "embed-content-backend";
+        readonly type: "use-case";
+        readonly title: "Embed as content backend";
+        readonly summary: "Wire a BFF and agent runtime so humans and agents share one catalog layer.";
+        readonly aliases: readonly [];
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["integration", "bff", "agents"];
+        readonly goals: readonly ["Wire a BFF and agent runtime so humans and agents share one catalog layer."];
+        readonly path: "use-cases/embed-content-backend.md";
+        readonly webPath: "/use-cases#embed-content-backend";
+        readonly prerequisites: readonly [];
+        readonly related: readonly ["00-overview", "04-auth-identity"];
+        readonly packIds: readonly ["use-case/embed-content-backend"];
+    }, {
+        readonly id: "mongo-onboard";
+        readonly type: "use-case";
+        readonly title: "Onboard with Mongo";
+        readonly summary: "Connect Mongo, probe, seed a preset, and validate catalogs for a new appId.";
+        readonly aliases: readonly [];
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["mongo", "onboarding", "ops"];
+        readonly goals: readonly ["Connect Mongo, probe, seed a preset, and validate catalogs for a new appId."];
+        readonly path: "use-cases/mongo-onboard.md";
+        readonly webPath: "/use-cases#mongo-onboard";
+        readonly prerequisites: readonly [];
+        readonly related: readonly ["05-cli-toolbox"];
+        readonly packIds: readonly ["use-case/mongo-onboard"];
+    }, {
+        readonly id: "auth-context";
+        readonly type: "use-case";
+        readonly title: "Map host auth to Catalox context";
+        readonly summary: "Provide CataloxContext axes correctly and distinguish empty, denied, and misconfigured.";
+        readonly aliases: readonly [];
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["auth", "identity"];
+        readonly goals: readonly ["Provide CataloxContext axes correctly and distinguish empty, denied, and misconfigured."];
+        readonly path: "use-cases/auth-context.md";
+        readonly webPath: "/use-cases#auth-context";
+        readonly prerequisites: readonly [];
+        readonly related: readonly ["01-content-backend"];
+        readonly packIds: readonly ["use-case/auth-context"];
+    }, {
+        readonly id: "cli-seed-items";
+        readonly type: "use-case";
+        readonly title: "Operate with CLI items and seed";
+        readonly summary: "Use elevated CLI access, items commands, and seed manifests safely.";
+        readonly aliases: readonly [];
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["cli", "seed", "ops"];
+        readonly goals: readonly ["Use elevated CLI access, items commands, and seed manifests safely."];
+        readonly path: "use-cases/cli-seed-items.md";
+        readonly webPath: "/use-cases#cli-seed-items";
+        readonly prerequisites: readonly [];
+        readonly related: readonly ["03-deploy-ops"];
+        readonly packIds: readonly ["use-case/cli-seed-items"];
+    }, {
+        readonly id: "00-overview";
+        readonly type: "book";
+        readonly title: "Overview";
+        readonly summary: "Product rationale, what Catalox is and is not, fit vs misfit, and FAQ highlights.";
+        readonly aliases: readonly ["CASE FILE · CAT-00"];
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["platform", "start-here", "overview"];
+        readonly goals: readonly [];
+        readonly path: "books/00-overview/";
+        readonly webPath: "/books/00-overview";
+        readonly prerequisites: readonly [];
+        readonly related: readonly [];
+        readonly packIds: readonly [];
+    }, {
+        readonly id: "01-content-backend";
+        readonly type: "book";
+        readonly title: "Content Backend";
+        readonly summary: "Recommended integration pattern: BFFs and agent runtimes share Catalox as the content/metadata API.";
+        readonly aliases: readonly ["CASE FILE · CAT-01"];
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["integration", "bff", "agents"];
+        readonly goals: readonly [];
+        readonly path: "books/01-content-backend/";
+        readonly webPath: "/books/01-content-backend";
+        readonly prerequisites: readonly [];
+        readonly related: readonly [];
+        readonly packIds: readonly [];
+    }, {
+        readonly id: "02-persistence";
+        readonly type: "book";
+        readonly title: "Persistence";
+        readonly summary: "createCataloxFromEnv, collection layout, env vars, and operator notes for Mongo-backed estates.";
+        readonly aliases: readonly ["CASE FILE · CAT-02"];
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["mongo", "storage", "ops"];
+        readonly goals: readonly [];
+        readonly path: "books/02-persistence/";
+        readonly webPath: "/books/02-persistence";
+        readonly prerequisites: readonly [];
+        readonly related: readonly [];
+        readonly packIds: readonly [];
+    }, {
+        readonly id: "03-deploy-ops";
+        readonly type: "book";
+        readonly title: "Deploy & Ops";
+        readonly summary: "Deployment modes, private vs public HTTP, onboarding happy path, and environment reference.";
+        readonly aliases: readonly ["CASE FILE · CAT-03"];
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["deploy", "http", "onboarding"];
+        readonly goals: readonly [];
+        readonly path: "books/03-deploy-ops/";
+        readonly webPath: "/books/03-deploy-ops";
+        readonly prerequisites: readonly [];
+        readonly related: readonly [];
+        readonly packIds: readonly [];
+    }, {
+        readonly id: "04-auth-identity";
+        readonly type: "book";
+        readonly title: "Auth & Identity";
+        readonly summary: "Orthogonal identity axes, superAdmin, catalog/item visibility, and empty vs denied vs misconfigured.";
+        readonly aliases: readonly ["CASE FILE · CAT-04"];
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["auth", "identity", "bindings"];
+        readonly goals: readonly [];
+        readonly path: "books/04-auth-identity/";
+        readonly webPath: "/books/04-auth-identity";
+        readonly prerequisites: readonly [];
+        readonly related: readonly [];
+        readonly packIds: readonly [];
+    }, {
+        readonly id: "05-cli-toolbox";
+        readonly type: "book";
+        readonly title: "CLI & Toolbox";
+        readonly summary: "Elevated CLI access, items CRUD, toolbox diagnostics, and seed workflows.";
+        readonly aliases: readonly ["CASE FILE · CAT-05"];
+        readonly audiences: readonly ["developers"];
+        readonly tags: readonly ["cli", "ops", "seed"];
+        readonly goals: readonly [];
+        readonly path: "books/05-cli-toolbox/";
+        readonly webPath: "/books/05-cli-toolbox";
+        readonly prerequisites: readonly [];
+        readonly related: readonly [];
+        readonly packIds: readonly [];
+    }];
+};
+export declare const files: Record<string, string>;
+//# sourceMappingURL=bundle.d.ts.map