@contractspec/bundle.library 0.0.0-canary-20260206014742

package/dist/components/docs/knowledge/KnowledgeExamplesPage.js

@@ -0,0 +1,277 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import Link from "@contractspec/lib.ui-link";
+
+//#region src/components/docs/knowledge/KnowledgeExamplesPage.tsx
+function KnowledgeExamplesPage() {
+	return /* @__PURE__ */ jsxs("div", {
+		className: "space-y-8",
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [/* @__PURE__ */ jsx("h1", {
+					className: "text-4xl font-bold",
+					children: "Knowledge Examples"
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground",
+					children: "Real-world examples of how different applications use knowledge spaces to power intelligent workflows and agents."
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-6",
+				children: [
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-4",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Example 1: ArtisanOS Support Agent"
+							}),
+							/* @__PURE__ */ jsxs("p", {
+								className: "text-muted-foreground",
+								children: [/* @__PURE__ */ jsx("strong", { children: "Context:" }), " ArtisanOS needs a support agent that can answer product questions using official documentation and learn from past support tickets."]
+							}),
+							/* @__PURE__ */ jsx("div", {
+								className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
+								children: /* @__PURE__ */ jsx("pre", { children: `// Knowledge spaces
+knowledgeSpaces: [
+  {
+    id: "product-canon",
+    category: "canonical",
+    sources: [
+      { kind: "notion", location: "product-docs" },
+      { kind: "database-query", location: "SELECT * FROM features" }
+    ]
+  },
+  {
+    id: "support-history",
+    category: "operational",
+    sources: [
+      { kind: "email", location: "support@artisanos.com" },
+      { kind: "slack", location: "#support-channel" }
+    ]
+  }
+]
+
+// Workflow
+workflowId: answer-support-question
+steps:
+  - id: embed-question
+    capability: openai-embeddings
+    inputs:
+      text: $\{input.question}
+  
+  - id: search-canon
+    capability: vector.search
+    inputs:
+      collection: "product-canon"
+      vector: $\{steps.embed-question.output.embedding}
+      limit: 5
+  
+  - id: search-history
+    capability: vector.search
+    inputs:
+      collection: "support-history"
+      vector: $\{steps.embed-question.output.embedding}
+      limit: 3
+  
+  - id: generate-answer
+    capability: openai-chat
+    inputs:
+      messages:
+        - role: "system"
+          content: |
+            Answer using canonical docs as authority.
+            Use support history for helpful context.
+        - role: "user"
+          content: |
+            Question: $\{input.question}
+            Docs: $\{steps.search-canon.output.results}
+            History: $\{steps.search-history.output.results}` })
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-4",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Example 2: HCircle Invoice Generation"
+							}),
+							/* @__PURE__ */ jsxs("p", {
+								className: "text-muted-foreground",
+								children: [/* @__PURE__ */ jsx("strong", { children: "Context:" }), " HCircle needs to generate invoices using house playbook rules and resident service history."]
+							}),
+							/* @__PURE__ */ jsx("div", {
+								className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
+								children: /* @__PURE__ */ jsx("pre", { children: `// Knowledge spaces
+knowledgeSpaces: [
+  {
+    id: "house-playbook",
+    category: "canonical",
+    sources: [
+      { kind: "uploaded-document", location: "playbook.pdf" },
+      { kind: "database-query", location: "SELECT * FROM pricing_rules" }
+    ]
+  },
+  {
+    id: "resident-history",
+    category: "operational",
+    sources: [
+      { kind: "database-query", location: "SELECT * FROM services" },
+      { kind: "database-query", location: "SELECT * FROM invoices" }
+    ]
+  }
+]
+
+// Workflow
+workflowId: generate-invoice
+steps:
+  - id: fetch-services
+    capability: database.query
+    inputs:
+      query: "SELECT * FROM services WHERE resident_id = ?"
+      params: [$\{input.residentId}]
+  
+  - id: search-pricing-rules
+    capability: vector.search
+    inputs:
+      collection: "house-playbook"
+      query: "pricing rules for $\{steps.fetch-services.output.serviceType}"
+      limit: 3
+  
+  - id: calculate-total
+    capability: calculate
+    inputs:
+      services: $\{steps.fetch-services.output.rows}
+      rules: $\{steps.search-pricing-rules.output.results}
+  
+  - id: create-invoice
+    capability: database.insert
+    inputs:
+      table: "invoices"
+      data: $\{steps.calculate-total.output}` })
+							})
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-4",
+						children: [
+							/* @__PURE__ */ jsx("h2", {
+								className: "text-2xl font-bold",
+								children: "Example 3: Multi-tenant SaaS with External Docs"
+							}),
+							/* @__PURE__ */ jsxs("p", {
+								className: "text-muted-foreground",
+								children: [/* @__PURE__ */ jsx("strong", { children: "Context:" }), " A SaaS platform needs to help users integrate with Stripe, using both internal guides and Stripe's official documentation."]
+							}),
+							/* @__PURE__ */ jsx("div", {
+								className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
+								children: /* @__PURE__ */ jsx("pre", { children: `// Knowledge spaces
+knowledgeSpaces: [
+  {
+    id: "integration-guides",
+    category: "canonical",
+    sources: [
+      { kind: "notion", location: "integration-guides" }
+    ]
+  },
+  {
+    id: "stripe-docs",
+    category: "external",
+    sources: [
+      { kind: "url", location: "https://stripe.com/docs" }
+    ]
+  },
+  {
+    id: "customer-questions",
+    category: "operational",
+    sources: [
+      { kind: "email", location: "support@saas.com" }
+    ]
+  }
+]
+
+// Workflow
+workflowId: answer-integration-question
+steps:
+  - id: embed-question
+    capability: openai-embeddings
+    inputs:
+      text: $\{input.question}
+  
+  - id: search-internal-guides
+    capability: vector.search
+    inputs:
+      collection: "integration-guides"
+      vector: $\{steps.embed-question.output.embedding}
+      limit: 3
+  
+  - id: search-stripe-docs
+    capability: vector.search
+    inputs:
+      collection: "stripe-docs"
+      vector: $\{steps.embed-question.output.embedding}
+      limit: 2
+  
+  - id: search-past-questions
+    capability: vector.search
+    inputs:
+      collection: "customer-questions"
+      vector: $\{steps.embed-question.output.embedding}
+      limit: 2
+  
+  - id: generate-answer
+    capability: openai-chat
+    inputs:
+      messages:
+        - role: "system"
+          content: |
+            Prioritize internal guides (authoritative).
+            Use Stripe docs for API details (reference).
+            Use past questions for common issues (context).
+        - role: "user"
+          content: |
+            Question: $\{input.question}
+            Internal: $\{steps.search-internal-guides.output.results}
+            Stripe: $\{steps.search-stripe-docs.output.results}
+            Past: $\{steps.search-past-questions.output.results}` })
+							})
+						]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [/* @__PURE__ */ jsx("h2", {
+					className: "text-2xl font-bold",
+					children: "Key patterns"
+				}), /* @__PURE__ */ jsxs("ul", {
+					className: "text-muted-foreground list-inside list-disc space-y-2",
+					children: [
+						/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Canonical first" }), " - Always search canonical spaces before operational or external"] }),
+						/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Category-aware prompts" }), " - Tell the LLM which sources are authoritative vs reference"] }),
+						/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Multi-space queries" }), " - Combine results from multiple spaces for richer context"] }),
+						/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Limit results" }), " - Use appropriate limits (3-5) to avoid token overflow"] }),
+						/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Audit everything" }), " - Log all knowledge queries for debugging and compliance"] })
+					]
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-4 pt-4",
+				children: [/* @__PURE__ */ jsx(Link, {
+					href: "/docs/knowledge/sources",
+					className: "btn-ghost",
+					children: "Previous: Sources"
+				}), /* @__PURE__ */ jsx(Link, {
+					href: "/docs/architecture/knowledge-binding",
+					className: "btn-ghost",
+					children: "Knowledge Binding"
+				})]
+			})
+		]
+	});
+}
+
+//#endregion
+export { KnowledgeExamplesPage };
+//# sourceMappingURL=KnowledgeExamplesPage.js.map

package/dist/components/docs/knowledge/KnowledgeExamplesPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnowledgeExamplesPage.js","names":[],"sources":["../../../../src/components/docs/knowledge/KnowledgeExamplesPage.tsx"],"sourcesContent":["import Link from '@contractspec/lib.ui-link';\n\n// export const metadata = {\n//   title: 'Knowledge Examples: ContractSpec Docs',\n//   description:\n//     'Real-world examples of knowledge spaces in ContractSpec applications.',\n// };\n\nexport function KnowledgeExamplesPage() {\n  return (\n    <div className=\"space-y-8\">\n      <div className=\"space-y-4\">\n        <h1 className=\"text-4xl font-bold\">Knowledge Examples</h1>\n        <p className=\"text-muted-foreground\">\n          Real-world examples of how different applications use knowledge spaces\n          to power intelligent workflows and agents.\n        </p>\n      </div>\n\n      <div className=\"space-y-6\">\n        <div className=\"space-y-4\">\n          <h2 className=\"text-2xl font-bold\">\n            Example 1: ArtisanOS Support Agent\n          </h2>\n          <p className=\"text-muted-foreground\">\n            <strong>Context:</strong> ArtisanOS needs a support agent that can\n            answer product questions using official documentation and learn from\n            past support tickets.\n          </p>\n          <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n            <pre>{`// Knowledge spaces\nknowledgeSpaces: [\n  {\n    id: \"product-canon\",\n    category: \"canonical\",\n    sources: [\n      { kind: \"notion\", location: \"product-docs\" },\n      { kind: \"database-query\", location: \"SELECT * FROM features\" }\n    ]\n  },\n  {\n    id: \"support-history\",\n    category: \"operational\",\n    sources: [\n      { kind: \"email\", location: \"support@artisanos.com\" },\n      { kind: \"slack\", location: \"#support-channel\" }\n    ]\n  }\n]\n\n// Workflow\nworkflowId: answer-support-question\nsteps:\n  - id: embed-question\n    capability: openai-embeddings\n    inputs:\n      text: $\\{input.question}\n  \n  - id: search-canon\n    capability: vector.search\n    inputs:\n      collection: \"product-canon\"\n      vector: $\\{steps.embed-question.output.embedding}\n      limit: 5\n  \n  - id: search-history\n    capability: vector.search\n    inputs:\n      collection: \"support-history\"\n      vector: $\\{steps.embed-question.output.embedding}\n      limit: 3\n  \n  - id: generate-answer\n    capability: openai-chat\n    inputs:\n      messages:\n        - role: \"system\"\n          content: |\n            Answer using canonical docs as authority.\n            Use support history for helpful context.\n        - role: \"user\"\n          content: |\n            Question: $\\{input.question}\n            Docs: $\\{steps.search-canon.output.results}\n            History: $\\{steps.search-history.output.results}`}</pre>\n          </div>\n        </div>\n\n        <div className=\"space-y-4\">\n          <h2 className=\"text-2xl font-bold\">\n            Example 2: HCircle Invoice Generation\n          </h2>\n          <p className=\"text-muted-foreground\">\n            <strong>Context:</strong> HCircle needs to generate invoices using\n            house playbook rules and resident service history.\n          </p>\n          <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n            <pre>{`// Knowledge spaces\nknowledgeSpaces: [\n  {\n    id: \"house-playbook\",\n    category: \"canonical\",\n    sources: [\n      { kind: \"uploaded-document\", location: \"playbook.pdf\" },\n      { kind: \"database-query\", location: \"SELECT * FROM pricing_rules\" }\n    ]\n  },\n  {\n    id: \"resident-history\",\n    category: \"operational\",\n    sources: [\n      { kind: \"database-query\", location: \"SELECT * FROM services\" },\n      { kind: \"database-query\", location: \"SELECT * FROM invoices\" }\n    ]\n  }\n]\n\n// Workflow\nworkflowId: generate-invoice\nsteps:\n  - id: fetch-services\n    capability: database.query\n    inputs:\n      query: \"SELECT * FROM services WHERE resident_id = ?\"\n      params: [$\\{input.residentId}]\n  \n  - id: search-pricing-rules\n    capability: vector.search\n    inputs:\n      collection: \"house-playbook\"\n      query: \"pricing rules for $\\{steps.fetch-services.output.serviceType}\"\n      limit: 3\n  \n  - id: calculate-total\n    capability: calculate\n    inputs:\n      services: $\\{steps.fetch-services.output.rows}\n      rules: $\\{steps.search-pricing-rules.output.results}\n  \n  - id: create-invoice\n    capability: database.insert\n    inputs:\n      table: \"invoices\"\n      data: $\\{steps.calculate-total.output}`}</pre>\n          </div>\n        </div>\n\n        <div className=\"space-y-4\">\n          <h2 className=\"text-2xl font-bold\">\n            Example 3: Multi-tenant SaaS with External Docs\n          </h2>\n          <p className=\"text-muted-foreground\">\n            <strong>Context:</strong> A SaaS platform needs to help users\n            integrate with Stripe, using both internal guides and Stripe's\n            official documentation.\n          </p>\n          <div className=\"bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm\">\n            <pre>{`// Knowledge spaces\nknowledgeSpaces: [\n  {\n    id: \"integration-guides\",\n    category: \"canonical\",\n    sources: [\n      { kind: \"notion\", location: \"integration-guides\" }\n    ]\n  },\n  {\n    id: \"stripe-docs\",\n    category: \"external\",\n    sources: [\n      { kind: \"url\", location: \"https://stripe.com/docs\" }\n    ]\n  },\n  {\n    id: \"customer-questions\",\n    category: \"operational\",\n    sources: [\n      { kind: \"email\", location: \"support@saas.com\" }\n    ]\n  }\n]\n\n// Workflow\nworkflowId: answer-integration-question\nsteps:\n  - id: embed-question\n    capability: openai-embeddings\n    inputs:\n      text: $\\{input.question}\n  \n  - id: search-internal-guides\n    capability: vector.search\n    inputs:\n      collection: \"integration-guides\"\n      vector: $\\{steps.embed-question.output.embedding}\n      limit: 3\n  \n  - id: search-stripe-docs\n    capability: vector.search\n    inputs:\n      collection: \"stripe-docs\"\n      vector: $\\{steps.embed-question.output.embedding}\n      limit: 2\n  \n  - id: search-past-questions\n    capability: vector.search\n    inputs:\n      collection: \"customer-questions\"\n      vector: $\\{steps.embed-question.output.embedding}\n      limit: 2\n  \n  - id: generate-answer\n    capability: openai-chat\n    inputs:\n      messages:\n        - role: \"system\"\n          content: |\n            Prioritize internal guides (authoritative).\n            Use Stripe docs for API details (reference).\n            Use past questions for common issues (context).\n        - role: \"user\"\n          content: |\n            Question: $\\{input.question}\n            Internal: $\\{steps.search-internal-guides.output.results}\n            Stripe: $\\{steps.search-stripe-docs.output.results}\n            Past: $\\{steps.search-past-questions.output.results}`}</pre>\n          </div>\n        </div>\n      </div>\n\n      <div className=\"space-y-4\">\n        <h2 className=\"text-2xl font-bold\">Key patterns</h2>\n        <ul className=\"text-muted-foreground list-inside list-disc space-y-2\">\n          <li>\n            <strong>Canonical first</strong> - Always search canonical spaces\n            before operational or external\n          </li>\n          <li>\n            <strong>Category-aware prompts</strong> - Tell the LLM which sources\n            are authoritative vs reference\n          </li>\n          <li>\n            <strong>Multi-space queries</strong> - Combine results from multiple\n            spaces for richer context\n          </li>\n          <li>\n            <strong>Limit results</strong> - Use appropriate limits (3-5) to\n            avoid token overflow\n          </li>\n          <li>\n            <strong>Audit everything</strong> - Log all knowledge queries for\n            debugging and compliance\n          </li>\n        </ul>\n      </div>\n\n      <div className=\"flex items-center gap-4 pt-4\">\n        <Link href=\"/docs/knowledge/sources\" className=\"btn-ghost\">\n          Previous: Sources\n        </Link>\n        <Link href=\"/docs/architecture/knowledge-binding\" className=\"btn-ghost\">\n          Knowledge Binding\n        </Link>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;AAQA,SAAgB,wBAAwB;AACtC,QACE,qBAAC;EAAI,WAAU;;GACb,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAuB,EAC1D,oBAAC;KAAE,WAAU;eAAwB;MAGjC;KACA;GAEN,qBAAC;IAAI,WAAU;;KACb,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAE9B;OACL,qBAAC;QAAE,WAAU;mBACX,oBAAC,sBAAO,aAAiB;SAGvB;OACJ,oBAAC;QAAI,WAAU;kBACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEAsDkD;SACpD;;OACF;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAE9B;OACL,qBAAC;QAAE,WAAU;mBACX,oBAAC,sBAAO,aAAiB;SAEvB;OACJ,oBAAC;QAAI,WAAU;kBACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gDA8CkC;SACpC;;OACF;KAEN,qBAAC;MAAI,WAAU;;OACb,oBAAC;QAAG,WAAU;kBAAqB;SAE9B;OACL,qBAAC;QAAE,WAAU;mBACX,oBAAC,sBAAO,aAAiB;SAGvB;OACJ,oBAAC;QAAI,WAAU;kBACb,oBAAC,mBAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oEAoEsD;SACxD;;OACF;;KACF;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAG,WAAU;eAAqB;MAAiB,EACpD,qBAAC;KAAG,WAAU;;MACZ,qBAAC,mBACC,oBAAC,sBAAO,oBAAwB,wEAE7B;MACL,qBAAC,mBACC,oBAAC,sBAAO,2BAA+B,oEAEpC;MACL,qBAAC,mBACC,oBAAC,sBAAO,wBAA4B,kEAEjC;MACL,qBAAC,mBACC,oBAAC,sBAAO,kBAAsB,+DAE3B;MACL,qBAAC,mBACC,oBAAC,sBAAO,qBAAyB,iEAE9B;;MACF;KACD;GAEN,qBAAC;IAAI,WAAU;eACb,oBAAC;KAAK,MAAK;KAA0B,WAAU;eAAY;MAEpD,EACP,oBAAC;KAAK,MAAK;KAAuC,WAAU;eAAY;MAEjE;KACH;;GACF"}

package/dist/components/docs/knowledge/KnowledgeOverviewPage.d.ts

@@ -0,0 +1,7 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/docs/knowledge/KnowledgeOverviewPage.d.ts
+declare function KnowledgeOverviewPage(): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { KnowledgeOverviewPage };
+//# sourceMappingURL=KnowledgeOverviewPage.d.ts.map

package/dist/components/docs/knowledge/KnowledgeOverviewPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnowledgeOverviewPage.d.ts","names":[],"sources":["../../../../src/components/docs/knowledge/KnowledgeOverviewPage.tsx"],"mappings":";;;iBASgB,qBAAA,CAAA,GAAqB,kBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/components/docs/knowledge/KnowledgeOverviewPage.js

@@ -0,0 +1,354 @@
+import { ChevronRight } from "lucide-react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import Link from "@contractspec/lib.ui-link";
+
+//#region src/components/docs/knowledge/KnowledgeOverviewPage.tsx
+function KnowledgeOverviewPage() {
+	return /* @__PURE__ */ jsxs("div", {
+		className: "space-y-8",
+		children: [
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [/* @__PURE__ */ jsx("h1", {
+					className: "text-4xl font-bold",
+					children: "Knowledge & Context"
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground",
+					children: "ContractSpec provides first-class support for knowledge management, enabling semantic search, RAG (Retrieval-Augmented Generation), and context-aware decision-making. Knowledge is organized into typed spaces with different trust levels and access controls."
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "Why knowledge matters"
+					}),
+					/* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground",
+						children: "Modern applications need to:"
+					}),
+					/* @__PURE__ */ jsxs("ul", {
+						className: "text-muted-foreground list-inside list-disc space-y-2",
+						children: [
+							/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Understand context" }), " - Access relevant information to make informed decisions"] }),
+							/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Learn from history" }), " - Use past interactions to improve future responses"] }),
+							/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Trust sources" }), " - Distinguish between authoritative and reference information"] }),
+							/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Scale knowledge" }), " - Handle growing amounts of documentation and data"] }),
+							/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Maintain privacy" }), " - Keep tenant knowledge isolated and secure"] })
+						]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "Knowledge architecture"
+					}),
+					/* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground",
+						children: "ContractSpec's knowledge system has three main components:"
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "space-y-6",
+						children: [
+							/* @__PURE__ */ jsxs("div", {
+								className: "card-subtle p-4",
+								children: [
+									/* @__PURE__ */ jsx("h3", {
+										className: "mb-2 text-lg font-semibold",
+										children: "1. Knowledge Categories"
+									}),
+									/* @__PURE__ */ jsx("p", {
+										className: "text-muted-foreground mb-3 text-sm",
+										children: "Four trust levels that determine how knowledge is used:"
+									}),
+									/* @__PURE__ */ jsxs("div", {
+										className: "space-y-2 text-sm",
+										children: [
+											/* @__PURE__ */ jsxs("div", {
+												className: "flex items-start gap-3",
+												children: [/* @__PURE__ */ jsx("code", {
+													className: "bg-background/50 rounded px-2 py-1 text-xs",
+													children: "canonical"
+												}), /* @__PURE__ */ jsx("span", {
+													className: "text-muted-foreground",
+													children: "Ground truth - product specs, schemas, official policies"
+												})]
+											}),
+											/* @__PURE__ */ jsxs("div", {
+												className: "flex items-start gap-3",
+												children: [/* @__PURE__ */ jsx("code", {
+													className: "bg-background/50 rounded px-2 py-1 text-xs",
+													children: "operational"
+												}), /* @__PURE__ */ jsx("span", {
+													className: "text-muted-foreground",
+													children: "Internal docs - support tickets, runbooks, sales materials"
+												})]
+											}),
+											/* @__PURE__ */ jsxs("div", {
+												className: "flex items-start gap-3",
+												children: [/* @__PURE__ */ jsx("code", {
+													className: "bg-background/50 rounded px-2 py-1 text-xs",
+													children: "external"
+												}), /* @__PURE__ */ jsx("span", {
+													className: "text-muted-foreground",
+													children: "Third-party - PSP docs, regulations, integration guides"
+												})]
+											}),
+											/* @__PURE__ */ jsxs("div", {
+												className: "flex items-start gap-3",
+												children: [/* @__PURE__ */ jsx("code", {
+													className: "bg-background/50 rounded px-2 py-1 text-xs",
+													children: "ephemeral"
+												}), /* @__PURE__ */ jsx("span", {
+													className: "text-muted-foreground",
+													children: "Temporary - agent scratchpads, session context, drafts"
+												})]
+											})
+										]
+									}),
+									/* @__PURE__ */ jsx(Link, {
+										href: "/docs/knowledge/categories",
+										className: "mt-3 inline-block text-sm text-violet-400 hover:text-violet-300",
+										children: "Learn more about categories →"
+									})
+								]
+							}),
+							/* @__PURE__ */ jsxs("div", {
+								className: "card-subtle p-4",
+								children: [
+									/* @__PURE__ */ jsx("h3", {
+										className: "mb-2 text-lg font-semibold",
+										children: "2. Knowledge Spaces"
+									}),
+									/* @__PURE__ */ jsx("p", {
+										className: "text-muted-foreground mb-3 text-sm",
+										children: "Logical domains of knowledge defined globally:"
+									}),
+									/* @__PURE__ */ jsx("div", {
+										className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs",
+										children: /* @__PURE__ */ jsx("pre", { children: `type KnowledgeSpaceSpec = {
+  id: string;
+  label: string;
+  category: KnowledgeCategory;
+  storageStrategy: "vector" | "search" | "hybrid";
+  indexProvider: string;  // e.g., "qdrant"
+  retentionPolicy: { days?: number };
+  intendedAudience: "agents" | "humans" | "admin-only";
+};` })
+									}),
+									/* @__PURE__ */ jsx(Link, {
+										href: "/docs/knowledge/spaces",
+										className: "mt-3 inline-block text-sm text-violet-400 hover:text-violet-300",
+										children: "Learn more about spaces →"
+									})
+								]
+							}),
+							/* @__PURE__ */ jsxs("div", {
+								className: "card-subtle p-4",
+								children: [
+									/* @__PURE__ */ jsx("h3", {
+										className: "mb-2 text-lg font-semibold",
+										children: "3. Knowledge Sources"
+									}),
+									/* @__PURE__ */ jsx("p", {
+										className: "text-muted-foreground mb-3 text-sm",
+										children: "Per-tenant data sources that feed knowledge spaces:"
+									}),
+									/* @__PURE__ */ jsx("div", {
+										className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs",
+										children: /* @__PURE__ */ jsx("pre", { children: `type KnowledgeSourceConfig = {
+  id: string;
+  tenantId: string;
+  spaceId: string;
+  kind: "uploaded-document" | "url" | "email" 
+        | "notion" | "database-query" | "raw-text";
+  location: string;
+  syncPolicy: { interval?: string; webhook?: boolean };
+  lastSyncedAt?: string;
+};` })
+									}),
+									/* @__PURE__ */ jsx(Link, {
+										href: "/docs/knowledge/sources",
+										className: "mt-3 inline-block text-sm text-violet-400 hover:text-violet-300",
+										children: "Learn more about sources →"
+									})
+								]
+							})
+						]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "How it works"
+					}),
+					/* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground",
+						children: "Knowledge flows through ContractSpec in four stages:"
+					}),
+					/* @__PURE__ */ jsxs("ol", {
+						className: "text-muted-foreground list-inside list-decimal space-y-3",
+						children: [
+							/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Define spaces" }), " - Create KnowledgeSpaceSpec for each logical domain (e.g., \"Product Canon\", \"Support FAQ\")"] }),
+							/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Configure sources" }), " - Tenants connect their data sources (Notion, Gmail, uploads, etc.)"] }),
+							/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Sync & index" }), " - Sources are synced, chunked, and indexed in vector databases"] }),
+							/* @__PURE__ */ jsxs("li", { children: [/* @__PURE__ */ jsx("strong", { children: "Query & retrieve" }), " - Workflows and agents perform semantic search to find relevant context"] })
+						]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [/* @__PURE__ */ jsx("h2", {
+					className: "text-2xl font-bold",
+					children: "Use cases"
+				}), /* @__PURE__ */ jsxs("div", {
+					className: "grid gap-4 md:grid-cols-2",
+					children: [
+						/* @__PURE__ */ jsxs("div", {
+							className: "card-subtle p-4",
+							children: [/* @__PURE__ */ jsx("h3", {
+								className: "mb-2 font-semibold",
+								children: "Support Agents"
+							}), /* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground text-sm",
+								children: "Answer customer questions using product documentation (canonical) and past support tickets (operational)."
+							})]
+						}),
+						/* @__PURE__ */ jsxs("div", {
+							className: "card-subtle p-4",
+							children: [/* @__PURE__ */ jsx("h3", {
+								className: "mb-2 font-semibold",
+								children: "Invoice Generation"
+							}), /* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground text-sm",
+								children: "Generate invoices using product catalog (canonical) and pricing rules (operational)."
+							})]
+						}),
+						/* @__PURE__ */ jsxs("div", {
+							className: "card-subtle p-4",
+							children: [/* @__PURE__ */ jsx("h3", {
+								className: "mb-2 font-semibold",
+								children: "Compliance Checking"
+							}), /* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground text-sm",
+								children: "Validate operations against regulatory requirements (external) and internal policies (canonical)."
+							})]
+						}),
+						/* @__PURE__ */ jsxs("div", {
+							className: "card-subtle p-4",
+							children: [/* @__PURE__ */ jsx("h3", {
+								className: "mb-2 font-semibold",
+								children: "Semantic Search"
+							}), /* @__PURE__ */ jsx("p", {
+								className: "text-muted-foreground text-sm",
+								children: "Find relevant documents, tickets, or records using natural language queries."
+							})]
+						})
+					]
+				})]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "Integration with workflows"
+					}),
+					/* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground",
+						children: "Knowledge spaces are consumed by workflows through standard capabilities:"
+					}),
+					/* @__PURE__ */ jsx("div", {
+						className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
+						children: /* @__PURE__ */ jsx("pre", { children: `import { defineWorkflow } from '@contractspec/lib.contracts';
+import { OpenAIEmbeddings, VectorSearch, OpenAIChat } from './specs';
+
+export const AnswerSupportQuestion = defineWorkflow({
+  meta: {
+    key: 'support.answerQuestion',
+    version: '1.0.0',
+    description: 'Answer support questions using RAG',
+    owners: ['team-support'],
+    tags: ['ai', 'support'],
+    stability: 'stable',
+  },
+  steps: [
+    {
+      id: 'embed-question',
+      operation: OpenAIEmbeddings,
+      inputs: (ctx, input) => ({
+        text: input.question,
+      }),
+    },
+    {
+      id: 'search-knowledge',
+      operation: VectorSearch,
+      inputs: (ctx, input, steps) => ({
+        collection: 'product-canon', // KnowledgeSpace
+        vector: steps['embed-question'].output.embedding,
+        limit: 5,
+      }),
+    },
+    {
+      id: 'generate-answer',
+      operation: OpenAIChat,
+      inputs: (ctx, input, steps) => ({
+        messages: [
+          { role: 'system', content: 'Answer using the provided context' },
+          { 
+            role: 'user', 
+            content: \`Context: \${steps['search-knowledge'].output.results}\\nQuestion: \${input.question}\`
+          },
+        ],
+      }),
+    },
+  ],
+});` })
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "space-y-4",
+				children: [
+					/* @__PURE__ */ jsx("h2", {
+						className: "text-2xl font-bold",
+						children: "Real-world examples"
+					}),
+					/* @__PURE__ */ jsx("p", {
+						className: "text-muted-foreground",
+						children: "See how different applications use knowledge spaces:"
+					}),
+					/* @__PURE__ */ jsxs(Link, {
+						href: "/docs/knowledge/examples",
+						className: "btn-primary inline-flex items-center gap-2",
+						children: ["View Examples ", /* @__PURE__ */ jsx(ChevronRight, { size: 16 })]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "flex items-center gap-4 pt-4",
+				children: [/* @__PURE__ */ jsxs(Link, {
+					href: "/docs/knowledge/categories",
+					className: "btn-primary",
+					children: ["Knowledge Categories ", /* @__PURE__ */ jsx(ChevronRight, { size: 16 })]
+				}), /* @__PURE__ */ jsx(Link, {
+					href: "/docs/knowledge/spaces",
+					className: "btn-ghost",
+					children: "Knowledge Spaces"
+				})]
+			})
+		]
+	});
+}
+
+//#endregion
+export { KnowledgeOverviewPage };
+//# sourceMappingURL=KnowledgeOverviewPage.js.map