@contractspec/bundle.library 3.7.6 → 3.8.2

package/dist/node/components/docs/knowledge/index.js

@@ -1,8 +1,8 @@
-// src/components/docs/knowledge/KnowledgeOverviewPage.tsx
+// src/components/docs/knowledge/KnowledgeCategoriesPage.tsx
 import Link from "@contractspec/lib.ui-link";
 import { ChevronRight } from "lucide-react";
 import { jsx, jsxs } from "react/jsx-runtime";
-function KnowledgeOverviewPage() {
+function KnowledgeCategoriesPage() {
   return /* @__PURE__ */ jsxs("div", {
     className: "space-y-8",
     children: [
@@ -10,344 +10,12 @@ function KnowledgeOverviewPage() {
         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"
+            className: "font-bold text-4xl",
+            children: "Knowledge Categories"
           }),
           /* @__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."
-                  })
-                ]
-              })
-            ]
+            children: "ContractSpec classifies knowledge into four categories based on trust level, source authority, and intended use. This classification determines how knowledge can be used in workflows, policy decisions, and agent responses."
           })
         ]
       }),
@@ -355,142 +23,12 @@ function KnowledgeOverviewPage() {
         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:"
+            className: "font-bold text-2xl",
+            children: "The four categories"
           }),
           /* @__PURE__ */ jsx("div", {
-            className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
+            className: "overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm",
             children: /* @__PURE__ */ jsx("pre", {
-              children: `import { defineWorkflow } from '@contractspec/lib.contracts-spec/workflow';
-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"
-          })
-        ]
-      })
-    ]
-  });
-}
-
-// src/components/docs/knowledge/KnowledgeCategoriesPage.tsx
-import Link2 from "@contractspec/lib.ui-link";
-import { ChevronRight as ChevronRight2 } from "lucide-react";
-import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
-function KnowledgeCategoriesPage() {
-  return /* @__PURE__ */ jsxs2("div", {
-    className: "space-y-8",
-    children: [
-      /* @__PURE__ */ jsxs2("div", {
-        className: "space-y-4",
-        children: [
-          /* @__PURE__ */ jsx2("h1", {
-            className: "text-4xl font-bold",
-            children: "Knowledge Categories"
-          }),
-          /* @__PURE__ */ jsx2("p", {
-            className: "text-muted-foreground",
-            children: "ContractSpec classifies knowledge into four categories based on trust level, source authority, and intended use. This classification determines how knowledge can be used in workflows, policy decisions, and agent responses."
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs2("div", {
-        className: "space-y-4",
-        children: [
-          /* @__PURE__ */ jsx2("h2", {
-            className: "text-2xl font-bold",
-            children: "The four categories"
-          }),
-          /* @__PURE__ */ jsx2("div", {
-            className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
-            children: /* @__PURE__ */ jsx2("pre", {
               children: `type KnowledgeCategory =
   | "canonical"   // Internal ground truth
   | "operational" // Internal operational docs
@@ -500,92 +38,92 @@ function KnowledgeCategoriesPage() {
           })
         ]
       }),
-      /* @__PURE__ */ jsxs2("div", {
+      /* @__PURE__ */ jsxs("div", {
         className: "space-y-6",
         children: [
-          /* @__PURE__ */ jsxs2("div", {
+          /* @__PURE__ */ jsxs("div", {
             className: "space-y-4",
             children: [
-              /* @__PURE__ */ jsx2("h3", {
-                className: "text-xl font-semibold",
+              /* @__PURE__ */ jsx("h3", {
+                className: "font-semibold text-xl",
                 children: "1. Canonical"
               }),
-              /* @__PURE__ */ jsxs2("p", {
+              /* @__PURE__ */ jsxs("p", {
                 className: "text-muted-foreground",
                 children: [
-                  /* @__PURE__ */ jsx2("strong", {
+                  /* @__PURE__ */ jsx("strong", {
                     children: "Trust level:"
                   }),
                   " Highest - Authoritative ground truth"
                 ]
               }),
-              /* @__PURE__ */ jsxs2("div", {
+              /* @__PURE__ */ jsxs("div", {
                 className: "space-y-3",
                 children: [
-                  /* @__PURE__ */ jsxs2("div", {
+                  /* @__PURE__ */ jsxs("div", {
                     children: [
-                      /* @__PURE__ */ jsx2("h4", {
-                        className: "mb-2 text-sm font-semibold",
+                      /* @__PURE__ */ jsx("h4", {
+                        className: "mb-2 font-semibold text-sm",
                         children: "What it contains:"
                       }),
-                      /* @__PURE__ */ jsxs2("ul", {
-                        className: "text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm",
+                      /* @__PURE__ */ jsxs("ul", {
+                        className: "ml-4 list-inside list-disc space-y-1 text-muted-foreground text-sm",
                         children: [
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Official product specifications and schemas"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Company policies and procedures"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Legal terms and compliance requirements"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Pricing rules and business logic"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Data classification and security policies"
                           })
                         ]
                       })
                     ]
                   }),
-                  /* @__PURE__ */ jsxs2("div", {
+                  /* @__PURE__ */ jsxs("div", {
                     children: [
-                      /* @__PURE__ */ jsx2("h4", {
-                        className: "mb-2 text-sm font-semibold",
+                      /* @__PURE__ */ jsx("h4", {
+                        className: "mb-2 font-semibold text-sm",
                         children: "How it's used:"
                       }),
-                      /* @__PURE__ */ jsxs2("ul", {
-                        className: "text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm",
+                      /* @__PURE__ */ jsxs("ul", {
+                        className: "ml-4 list-inside list-disc space-y-1 text-muted-foreground text-sm",
                         children: [
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Policy decisions"
                               }),
                               " - Can drive PDP decisions"
                             ]
                           }),
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Validation"
                               }),
                               " - Used to validate user inputs and operations"
                             ]
                           }),
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Code generation"
                               }),
                               " - Source of truth for generated code"
                             ]
                           }),
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Compliance"
                               }),
                               " - Reference for audit and regulatory checks"
@@ -595,15 +133,15 @@ function KnowledgeCategoriesPage() {
                       })
                     ]
                   }),
-                  /* @__PURE__ */ jsxs2("div", {
+                  /* @__PURE__ */ jsxs("div", {
                     children: [
-                      /* @__PURE__ */ jsx2("h4", {
-                        className: "mb-2 text-sm font-semibold",
+                      /* @__PURE__ */ jsx("h4", {
+                        className: "mb-2 font-semibold text-sm",
                         children: "Examples:"
                       }),
-                      /* @__PURE__ */ jsx2("div", {
-                        className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs",
-                        children: /* @__PURE__ */ jsx2("pre", {
+                      /* @__PURE__ */ jsx("div", {
+                        className: "overflow-x-auto rounded border border-border bg-background/50 p-3 font-mono text-muted-foreground text-xs",
+                        children: /* @__PURE__ */ jsx("pre", {
                           children: `// Product Canon space
 {
   id: "product-canon",
@@ -629,12 +167,12 @@ function KnowledgeCategoriesPage() {
                       })
                     ]
                   }),
-                  /* @__PURE__ */ jsx2("div", {
+                  /* @__PURE__ */ jsx("div", {
                     className: "card-subtle border-violet-500/30 bg-violet-500/10 p-3",
-                    children: /* @__PURE__ */ jsxs2("p", {
+                    children: /* @__PURE__ */ jsxs("p", {
                       className: "text-sm text-violet-300",
                       children: [
-                        /* @__PURE__ */ jsx2("strong", {
+                        /* @__PURE__ */ jsx("strong", {
                           children: "⚠️ Important:"
                         }),
                         " Canonical knowledge is immutable once indexed. Changes require re-sync and versioning."
@@ -645,89 +183,89 @@ function KnowledgeCategoriesPage() {
               })
             ]
           }),
-          /* @__PURE__ */ jsxs2("div", {
+          /* @__PURE__ */ jsxs("div", {
             className: "space-y-4",
             children: [
-              /* @__PURE__ */ jsx2("h3", {
-                className: "text-xl font-semibold",
+              /* @__PURE__ */ jsx("h3", {
+                className: "font-semibold text-xl",
                 children: "2. Operational"
               }),
-              /* @__PURE__ */ jsxs2("p", {
+              /* @__PURE__ */ jsxs("p", {
                 className: "text-muted-foreground",
                 children: [
-                  /* @__PURE__ */ jsx2("strong", {
+                  /* @__PURE__ */ jsx("strong", {
                     children: "Trust level:"
                   }),
                   " High - Internal but not authoritative"
                 ]
               }),
-              /* @__PURE__ */ jsxs2("div", {
+              /* @__PURE__ */ jsxs("div", {
                 className: "space-y-3",
                 children: [
-                  /* @__PURE__ */ jsxs2("div", {
+                  /* @__PURE__ */ jsxs("div", {
                     children: [
-                      /* @__PURE__ */ jsx2("h4", {
-                        className: "mb-2 text-sm font-semibold",
+                      /* @__PURE__ */ jsx("h4", {
+                        className: "mb-2 font-semibold text-sm",
                         children: "What it contains:"
                       }),
-                      /* @__PURE__ */ jsxs2("ul", {
-                        className: "text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm",
+                      /* @__PURE__ */ jsxs("ul", {
+                        className: "ml-4 list-inside list-disc space-y-1 text-muted-foreground text-sm",
                         children: [
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Support ticket history and resolutions"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Internal runbooks and playbooks"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Sales materials and customer communications"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Product management docs and roadmaps"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Team wikis and knowledge bases"
                           })
                         ]
                       })
                     ]
                   }),
-                  /* @__PURE__ */ jsxs2("div", {
+                  /* @__PURE__ */ jsxs("div", {
                     children: [
-                      /* @__PURE__ */ jsx2("h4", {
-                        className: "mb-2 text-sm font-semibold",
+                      /* @__PURE__ */ jsx("h4", {
+                        className: "mb-2 font-semibold text-sm",
                         children: "How it's used:"
                       }),
-                      /* @__PURE__ */ jsxs2("ul", {
-                        className: "text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm",
+                      /* @__PURE__ */ jsxs("ul", {
+                        className: "ml-4 list-inside list-disc space-y-1 text-muted-foreground text-sm",
                         children: [
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Context"
                               }),
                               " - Provides helpful context for decisions"
                             ]
                           }),
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Suggestions"
                               }),
                               " - Informs recommendations, not requirements"
                             ]
                           }),
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Learning"
                               }),
                               " - Helps agents learn from past interactions"
                             ]
                           }),
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Troubleshooting"
                               }),
                               " - Guides problem-solving workflows"
@@ -737,15 +275,15 @@ function KnowledgeCategoriesPage() {
                       })
                     ]
                   }),
-                  /* @__PURE__ */ jsxs2("div", {
+                  /* @__PURE__ */ jsxs("div", {
                     children: [
-                      /* @__PURE__ */ jsx2("h4", {
-                        className: "mb-2 text-sm font-semibold",
+                      /* @__PURE__ */ jsx("h4", {
+                        className: "mb-2 font-semibold text-sm",
                         children: "Examples:"
                       }),
-                      /* @__PURE__ */ jsx2("div", {
-                        className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs",
-                        children: /* @__PURE__ */ jsx2("pre", {
+                      /* @__PURE__ */ jsx("div", {
+                        className: "overflow-x-auto rounded border border-border bg-background/50 p-3 font-mono text-muted-foreground text-xs",
+                        children: /* @__PURE__ */ jsx("pre", {
                           children: `// Support History space
 {
   id: "support-history",
@@ -775,89 +313,89 @@ function KnowledgeCategoriesPage() {
               })
             ]
           }),
-          /* @__PURE__ */ jsxs2("div", {
+          /* @__PURE__ */ jsxs("div", {
             className: "space-y-4",
             children: [
-              /* @__PURE__ */ jsx2("h3", {
-                className: "text-xl font-semibold",
+              /* @__PURE__ */ jsx("h3", {
+                className: "font-semibold text-xl",
                 children: "3. External"
               }),
-              /* @__PURE__ */ jsxs2("p", {
+              /* @__PURE__ */ jsxs("p", {
                 className: "text-muted-foreground",
                 children: [
-                  /* @__PURE__ */ jsx2("strong", {
+                  /* @__PURE__ */ jsx("strong", {
                     children: "Trust level:"
                   }),
                   " Medium - Reference only"
                 ]
               }),
-              /* @__PURE__ */ jsxs2("div", {
+              /* @__PURE__ */ jsxs("div", {
                 className: "space-y-3",
                 children: [
-                  /* @__PURE__ */ jsxs2("div", {
+                  /* @__PURE__ */ jsxs("div", {
                     children: [
-                      /* @__PURE__ */ jsx2("h4", {
-                        className: "mb-2 text-sm font-semibold",
+                      /* @__PURE__ */ jsx("h4", {
+                        className: "mb-2 font-semibold text-sm",
                         children: "What it contains:"
                       }),
-                      /* @__PURE__ */ jsxs2("ul", {
-                        className: "text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm",
+                      /* @__PURE__ */ jsxs("ul", {
+                        className: "ml-4 list-inside list-disc space-y-1 text-muted-foreground text-sm",
                         children: [
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Third-party integration documentation (Stripe, Twilio)"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Regulatory and compliance documents"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Industry standards and best practices"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Public API documentation"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "External knowledge bases"
                           })
                         ]
                       })
                     ]
                   }),
-                  /* @__PURE__ */ jsxs2("div", {
+                  /* @__PURE__ */ jsxs("div", {
                     children: [
-                      /* @__PURE__ */ jsx2("h4", {
-                        className: "mb-2 text-sm font-semibold",
+                      /* @__PURE__ */ jsx("h4", {
+                        className: "mb-2 font-semibold text-sm",
                         children: "How it's used:"
                       }),
-                      /* @__PURE__ */ jsxs2("ul", {
-                        className: "text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm",
+                      /* @__PURE__ */ jsxs("ul", {
+                        className: "ml-4 list-inside list-disc space-y-1 text-muted-foreground text-sm",
                         children: [
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Reference"
                               }),
                               " - Consulted but not authoritative"
                             ]
                           }),
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Integration help"
                               }),
                               " - Guides external API usage"
                             ]
                           }),
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Compliance context"
                               }),
                               " - Provides regulatory background"
                             ]
                           }),
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Never for policy"
                               }),
                               " - Cannot drive policy decisions"
@@ -867,15 +405,15 @@ function KnowledgeCategoriesPage() {
                       })
                     ]
                   }),
-                  /* @__PURE__ */ jsxs2("div", {
+                  /* @__PURE__ */ jsxs("div", {
                     children: [
-                      /* @__PURE__ */ jsx2("h4", {
-                        className: "mb-2 text-sm font-semibold",
+                      /* @__PURE__ */ jsx("h4", {
+                        className: "mb-2 font-semibold text-sm",
                         children: "Examples:"
                       }),
-                      /* @__PURE__ */ jsx2("div", {
-                        className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs",
-                        children: /* @__PURE__ */ jsx2("pre", {
+                      /* @__PURE__ */ jsx("div", {
+                        className: "overflow-x-auto rounded border border-border bg-background/50 p-3 font-mono text-muted-foreground text-xs",
+                        children: /* @__PURE__ */ jsx("pre", {
                           children: `// External Provider Docs space
 {
   id: "provider-docs",
@@ -901,12 +439,12 @@ function KnowledgeCategoriesPage() {
                       })
                     ]
                   }),
-                  /* @__PURE__ */ jsx2("div", {
+                  /* @__PURE__ */ jsx("div", {
                     className: "card-subtle border-amber-500/30 bg-amber-500/10 p-3",
-                    children: /* @__PURE__ */ jsxs2("p", {
-                      className: "text-sm text-amber-300",
+                    children: /* @__PURE__ */ jsxs("p", {
+                      className: "text-amber-300 text-sm",
                       children: [
-                        /* @__PURE__ */ jsx2("strong", {
+                        /* @__PURE__ */ jsx("strong", {
                           children: "⚠️ Note:"
                         }),
                         ` External knowledge should be clearly marked in agent responses as "according to [source]" to indicate it's not internal authority.`
@@ -917,89 +455,89 @@ function KnowledgeCategoriesPage() {
               })
             ]
           }),
-          /* @__PURE__ */ jsxs2("div", {
+          /* @__PURE__ */ jsxs("div", {
             className: "space-y-4",
             children: [
-              /* @__PURE__ */ jsx2("h3", {
-                className: "text-xl font-semibold",
+              /* @__PURE__ */ jsx("h3", {
+                className: "font-semibold text-xl",
                 children: "4. Ephemeral"
               }),
-              /* @__PURE__ */ jsxs2("p", {
+              /* @__PURE__ */ jsxs("p", {
                 className: "text-muted-foreground",
                 children: [
-                  /* @__PURE__ */ jsx2("strong", {
+                  /* @__PURE__ */ jsx("strong", {
                     children: "Trust level:"
                   }),
                   " Low - Temporary context only"
                 ]
               }),
-              /* @__PURE__ */ jsxs2("div", {
+              /* @__PURE__ */ jsxs("div", {
                 className: "space-y-3",
                 children: [
-                  /* @__PURE__ */ jsxs2("div", {
+                  /* @__PURE__ */ jsxs("div", {
                     children: [
-                      /* @__PURE__ */ jsx2("h4", {
-                        className: "mb-2 text-sm font-semibold",
+                      /* @__PURE__ */ jsx("h4", {
+                        className: "mb-2 font-semibold text-sm",
                         children: "What it contains:"
                       }),
-                      /* @__PURE__ */ jsxs2("ul", {
-                        className: "text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm",
+                      /* @__PURE__ */ jsxs("ul", {
+                        className: "ml-4 list-inside list-disc space-y-1 text-muted-foreground text-sm",
                         children: [
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Agent conversation history and scratchpads"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Session-specific context and state"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Draft documents and work-in-progress"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "Temporary calculations and intermediate results"
                           }),
-                          /* @__PURE__ */ jsx2("li", {
+                          /* @__PURE__ */ jsx("li", {
                             children: "User-provided context for current task"
                           })
                         ]
                       })
                     ]
                   }),
-                  /* @__PURE__ */ jsxs2("div", {
+                  /* @__PURE__ */ jsxs("div", {
                     children: [
-                      /* @__PURE__ */ jsx2("h4", {
-                        className: "mb-2 text-sm font-semibold",
+                      /* @__PURE__ */ jsx("h4", {
+                        className: "mb-2 font-semibold text-sm",
                         children: "How it's used:"
                       }),
-                      /* @__PURE__ */ jsxs2("ul", {
-                        className: "text-muted-foreground ml-4 list-inside list-disc space-y-1 text-sm",
+                      /* @__PURE__ */ jsxs("ul", {
+                        className: "ml-4 list-inside list-disc space-y-1 text-muted-foreground text-sm",
                         children: [
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Session continuity"
                               }),
                               " - Maintains conversation context"
                             ]
                           }),
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Working memory"
                               }),
                               " - Stores intermediate results"
                             ]
                           }),
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Never persisted long-term"
                               }),
                               " - Auto-purged after session"
                             ]
                           }),
-                          /* @__PURE__ */ jsxs2("li", {
+                          /* @__PURE__ */ jsxs("li", {
                             children: [
-                              /* @__PURE__ */ jsx2("strong", {
+                              /* @__PURE__ */ jsx("strong", {
                                 children: "Never for decisions"
                               }),
                               " - Cannot influence policy or validation"
@@ -1009,15 +547,15 @@ function KnowledgeCategoriesPage() {
                       })
                     ]
                   }),
-                  /* @__PURE__ */ jsxs2("div", {
+                  /* @__PURE__ */ jsxs("div", {
                     children: [
-                      /* @__PURE__ */ jsx2("h4", {
-                        className: "mb-2 text-sm font-semibold",
+                      /* @__PURE__ */ jsx("h4", {
+                        className: "mb-2 font-semibold text-sm",
                         children: "Examples:"
                       }),
-                      /* @__PURE__ */ jsx2("div", {
-                        className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs",
-                        children: /* @__PURE__ */ jsx2("pre", {
+                      /* @__PURE__ */ jsx("div", {
+                        className: "overflow-x-auto rounded border border-border bg-background/50 p-3 font-mono text-muted-foreground text-xs",
+                        children: /* @__PURE__ */ jsx("pre", {
                           children: `// Agent Scratchpad space
 {
   id: "agent-scratchpad",
@@ -1043,12 +581,12 @@ function KnowledgeCategoriesPage() {
                       })
                     ]
                   }),
-                  /* @__PURE__ */ jsx2("div", {
+                  /* @__PURE__ */ jsx("div", {
                     className: "card-subtle border-red-500/30 bg-red-500/10 p-3",
-                    children: /* @__PURE__ */ jsxs2("p", {
-                      className: "text-sm text-red-300",
+                    children: /* @__PURE__ */ jsxs("p", {
+                      className: "text-red-300 text-sm",
                       children: [
-                        /* @__PURE__ */ jsx2("strong", {
+                        /* @__PURE__ */ jsx("strong", {
                           children: "⚠️ Critical:"
                         }),
                         " Ephemeral knowledge is never used for policy decisions, compliance checks, or any authoritative purpose."
@@ -1061,164 +599,164 @@ function KnowledgeCategoriesPage() {
           })
         ]
       }),
-      /* @__PURE__ */ jsxs2("div", {
+      /* @__PURE__ */ jsxs("div", {
         className: "space-y-4",
         children: [
-          /* @__PURE__ */ jsx2("h2", {
-            className: "text-2xl font-bold",
+          /* @__PURE__ */ jsx("h2", {
+            className: "font-bold text-2xl",
             children: "Category comparison"
           }),
-          /* @__PURE__ */ jsx2("div", {
-            className: "border-border/50 overflow-x-auto rounded-lg border",
-            children: /* @__PURE__ */ jsxs2("table", {
+          /* @__PURE__ */ jsx("div", {
+            className: "overflow-x-auto rounded-lg border border-border/50",
+            children: /* @__PURE__ */ jsxs("table", {
               className: "w-full text-left text-sm",
               children: [
-                /* @__PURE__ */ jsx2("thead", {
+                /* @__PURE__ */ jsx("thead", {
                   className: "bg-card/50",
-                  children: /* @__PURE__ */ jsxs2("tr", {
+                  children: /* @__PURE__ */ jsxs("tr", {
                     className: "border-border/50 border-b",
                     children: [
-                      /* @__PURE__ */ jsx2("th", {
+                      /* @__PURE__ */ jsx("th", {
                         className: "px-4 py-3 font-semibold",
                         children: "Feature"
                       }),
-                      /* @__PURE__ */ jsx2("th", {
+                      /* @__PURE__ */ jsx("th", {
                         className: "px-4 py-3 font-semibold",
                         children: "Canonical"
                       }),
-                      /* @__PURE__ */ jsx2("th", {
+                      /* @__PURE__ */ jsx("th", {
                         className: "px-4 py-3 font-semibold",
                         children: "Operational"
                       }),
-                      /* @__PURE__ */ jsx2("th", {
+                      /* @__PURE__ */ jsx("th", {
                         className: "px-4 py-3 font-semibold",
                         children: "External"
                       }),
-                      /* @__PURE__ */ jsx2("th", {
+                      /* @__PURE__ */ jsx("th", {
                         className: "px-4 py-3 font-semibold",
                         children: "Ephemeral"
                       })
                     ]
                   })
                 }),
-                /* @__PURE__ */ jsxs2("tbody", {
-                  className: "divide-border/50 divide-y",
+                /* @__PURE__ */ jsxs("tbody", {
+                  className: "divide-y divide-border/50",
                   children: [
-                    /* @__PURE__ */ jsxs2("tr", {
+                    /* @__PURE__ */ jsxs("tr", {
                       children: [
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3 font-semibold",
                           children: "Trust Level"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Highest"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "High"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Medium"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Low"
                         })
                       ]
                     }),
-                    /* @__PURE__ */ jsxs2("tr", {
+                    /* @__PURE__ */ jsxs("tr", {
                       children: [
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3 font-semibold",
                           children: "Policy Impact"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "✅ Can drive decisions"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "⚠️ Can inform"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "❌ Reference only"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "❌ Never used"
                         })
                       ]
                     }),
-                    /* @__PURE__ */ jsxs2("tr", {
+                    /* @__PURE__ */ jsxs("tr", {
                       children: [
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3 font-semibold",
                           children: "Mutability"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Immutable"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Mutable"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Mutable"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Temporary"
                         })
                       ]
                     }),
-                    /* @__PURE__ */ jsxs2("tr", {
+                    /* @__PURE__ */ jsxs("tr", {
                       children: [
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3 font-semibold",
                           children: "Retention"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Permanent"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Long-term"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Long-term"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Short-term"
                         })
                       ]
                     }),
-                    /* @__PURE__ */ jsxs2("tr", {
+                    /* @__PURE__ */ jsxs("tr", {
                       children: [
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3 font-semibold",
                           children: "Audit Level"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Full audit"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Full audit"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Basic audit"
                         }),
-                        /* @__PURE__ */ jsx2("td", {
+                        /* @__PURE__ */ jsx("td", {
                           className: "px-4 py-3",
                           children: "Minimal audit"
                         })
@@ -1231,52 +769,52 @@ function KnowledgeCategoriesPage() {
           })
         ]
       }),
-      /* @__PURE__ */ jsxs2("div", {
+      /* @__PURE__ */ jsxs("div", {
         className: "space-y-4",
         children: [
-          /* @__PURE__ */ jsx2("h2", {
-            className: "text-2xl font-bold",
+          /* @__PURE__ */ jsx("h2", {
+            className: "font-bold text-2xl",
             children: "Best practices"
           }),
-          /* @__PURE__ */ jsxs2("ul", {
-            className: "text-muted-foreground list-inside list-disc space-y-2",
+          /* @__PURE__ */ jsxs("ul", {
+            className: "list-inside list-disc space-y-2 text-muted-foreground",
             children: [
-              /* @__PURE__ */ jsx2("li", {
+              /* @__PURE__ */ jsx("li", {
                 children: "Use canonical for anything that affects policy, pricing, or compliance"
               }),
-              /* @__PURE__ */ jsx2("li", {
+              /* @__PURE__ */ jsx("li", {
                 children: "Use operational for context that helps but doesn't dictate decisions"
               }),
-              /* @__PURE__ */ jsx2("li", {
+              /* @__PURE__ */ jsx("li", {
                 children: "Use external for reference material that's helpful but not authoritative"
               }),
-              /* @__PURE__ */ jsx2("li", {
+              /* @__PURE__ */ jsx("li", {
                 children: "Use ephemeral for temporary working memory that shouldn't persist"
               }),
-              /* @__PURE__ */ jsx2("li", {
+              /* @__PURE__ */ jsx("li", {
                 children: "Never mix categories in a single knowledge space - keep them separate"
               }),
-              /* @__PURE__ */ jsx2("li", {
+              /* @__PURE__ */ jsx("li", {
                 children: "Document the category and purpose of each knowledge space clearly"
               })
             ]
           })
         ]
       }),
-      /* @__PURE__ */ jsxs2("div", {
+      /* @__PURE__ */ jsxs("div", {
         className: "flex items-center gap-4 pt-4",
         children: [
-          /* @__PURE__ */ jsx2(Link2, {
+          /* @__PURE__ */ jsx(Link, {
             href: "/docs/knowledge",
             className: "btn-ghost",
             children: "Back to Knowledge"
           }),
-          /* @__PURE__ */ jsxs2(Link2, {
+          /* @__PURE__ */ jsxs(Link, {
             href: "/docs/knowledge/spaces",
             className: "btn-primary",
             children: [
               "Knowledge Spaces ",
-              /* @__PURE__ */ jsx2(ChevronRight2, {
+              /* @__PURE__ */ jsx(ChevronRight, {
                 size: 16
               })
             ]
@@ -1288,47 +826,47 @@ function KnowledgeCategoriesPage() {
 }
 
 // src/components/docs/knowledge/KnowledgeExamplesPage.tsx
-import Link3 from "@contractspec/lib.ui-link";
-import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+import Link2 from "@contractspec/lib.ui-link";
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 function KnowledgeExamplesPage() {
-  return /* @__PURE__ */ jsxs3("div", {
+  return /* @__PURE__ */ jsxs2("div", {
     className: "space-y-8",
     children: [
-      /* @__PURE__ */ jsxs3("div", {
+      /* @__PURE__ */ jsxs2("div", {
         className: "space-y-4",
         children: [
-          /* @__PURE__ */ jsx3("h1", {
-            className: "text-4xl font-bold",
+          /* @__PURE__ */ jsx2("h1", {
+            className: "font-bold text-4xl",
             children: "Knowledge Examples"
           }),
-          /* @__PURE__ */ jsx3("p", {
+          /* @__PURE__ */ jsx2("p", {
             className: "text-muted-foreground",
             children: "Real-world examples of how different applications use knowledge spaces to power intelligent workflows and agents."
           })
         ]
       }),
-      /* @__PURE__ */ jsxs3("div", {
+      /* @__PURE__ */ jsxs2("div", {
         className: "space-y-6",
         children: [
-          /* @__PURE__ */ jsxs3("div", {
+          /* @__PURE__ */ jsxs2("div", {
             className: "space-y-4",
             children: [
-              /* @__PURE__ */ jsx3("h2", {
-                className: "text-2xl font-bold",
+              /* @__PURE__ */ jsx2("h2", {
+                className: "font-bold text-2xl",
                 children: "Example 1: ArtisanOS Support Agent"
               }),
-              /* @__PURE__ */ jsxs3("p", {
+              /* @__PURE__ */ jsxs2("p", {
                 className: "text-muted-foreground",
                 children: [
-                  /* @__PURE__ */ jsx3("strong", {
+                  /* @__PURE__ */ jsx2("strong", {
                     children: "Context:"
                   }),
                   " ArtisanOS needs a support agent that can answer product questions using official documentation and learn from past support tickets."
                 ]
               }),
-              /* @__PURE__ */ jsx3("div", {
-                className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
-                children: /* @__PURE__ */ jsx3("pre", {
+              /* @__PURE__ */ jsx2("div", {
+                className: "overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm",
+                children: /* @__PURE__ */ jsx2("pre", {
                   children: `// Knowledge spaces
 knowledgeSpaces: [
   {
@@ -1388,25 +926,25 @@ steps:
               })
             ]
           }),
-          /* @__PURE__ */ jsxs3("div", {
+          /* @__PURE__ */ jsxs2("div", {
             className: "space-y-4",
             children: [
-              /* @__PURE__ */ jsx3("h2", {
-                className: "text-2xl font-bold",
+              /* @__PURE__ */ jsx2("h2", {
+                className: "font-bold text-2xl",
                 children: "Example 2: HCircle Invoice Generation"
               }),
-              /* @__PURE__ */ jsxs3("p", {
+              /* @__PURE__ */ jsxs2("p", {
                 className: "text-muted-foreground",
                 children: [
-                  /* @__PURE__ */ jsx3("strong", {
+                  /* @__PURE__ */ jsx2("strong", {
                     children: "Context:"
                   }),
                   " HCircle needs to generate invoices using house playbook rules and resident service history."
                 ]
               }),
-              /* @__PURE__ */ jsx3("div", {
-                className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
-                children: /* @__PURE__ */ jsx3("pre", {
+              /* @__PURE__ */ jsx2("div", {
+                className: "overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm",
+                children: /* @__PURE__ */ jsx2("pre", {
                   children: `// Knowledge spaces
 knowledgeSpaces: [
   {
@@ -1458,25 +996,25 @@ steps:
               })
             ]
           }),
-          /* @__PURE__ */ jsxs3("div", {
+          /* @__PURE__ */ jsxs2("div", {
             className: "space-y-4",
             children: [
-              /* @__PURE__ */ jsx3("h2", {
-                className: "text-2xl font-bold",
+              /* @__PURE__ */ jsx2("h2", {
+                className: "font-bold text-2xl",
                 children: "Example 3: Multi-tenant SaaS with External Docs"
               }),
-              /* @__PURE__ */ jsxs3("p", {
+              /* @__PURE__ */ jsxs2("p", {
                 className: "text-muted-foreground",
                 children: [
-                  /* @__PURE__ */ jsx3("strong", {
+                  /* @__PURE__ */ jsx2("strong", {
                     children: "Context:"
                   }),
                   " A SaaS platform needs to help users integrate with Stripe, using both internal guides and Stripe's official documentation."
                 ]
               }),
-              /* @__PURE__ */ jsx3("div", {
-                className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
-                children: /* @__PURE__ */ jsx3("pre", {
+              /* @__PURE__ */ jsx2("div", {
+                className: "overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm",
+                children: /* @__PURE__ */ jsx2("pre", {
                   children: `// Knowledge spaces
 knowledgeSpaces: [
   {
@@ -1552,51 +1090,51 @@ steps:
           })
         ]
       }),
-      /* @__PURE__ */ jsxs3("div", {
+      /* @__PURE__ */ jsxs2("div", {
         className: "space-y-4",
         children: [
-          /* @__PURE__ */ jsx3("h2", {
-            className: "text-2xl font-bold",
+          /* @__PURE__ */ jsx2("h2", {
+            className: "font-bold text-2xl",
             children: "Key patterns"
           }),
-          /* @__PURE__ */ jsxs3("ul", {
-            className: "text-muted-foreground list-inside list-disc space-y-2",
+          /* @__PURE__ */ jsxs2("ul", {
+            className: "list-inside list-disc space-y-2 text-muted-foreground",
             children: [
-              /* @__PURE__ */ jsxs3("li", {
+              /* @__PURE__ */ jsxs2("li", {
                 children: [
-                  /* @__PURE__ */ jsx3("strong", {
+                  /* @__PURE__ */ jsx2("strong", {
                     children: "Canonical first"
                   }),
                   " - Always search canonical spaces before operational or external"
                 ]
               }),
-              /* @__PURE__ */ jsxs3("li", {
+              /* @__PURE__ */ jsxs2("li", {
                 children: [
-                  /* @__PURE__ */ jsx3("strong", {
+                  /* @__PURE__ */ jsx2("strong", {
                     children: "Category-aware prompts"
                   }),
                   " - Tell the LLM which sources are authoritative vs reference"
                 ]
               }),
-              /* @__PURE__ */ jsxs3("li", {
+              /* @__PURE__ */ jsxs2("li", {
                 children: [
-                  /* @__PURE__ */ jsx3("strong", {
+                  /* @__PURE__ */ jsx2("strong", {
                     children: "Multi-space queries"
                   }),
                   " - Combine results from multiple spaces for richer context"
                 ]
               }),
-              /* @__PURE__ */ jsxs3("li", {
+              /* @__PURE__ */ jsxs2("li", {
                 children: [
-                  /* @__PURE__ */ jsx3("strong", {
+                  /* @__PURE__ */ jsx2("strong", {
                     children: "Limit results"
                   }),
                   " - Use appropriate limits (3-5) to avoid token overflow"
                 ]
               }),
-              /* @__PURE__ */ jsxs3("li", {
+              /* @__PURE__ */ jsxs2("li", {
                 children: [
-                  /* @__PURE__ */ jsx3("strong", {
+                  /* @__PURE__ */ jsx2("strong", {
                     children: "Audit everything"
                   }),
                   " - Log all knowledge queries for debugging and compliance"
@@ -1606,15 +1144,15 @@ steps:
           })
         ]
       }),
-      /* @__PURE__ */ jsxs3("div", {
+      /* @__PURE__ */ jsxs2("div", {
         className: "flex items-center gap-4 pt-4",
         children: [
-          /* @__PURE__ */ jsx3(Link3, {
+          /* @__PURE__ */ jsx2(Link2, {
             href: "/docs/knowledge/sources",
             className: "btn-ghost",
             children: "Previous: Sources"
           }),
-          /* @__PURE__ */ jsx3(Link3, {
+          /* @__PURE__ */ jsx2(Link2, {
             href: "/docs/architecture/knowledge-binding",
             className: "btn-ghost",
             children: "Knowledge Binding"
@@ -1625,9 +1163,123 @@ steps:
   });
 }
 
+// src/components/docs/knowledge/KnowledgeOverviewPage.tsx
+import Link3 from "@contractspec/lib.ui-link";
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+var knowledgeTracks = [
+  {
+    title: "Categories",
+    body: "Separate canonical truth from operational notes, external material, and ephemeral working context.",
+    href: "/docs/knowledge/categories"
+  },
+  {
+    title: "Spaces",
+    body: "Define the storage and retrieval boundary for each knowledge domain.",
+    href: "/docs/knowledge/spaces"
+  },
+  {
+    title: "Sources",
+    body: "Connect tenant-owned sources explicitly instead of letting context leak in through prompts alone.",
+    href: "/docs/knowledge/sources"
+  },
+  {
+    title: "Examples",
+    body: "See how support, compliance, and product systems consume trusted knowledge at runtime.",
+    href: "/docs/knowledge/examples"
+  }
+];
+function KnowledgeOverviewPage() {
+  return /* @__PURE__ */ jsxs3("div", {
+    className: "space-y-10",
+    children: [
+      /* @__PURE__ */ jsxs3("div", {
+        className: "space-y-3",
+        children: [
+          /* @__PURE__ */ jsx3("p", {
+            className: "editorial-kicker",
+            children: "Operate"
+          }),
+          /* @__PURE__ */ jsx3("h1", {
+            className: "font-serif text-4xl tracking-[-0.04em] md:text-5xl",
+            children: "Knowledge is part of the runtime, not a sidecar prompt hack."
+          }),
+          /* @__PURE__ */ jsx3("p", {
+            className: "max-w-3xl text-lg text-muted-foreground leading-8",
+            children: "When AI-native systems depend on external context, the context needs the same discipline as the rest of the stack. ContractSpec treats knowledge as typed, bounded, and governable so teams can reason about trust, isolation, and retrieval behavior."
+          })
+        ]
+      }),
+      /* @__PURE__ */ jsx3("section", {
+        className: "editorial-panel space-y-5",
+        children: /* @__PURE__ */ jsxs3("div", {
+          className: "space-y-2",
+          children: [
+            /* @__PURE__ */ jsx3("h2", {
+              className: "font-serif text-3xl tracking-[-0.03em]",
+              children: "How knowledge enters the system"
+            }),
+            /* @__PURE__ */ jsxs3("ul", {
+              className: "editorial-list",
+              children: [
+                /* @__PURE__ */ jsxs3("li", {
+                  children: [
+                    /* @__PURE__ */ jsx3("span", {
+                      className: "editorial-list-marker"
+                    }),
+                    /* @__PURE__ */ jsx3("span", {
+                      children: "Define the trust category and retrieval expectations first."
+                    })
+                  ]
+                }),
+                /* @__PURE__ */ jsxs3("li", {
+                  children: [
+                    /* @__PURE__ */ jsx3("span", {
+                      className: "editorial-list-marker"
+                    }),
+                    /* @__PURE__ */ jsx3("span", {
+                      children: "Bind tenant-owned sources explicitly to those knowledge spaces."
+                    })
+                  ]
+                }),
+                /* @__PURE__ */ jsxs3("li", {
+                  children: [
+                    /* @__PURE__ */ jsx3("span", {
+                      className: "editorial-list-marker"
+                    }),
+                    /* @__PURE__ */ jsx3("span", {
+                      children: "Consume knowledge through capabilities and workflows, not through invisible prompt assumptions."
+                    })
+                  ]
+                })
+              ]
+            })
+          ]
+        })
+      }),
+      /* @__PURE__ */ jsx3("div", {
+        className: "grid gap-4 md:grid-cols-2",
+        children: knowledgeTracks.map((item) => /* @__PURE__ */ jsxs3(Link3, {
+          href: item.href,
+          className: "editorial-panel",
+          children: [
+            /* @__PURE__ */ jsx3("h2", {
+              className: "font-semibold text-xl",
+              children: item.title
+            }),
+            /* @__PURE__ */ jsx3("p", {
+              className: "mt-2 text-muted-foreground text-sm leading-7",
+              children: item.body
+            })
+          ]
+        }, item.href))
+      })
+    ]
+  });
+}
+
 // src/components/docs/knowledge/KnowledgeSourcesPage.tsx
 import Link4 from "@contractspec/lib.ui-link";
-import { ChevronRight as ChevronRight3 } from "lucide-react";
+import { ChevronRight as ChevronRight2 } from "lucide-react";
 import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 function KnowledgeSourcesPage() {
   return /* @__PURE__ */ jsxs4("div", {
@@ -1637,7 +1289,7 @@ function KnowledgeSourcesPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx4("h1", {
-            className: "text-4xl font-bold",
+            className: "font-bold text-4xl",
             children: "Knowledge Sources"
           }),
           /* @__PURE__ */ jsxs4("p", {
@@ -1656,11 +1308,11 @@ function KnowledgeSourcesPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx4("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "KnowledgeSourceConfig"
           }),
           /* @__PURE__ */ jsx4("div", {
-            className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
+            className: "overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm",
             children: /* @__PURE__ */ jsx4("pre", {
               children: `type KnowledgeSourceConfig = {
   id: string;
@@ -1698,7 +1350,7 @@ function KnowledgeSourcesPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx4("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Source types"
           }),
           /* @__PURE__ */ jsxs4("div", {
@@ -1708,11 +1360,11 @@ function KnowledgeSourcesPage() {
                 className: "card-subtle p-4",
                 children: [
                   /* @__PURE__ */ jsx4("h3", {
-                    className: "mb-2 text-lg font-semibold",
+                    className: "mb-2 font-semibold text-lg",
                     children: "Uploaded Documents"
                   }),
                   /* @__PURE__ */ jsx4("div", {
-                    className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs",
+                    className: "overflow-x-auto rounded border border-border bg-background/50 p-3 font-mono text-muted-foreground text-xs",
                     children: /* @__PURE__ */ jsx4("pre", {
                       children: `{
   kind: "uploaded-document",
@@ -1722,7 +1374,7 @@ function KnowledgeSourcesPage() {
                     })
                   }),
                   /* @__PURE__ */ jsx4("p", {
-                    className: "text-muted-foreground mt-2 text-sm",
+                    className: "mt-2 text-muted-foreground text-sm",
                     children: "PDFs, Word docs, presentations uploaded by users"
                   })
                 ]
@@ -1731,11 +1383,11 @@ function KnowledgeSourcesPage() {
                 className: "card-subtle p-4",
                 children: [
                   /* @__PURE__ */ jsx4("h3", {
-                    className: "mb-2 text-lg font-semibold",
+                    className: "mb-2 font-semibold text-lg",
                     children: "Notion"
                   }),
                   /* @__PURE__ */ jsx4("div", {
-                    className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs",
+                    className: "overflow-x-auto rounded border border-border bg-background/50 p-3 font-mono text-muted-foreground text-xs",
                     children: /* @__PURE__ */ jsx4("pre", {
                       children: `{
   kind: "notion",
@@ -1745,7 +1397,7 @@ function KnowledgeSourcesPage() {
                     })
                   }),
                   /* @__PURE__ */ jsx4("p", {
-                    className: "text-muted-foreground mt-2 text-sm",
+                    className: "mt-2 text-muted-foreground text-sm",
                     children: "Notion pages and databases with real-time webhook updates"
                   })
                 ]
@@ -1754,11 +1406,11 @@ function KnowledgeSourcesPage() {
                 className: "card-subtle p-4",
                 children: [
                   /* @__PURE__ */ jsx4("h3", {
-                    className: "mb-2 text-lg font-semibold",
+                    className: "mb-2 font-semibold text-lg",
                     children: "Gmail / Email"
                   }),
                   /* @__PURE__ */ jsx4("div", {
-                    className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs",
+                    className: "overflow-x-auto rounded border border-border bg-background/50 p-3 font-mono text-muted-foreground text-xs",
                     children: /* @__PURE__ */ jsx4("pre", {
                       children: `{
   kind: "email",
@@ -1768,7 +1420,7 @@ function KnowledgeSourcesPage() {
                     })
                   }),
                   /* @__PURE__ */ jsx4("p", {
-                    className: "text-muted-foreground mt-2 text-sm",
+                    className: "mt-2 text-muted-foreground text-sm",
                     children: "Email threads from Gmail or other providers"
                   })
                 ]
@@ -1777,11 +1429,11 @@ function KnowledgeSourcesPage() {
                 className: "card-subtle p-4",
                 children: [
                   /* @__PURE__ */ jsx4("h3", {
-                    className: "mb-2 text-lg font-semibold",
+                    className: "mb-2 font-semibold text-lg",
                     children: "Database Query"
                   }),
                   /* @__PURE__ */ jsx4("div", {
-                    className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs",
+                    className: "overflow-x-auto rounded border border-border bg-background/50 p-3 font-mono text-muted-foreground text-xs",
                     children: /* @__PURE__ */ jsx4("pre", {
                       children: `{
   kind: "database-query",
@@ -1791,7 +1443,7 @@ function KnowledgeSourcesPage() {
                     })
                   }),
                   /* @__PURE__ */ jsx4("p", {
-                    className: "text-muted-foreground mt-2 text-sm",
+                    className: "mt-2 text-muted-foreground text-sm",
                     children: "Structured data from application databases"
                   })
                 ]
@@ -1800,11 +1452,11 @@ function KnowledgeSourcesPage() {
                 className: "card-subtle p-4",
                 children: [
                   /* @__PURE__ */ jsx4("h3", {
-                    className: "mb-2 text-lg font-semibold",
+                    className: "mb-2 font-semibold text-lg",
                     children: "URL / Web Scraping"
                   }),
                   /* @__PURE__ */ jsx4("div", {
-                    className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs",
+                    className: "overflow-x-auto rounded border border-border bg-background/50 p-3 font-mono text-muted-foreground text-xs",
                     children: /* @__PURE__ */ jsx4("pre", {
                       children: `{
   kind: "url",
@@ -1814,7 +1466,7 @@ function KnowledgeSourcesPage() {
                     })
                   }),
                   /* @__PURE__ */ jsx4("p", {
-                    className: "text-muted-foreground mt-2 text-sm",
+                    className: "mt-2 text-muted-foreground text-sm",
                     children: "External documentation and web content"
                   })
                 ]
@@ -1827,11 +1479,11 @@ function KnowledgeSourcesPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx4("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Sync strategies"
           }),
           /* @__PURE__ */ jsx4("div", {
-            className: "border-border/50 overflow-x-auto rounded-lg border",
+            className: "overflow-x-auto rounded-lg border border-border/50",
             children: /* @__PURE__ */ jsxs4("table", {
               className: "w-full text-left text-sm",
               children: [
@@ -1856,7 +1508,7 @@ function KnowledgeSourcesPage() {
                   })
                 }),
                 /* @__PURE__ */ jsxs4("tbody", {
-                  className: "divide-border/50 divide-y",
+                  className: "divide-y divide-border/50",
                   children: [
                     /* @__PURE__ */ jsxs4("tr", {
                       children: [
@@ -1917,7 +1569,7 @@ function KnowledgeSourcesPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx4("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Example: Multi-source space"
           }),
           /* @__PURE__ */ jsx4("p", {
@@ -1925,7 +1577,7 @@ function KnowledgeSourcesPage() {
             children: "A single knowledge space can be fed by multiple sources:"
           }),
           /* @__PURE__ */ jsx4("div", {
-            className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
+            className: "overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm",
             children: /* @__PURE__ */ jsx4("pre", {
               children: `// Product Canon space with multiple sources
 {
@@ -1959,7 +1611,7 @@ function KnowledgeSourcesPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx4("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Processing pipeline"
           }),
           /* @__PURE__ */ jsx4("p", {
@@ -1967,7 +1619,7 @@ function KnowledgeSourcesPage() {
             children: "When a source is synced, ContractSpec processes it through several stages:"
           }),
           /* @__PURE__ */ jsxs4("ol", {
-            className: "text-muted-foreground list-inside list-decimal space-y-3",
+            className: "list-inside list-decimal space-y-3 text-muted-foreground",
             children: [
               /* @__PURE__ */ jsxs4("li", {
                 children: [
@@ -2025,11 +1677,11 @@ function KnowledgeSourcesPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx4("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Best practices"
           }),
           /* @__PURE__ */ jsxs4("ul", {
-            className: "text-muted-foreground list-inside list-disc space-y-2",
+            className: "list-inside list-disc space-y-2 text-muted-foreground",
             children: [
               /* @__PURE__ */ jsx4("li", {
                 children: "Use webhooks for real-time sources (Notion, Gmail) to minimize latency"
@@ -2066,7 +1718,7 @@ function KnowledgeSourcesPage() {
             className: "btn-primary",
             children: [
               "Examples ",
-              /* @__PURE__ */ jsx4(ChevronRight3, {
+              /* @__PURE__ */ jsx4(ChevronRight2, {
                 size: 16
               })
             ]
@@ -2079,7 +1731,7 @@ function KnowledgeSourcesPage() {
 
 // src/components/docs/knowledge/KnowledgeSpacesPage.tsx
 import Link5 from "@contractspec/lib.ui-link";
-import { ChevronRight as ChevronRight4 } from "lucide-react";
+import { ChevronRight as ChevronRight3 } from "lucide-react";
 import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 function KnowledgeSpacesPage() {
   return /* @__PURE__ */ jsxs5("div", {
@@ -2089,7 +1741,7 @@ function KnowledgeSpacesPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx5("h1", {
-            className: "text-4xl font-bold",
+            className: "font-bold text-4xl",
             children: "Knowledge Spaces"
           }),
           /* @__PURE__ */ jsxs5("p", {
@@ -2108,11 +1760,11 @@ function KnowledgeSpacesPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx5("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "KnowledgeSpaceSpec"
           }),
           /* @__PURE__ */ jsx5("div", {
-            className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded-lg border p-4 font-mono text-sm",
+            className: "overflow-x-auto rounded-lg border border-border bg-background/50 p-4 font-mono text-muted-foreground text-sm",
             children: /* @__PURE__ */ jsx5("pre", {
               children: `type KnowledgeSpaceSpec = {
   id: string;
@@ -2148,7 +1800,7 @@ function KnowledgeSpacesPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx5("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Common knowledge spaces"
           }),
           /* @__PURE__ */ jsxs5("div", {
@@ -2158,11 +1810,11 @@ function KnowledgeSpacesPage() {
                 className: "card-subtle p-4",
                 children: [
                   /* @__PURE__ */ jsx5("h3", {
-                    className: "mb-2 text-lg font-semibold",
+                    className: "mb-2 font-semibold text-lg",
                     children: "Product Canon"
                   }),
                   /* @__PURE__ */ jsx5("div", {
-                    className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs",
+                    className: "overflow-x-auto rounded border border-border bg-background/50 p-3 font-mono text-muted-foreground text-xs",
                     children: /* @__PURE__ */ jsx5("pre", {
                       children: `{
   id: "product-canon",
@@ -2178,7 +1830,7 @@ function KnowledgeSpacesPage() {
                     })
                   }),
                   /* @__PURE__ */ jsxs5("p", {
-                    className: "text-muted-foreground mt-2 text-sm",
+                    className: "mt-2 text-muted-foreground text-sm",
                     children: [
                       /* @__PURE__ */ jsx5("strong", {
                         children: "Use cases:"
@@ -2192,11 +1844,11 @@ function KnowledgeSpacesPage() {
                 className: "card-subtle p-4",
                 children: [
                   /* @__PURE__ */ jsx5("h3", {
-                    className: "mb-2 text-lg font-semibold",
+                    className: "mb-2 font-semibold text-lg",
                     children: "Support History"
                   }),
                   /* @__PURE__ */ jsx5("div", {
-                    className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs",
+                    className: "overflow-x-auto rounded border border-border bg-background/50 p-3 font-mono text-muted-foreground text-xs",
                     children: /* @__PURE__ */ jsx5("pre", {
                       children: `{
   id: "support-history",
@@ -2212,7 +1864,7 @@ function KnowledgeSpacesPage() {
                     })
                   }),
                   /* @__PURE__ */ jsxs5("p", {
-                    className: "text-muted-foreground mt-2 text-sm",
+                    className: "mt-2 text-muted-foreground text-sm",
                     children: [
                       /* @__PURE__ */ jsx5("strong", {
                         children: "Use cases:"
@@ -2226,11 +1878,11 @@ function KnowledgeSpacesPage() {
                 className: "card-subtle p-4",
                 children: [
                   /* @__PURE__ */ jsx5("h3", {
-                    className: "mb-2 text-lg font-semibold",
+                    className: "mb-2 font-semibold text-lg",
                     children: "External Provider Docs"
                   }),
                   /* @__PURE__ */ jsx5("div", {
-                    className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs",
+                    className: "overflow-x-auto rounded border border-border bg-background/50 p-3 font-mono text-muted-foreground text-xs",
                     children: /* @__PURE__ */ jsx5("pre", {
                       children: `{
   id: "provider-docs",
@@ -2245,7 +1897,7 @@ function KnowledgeSpacesPage() {
                     })
                   }),
                   /* @__PURE__ */ jsxs5("p", {
-                    className: "text-muted-foreground mt-2 text-sm",
+                    className: "mt-2 text-muted-foreground text-sm",
                     children: [
                       /* @__PURE__ */ jsx5("strong", {
                         children: "Use cases:"
@@ -2259,11 +1911,11 @@ function KnowledgeSpacesPage() {
                 className: "card-subtle p-4",
                 children: [
                   /* @__PURE__ */ jsx5("h3", {
-                    className: "mb-2 text-lg font-semibold",
+                    className: "mb-2 font-semibold text-lg",
                     children: "Agent Scratchpad"
                   }),
                   /* @__PURE__ */ jsx5("div", {
-                    className: "bg-background/50 border-border text-muted-foreground overflow-x-auto rounded border p-3 font-mono text-xs",
+                    className: "overflow-x-auto rounded border border-border bg-background/50 p-3 font-mono text-muted-foreground text-xs",
                     children: /* @__PURE__ */ jsx5("pre", {
                       children: `{
   id: "agent-scratchpad",
@@ -2279,7 +1931,7 @@ function KnowledgeSpacesPage() {
                     })
                   }),
                   /* @__PURE__ */ jsxs5("p", {
-                    className: "text-muted-foreground mt-2 text-sm",
+                    className: "mt-2 text-muted-foreground text-sm",
                     children: [
                       /* @__PURE__ */ jsx5("strong", {
                         children: "Use cases:"
@@ -2297,11 +1949,11 @@ function KnowledgeSpacesPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx5("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Storage strategies"
           }),
           /* @__PURE__ */ jsx5("div", {
-            className: "border-border/50 overflow-x-auto rounded-lg border",
+            className: "overflow-x-auto rounded-lg border border-border/50",
             children: /* @__PURE__ */ jsxs5("table", {
               className: "w-full text-left text-sm",
               children: [
@@ -2326,7 +1978,7 @@ function KnowledgeSpacesPage() {
                   })
                 }),
                 /* @__PURE__ */ jsxs5("tbody", {
-                  className: "divide-border/50 divide-y",
+                  className: "divide-y divide-border/50",
                   children: [
                     /* @__PURE__ */ jsxs5("tr", {
                       children: [
@@ -2387,11 +2039,11 @@ function KnowledgeSpacesPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx5("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Best practices"
           }),
           /* @__PURE__ */ jsxs5("ul", {
-            className: "text-muted-foreground list-inside list-disc space-y-2",
+            className: "list-inside list-disc space-y-2 text-muted-foreground",
             children: [
               /* @__PURE__ */ jsx5("li", {
                 children: "Choose storage strategy based on query patterns - use vector for semantic, search for exact"
@@ -2425,7 +2077,7 @@ function KnowledgeSpacesPage() {
             className: "btn-primary",
             children: [
               "Knowledge Sources ",
-              /* @__PURE__ */ jsx5(ChevronRight4, {
+              /* @__PURE__ */ jsx5(ChevronRight3, {
                 size: 16
               })
             ]