@contractspec/bundle.library 3.7.6 → 3.8.2

package/dist/components/docs/architecture/index.js

@@ -12,7 +12,7 @@ function ArchitectureAppConfigPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx("h1", {
-            className: "text-4xl font-bold",
+            className: "font-bold text-4xl",
             children: "App Configuration"
           }),
           /* @__PURE__ */ jsx("p", {
@@ -25,7 +25,7 @@ function ArchitectureAppConfigPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "AppBlueprintSpec"
           }),
           /* @__PURE__ */ jsxs("p", {
@@ -85,7 +85,7 @@ function ArchitectureAppConfigPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "TenantAppConfig"
           }),
           /* @__PURE__ */ jsxs("p", {
@@ -139,7 +139,7 @@ function ArchitectureAppConfigPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "AppIntegrationBinding"
           }),
           /* @__PURE__ */ jsx("p", {
@@ -176,7 +176,7 @@ function ArchitectureAppConfigPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "AppKnowledgeBinding"
           }),
           /* @__PURE__ */ jsx("p", {
@@ -223,7 +223,7 @@ function ArchitectureAppConfigPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "ResolvedAppConfig"
           }),
           /* @__PURE__ */ jsxs("p", {
@@ -273,7 +273,7 @@ function ArchitectureAppConfigPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Configuration flow"
           }),
           /* @__PURE__ */ jsx("p", {
@@ -281,7 +281,7 @@ function ArchitectureAppConfigPage() {
             children: "Here's how configuration flows from definition to runtime:"
           }),
           /* @__PURE__ */ jsxs("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__ */ jsxs("li", {
                 children: [
@@ -331,11 +331,11 @@ function ArchitectureAppConfigPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Best practices"
           }),
           /* @__PURE__ */ jsxs("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__ */ jsx("li", {
                 children: "Keep AppBlueprintSpec environment-agnostic - no secrets or tenant-specific data"
@@ -393,7 +393,7 @@ function ArchitectureControlPlanePage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx2("h1", {
-            className: "text-4xl font-bold",
+            className: "font-bold text-4xl",
             children: "Control Plane Runtime"
           }),
           /* @__PURE__ */ jsx2("p", {
@@ -406,11 +406,11 @@ function ArchitectureControlPlanePage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx2("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Canonical execution loop"
           }),
           /* @__PURE__ */ jsxs2("ol", {
-            className: "text-muted-foreground list-inside list-decimal space-y-2",
+            className: "list-inside list-decimal space-y-2 text-muted-foreground",
             children: [
               /* @__PURE__ */ jsx2("li", {
                 children: "Accept intent and create execution identity + trace context."
@@ -438,7 +438,7 @@ function ArchitectureControlPlanePage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx2("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Contract surfaces (v1 baseline)"
           }),
           /* @__PURE__ */ jsxs2("p", {
@@ -497,11 +497,11 @@ Capabilities
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx2("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Policy and safety posture"
           }),
           /* @__PURE__ */ jsxs2("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__ */ jsx2("li", {
                 children: "No side-effect action executes unless it comes from a compiled plan."
@@ -526,7 +526,7 @@ Capabilities
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx2("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Implementation map"
           }),
           /* @__PURE__ */ jsx2(CodeBlock2, {
@@ -548,7 +548,7 @@ implementation_plan_controle_plane.md`
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx2("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "What comes next"
           }),
           /* @__PURE__ */ jsx2("p", {
@@ -594,7 +594,7 @@ function ArchitectureIntegrationBindingPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx3("h1", {
-            className: "text-4xl font-bold",
+            className: "font-bold text-4xl",
             children: "Integration Binding"
           }),
           /* @__PURE__ */ jsx3("p", {
@@ -607,7 +607,7 @@ function ArchitectureIntegrationBindingPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx3("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "How it works"
           }),
           /* @__PURE__ */ jsx3("p", {
@@ -615,7 +615,7 @@ function ArchitectureIntegrationBindingPage() {
             children: "Integration binding follows a three-layer model:"
           }),
           /* @__PURE__ */ jsxs3("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__ */ jsxs3("li", {
                 children: [
@@ -649,7 +649,7 @@ function ArchitectureIntegrationBindingPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx3("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Example: Payment processing"
           }),
           /* @__PURE__ */ jsx3("p", {
@@ -660,7 +660,7 @@ function ArchitectureIntegrationBindingPage() {
             className: "space-y-3",
             children: [
               /* @__PURE__ */ jsx3("h3", {
-                className: "text-lg font-semibold",
+                className: "font-semibold text-lg",
                 children: "Step 1: Blueprint declares requirement"
               }),
               /* @__PURE__ */ jsx3(CodeBlock3, {
@@ -697,7 +697,7 @@ function ArchitectureIntegrationBindingPage() {
             className: "space-y-3",
             children: [
               /* @__PURE__ */ jsx3("h3", {
-                className: "text-lg font-semibold",
+                className: "font-semibold text-lg",
                 children: "Step 2: Tenant creates connection"
               }),
               /* @__PURE__ */ jsx3(CodeBlock3, {
@@ -730,7 +730,7 @@ function ArchitectureIntegrationBindingPage() {
             className: "space-y-3",
             children: [
               /* @__PURE__ */ jsx3("h3", {
-                className: "text-lg font-semibold",
+                className: "font-semibold text-lg",
                 children: "Step 3: TenantAppConfig binds connection"
               }),
               /* @__PURE__ */ jsx3(CodeBlock3, {
@@ -769,7 +769,7 @@ function ArchitectureIntegrationBindingPage() {
             className: "space-y-3",
             children: [
               /* @__PURE__ */ jsx3("h3", {
-                className: "text-lg font-semibold",
+                className: "font-semibold text-lg",
                 children: "Step 4: Runtime resolves and executes"
               }),
               /* @__PURE__ */ jsx3(CodeBlock3, {
@@ -801,7 +801,7 @@ const result = await executeCapability(
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx3("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Multi-integration scenarios"
           }),
           /* @__PURE__ */ jsx3("p", {
@@ -844,7 +844,7 @@ const result = await executeCapability(
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx3("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Sandbox vs Production"
           }),
           /* @__PURE__ */ jsx3("p", {
@@ -881,11 +881,11 @@ const result = await executeCapability(
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx3("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Security & validation"
           }),
           /* @__PURE__ */ jsxs3("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__ */ jsx3("li", {
                 children: "Integration connections are validated before binding - health checks ensure connectivity"
@@ -910,11 +910,11 @@ const result = await executeCapability(
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx3("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Best practices"
           }),
           /* @__PURE__ */ jsxs3("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__ */ jsxs3("li", {
                 children: [
@@ -978,7 +978,7 @@ function ArchitectureKnowledgeBindingPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx4("h1", {
-            className: "text-4xl font-bold",
+            className: "font-bold text-4xl",
             children: "Knowledge Binding"
           }),
           /* @__PURE__ */ jsx4("p", {
@@ -991,7 +991,7 @@ function ArchitectureKnowledgeBindingPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx4("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "How it works"
           }),
           /* @__PURE__ */ jsx4("p", {
@@ -999,7 +999,7 @@ function ArchitectureKnowledgeBindingPage() {
             children: "Knowledge binding follows a three-layer model:"
           }),
           /* @__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: [
@@ -1033,7 +1033,7 @@ function ArchitectureKnowledgeBindingPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx4("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Example: Support agent with RAG"
           }),
           /* @__PURE__ */ jsx4("p", {
@@ -1044,7 +1044,7 @@ function ArchitectureKnowledgeBindingPage() {
             className: "space-y-3",
             children: [
               /* @__PURE__ */ jsx4("h3", {
-                className: "text-lg font-semibold",
+                className: "font-semibold text-lg",
                 children: "Step 1: Blueprint declares knowledge needs"
               }),
               /* @__PURE__ */ jsx4(CodeBlock4, {
@@ -1081,7 +1081,7 @@ function ArchitectureKnowledgeBindingPage() {
             className: "space-y-3",
             children: [
               /* @__PURE__ */ jsx4("h3", {
-                className: "text-lg font-semibold",
+                className: "font-semibold text-lg",
                 children: "Step 2: Tenant configures sources"
               }),
               /* @__PURE__ */ jsx4(CodeBlock4, {
@@ -1123,7 +1123,7 @@ function ArchitectureKnowledgeBindingPage() {
             className: "space-y-3",
             children: [
               /* @__PURE__ */ jsx4("h3", {
-                className: "text-lg font-semibold",
+                className: "font-semibold text-lg",
                 children: "Step 3: TenantAppConfig binds spaces"
               }),
               /* @__PURE__ */ jsx4(CodeBlock4, {
@@ -1172,7 +1172,7 @@ function ArchitectureKnowledgeBindingPage() {
             className: "space-y-3",
             children: [
               /* @__PURE__ */ jsx4("h3", {
-                className: "text-lg font-semibold",
+                className: "font-semibold text-lg",
                 children: "Step 4: Workflow uses knowledge"
               }),
               /* @__PURE__ */ jsx4(CodeBlock4, {
@@ -1229,7 +1229,7 @@ steps:
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx4("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Category-based access control"
           }),
           /* @__PURE__ */ jsx4("p", {
@@ -1237,7 +1237,7 @@ steps:
             children: "Different knowledge categories have different trust levels and access patterns:"
           }),
           /* @__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: [
@@ -1266,7 +1266,7 @@ steps:
                   })
                 }),
                 /* @__PURE__ */ jsxs4("tbody", {
-                  className: "divide-border/50 divide-y",
+                  className: "divide-y divide-border/50",
                   children: [
                     /* @__PURE__ */ jsxs4("tr", {
                       children: [
@@ -1359,7 +1359,7 @@ steps:
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx4("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Multi-space workflows"
           }),
           /* @__PURE__ */ jsx4("p", {
@@ -1404,11 +1404,11 @@ steps:
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx4("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Security & validation"
           }),
           /* @__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: "Knowledge sources are validated before sync - credentials and permissions checked"
@@ -1433,11 +1433,11 @@ steps:
         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 canonical spaces for policy-critical decisions, operational for suggestions"
@@ -1504,7 +1504,7 @@ function ArchitectureMultiTenancyPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx5("h1", {
-            className: "text-4xl font-bold",
+            className: "font-bold text-4xl",
             children: "Multi-Tenancy"
           }),
           /* @__PURE__ */ jsx5("p", {
@@ -1517,11 +1517,11 @@ function ArchitectureMultiTenancyPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx5("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Core Concepts"
           }),
           /* @__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__ */ jsxs5("li", {
                 children: [
@@ -1559,7 +1559,7 @@ function ArchitectureMultiTenancyPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx5("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Tenant Resolution"
           }),
           /* @__PURE__ */ jsx5("p", {
@@ -1567,7 +1567,7 @@ function ArchitectureMultiTenancyPage() {
             children: "The runtime automatically resolves the tenant context for every request based on:"
           }),
           /* @__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__ */ jsxs5("li", {
                 children: [
@@ -1607,7 +1607,7 @@ function ArchitectureMultiTenancyPage() {
         className: "space-y-4",
         children: [
           /* @__PURE__ */ jsx5("h2", {
-            className: "text-2xl font-bold",
+            className: "font-bold text-2xl",
             children: "Configuration Isolation"
           }),
           /* @__PURE__ */ jsxs5("p", {
@@ -1632,7 +1632,7 @@ function ArchitectureMultiTenancyPage() {
 };`
           }),
           /* @__PURE__ */ jsx5("p", {
-            className: "text-muted-foreground mt-2",
+            className: "mt-2 text-muted-foreground",
             children: "This allows you to customize feature flags, integration connections, and knowledge sources per tenant without changing the application code."
           })
         ]
@@ -1663,461 +1663,140 @@ function ArchitectureMultiTenancyPage() {
 
 // src/components/docs/architecture/ArchitectureOverviewPage.tsx
 import Link6 from "@contractspec/lib.ui-link";
-import { ChevronRight as ChevronRight6 } from "lucide-react";
 import { jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
+var layers = [
+  {
+    title: "Contracts and schemas",
+    body: "Explicit specs define the durable boundary for behavior, data, and governance."
+  },
+  {
+    title: "Bindings and configuration",
+    body: "Apps, tenants, integrations, and knowledge sources are wired through explicit configuration instead of hidden glue."
+  },
+  {
+    title: "Runtimes and generators",
+    body: "Serve or generate aligned surfaces for API, UI, workflows, docs, and agent-facing interfaces."
+  },
+  {
+    title: "Operate and observe",
+    body: "Carry auditability, policy, tracing, migrations, and tenant isolation through the same model."
+  }
+];
 function ArchitectureOverviewPage() {
   return /* @__PURE__ */ jsxs6("div", {
-    className: "space-y-8",
+    className: "space-y-10",
     children: [
       /* @__PURE__ */ jsxs6("div", {
-        className: "space-y-4",
+        className: "space-y-3",
         children: [
+          /* @__PURE__ */ jsx6("p", {
+            className: "editorial-kicker",
+            children: "Build"
+          }),
           /* @__PURE__ */ jsx6("h1", {
-            className: "text-4xl font-bold",
-            children: "Architecture"
+            className: "font-serif text-4xl tracking-[-0.04em] md:text-5xl",
+            children: "The architecture keeps contracts, runtime behavior, and operations in the same system."
           }),
           /* @__PURE__ */ jsx6("p", {
-            className: "text-muted-foreground",
-            children: "ContractSpec's architecture is built on a foundation of typed specifications served by runtime adapters. This section covers the core architectural concepts: app configuration, integration binding, control-plane governance, and knowledge management."
+            className: "max-w-3xl text-lg text-muted-foreground leading-8",
+            children: "ContractSpec is not a single runtime. It is a layered system that lets you define explicit boundaries, bind real-world configuration, and then serve or generate aligned surfaces without losing control of the output."
           })
         ]
       }),
-      /* @__PURE__ */ jsxs6("div", {
-        className: "space-y-4",
+      /* @__PURE__ */ jsx6("div", {
+        className: "grid gap-4 md:grid-cols-2",
+        children: layers.map((layer) => /* @__PURE__ */ jsxs6("article", {
+          className: "editorial-panel space-y-3",
+          children: [
+            /* @__PURE__ */ jsx6("h2", {
+              className: "font-semibold text-xl",
+              children: layer.title
+            }),
+            /* @__PURE__ */ jsx6("p", {
+              className: "text-muted-foreground text-sm leading-7",
+              children: layer.body
+            })
+          ]
+        }, layer.title))
+      }),
+      /* @__PURE__ */ jsxs6("section", {
+        className: "editorial-panel space-y-5",
         children: [
-          /* @__PURE__ */ jsx6("h2", {
-            className: "text-2xl font-bold",
-            children: "Core layers"
+          /* @__PURE__ */ jsxs6("div", {
+            className: "space-y-2",
+            children: [
+              /* @__PURE__ */ jsx6("h2", {
+                className: "font-serif text-3xl tracking-[-0.03em]",
+                children: "Follow the architecture by responsibility"
+              }),
+              /* @__PURE__ */ jsx6("p", {
+                className: "text-muted-foreground text-sm leading-7",
+                children: "Use the architecture pages when you need to understand how the pieces snap together in a real deployment."
+              })
+            ]
           }),
           /* @__PURE__ */ jsxs6("div", {
-            className: "space-y-6",
+            className: "grid gap-4 md:grid-cols-2",
             children: [
-              /* @__PURE__ */ jsxs6("div", {
-                className: "space-y-3",
+              /* @__PURE__ */ jsxs6(Link6, {
+                href: "/docs/architecture/app-config",
+                className: "docs-footer-link",
                 children: [
                   /* @__PURE__ */ jsx6("h3", {
-                    className: "text-xl font-semibold",
-                    children: "1. Specification Layer"
+                    className: "font-semibold text-lg",
+                    children: "App configuration"
                   }),
                   /* @__PURE__ */ jsx6("p", {
-                    className: "text-muted-foreground",
-                    children: "The foundation of ContractSpec. Typed specifications define what your application can do:"
-                  }),
-                  /* @__PURE__ */ jsxs6("ul", {
-                    className: "text-muted-foreground ml-4 list-inside list-disc space-y-2",
-                    children: [
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6(Link6, {
-                            href: "/docs/specs/capabilities",
-                            className: "text-violet-400 hover:text-violet-300",
-                            children: "CapabilitySpec"
-                          }),
-                          " ",
-                          "- Operations and their inputs/outputs"
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6(Link6, {
-                            href: "/docs/specs/dataviews",
-                            className: "text-violet-400 hover:text-violet-300",
-                            children: "DataViewSpec"
-                          }),
-                          " ",
-                          "- Data queries and presentation"
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6(Link6, {
-                            href: "/docs/specs/workflows",
-                            className: "text-violet-400 hover:text-violet-300",
-                            children: "WorkflowSpec"
-                          }),
-                          " ",
-                          "- Multi-step processes"
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6(Link6, {
-                            href: "/docs/specs/policy",
-                            className: "text-violet-400 hover:text-violet-300",
-                            children: "PolicySpec"
-                          }),
-                          " ",
-                          "- Access control and data protection"
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6(Link6, {
-                            href: "/docs/integrations/spec-model",
-                            className: "text-violet-400 hover:text-violet-300",
-                            children: "IntegrationSpec"
-                          }),
-                          " ",
-                          "- External service providers"
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6(Link6, {
-                            href: "/docs/knowledge/spaces",
-                            className: "text-violet-400 hover:text-violet-300",
-                            children: "KnowledgeSpaceSpec"
-                          }),
-                          " ",
-                          "- Knowledge and context management"
-                        ]
-                      })
-                    ]
+                    className: "text-muted-foreground text-sm leading-7",
+                    children: "How blueprint-level and tenant-level config stay explicit and merge safely."
                   })
                 ]
               }),
-              /* @__PURE__ */ jsxs6("div", {
-                className: "space-y-3",
+              /* @__PURE__ */ jsxs6(Link6, {
+                href: "/docs/architecture/integration-binding",
+                className: "docs-footer-link",
                 children: [
                   /* @__PURE__ */ jsx6("h3", {
-                    className: "text-xl font-semibold",
-                    children: "2. Configuration Layer"
+                    className: "font-semibold text-lg",
+                    children: "Integration binding"
                   }),
                   /* @__PURE__ */ jsx6("p", {
-                    className: "text-muted-foreground",
-                    children: "How applications are configured and customized:"
-                  }),
-                  /* @__PURE__ */ jsxs6("ul", {
-                    className: "text-muted-foreground ml-4 list-inside list-disc space-y-2",
-                    children: [
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6(Link6, {
-                            href: "/docs/architecture/app-config",
-                            className: "text-violet-400 hover:text-violet-300",
-                            children: "AppBlueprintSpec"
-                          }),
-                          " ",
-                          "- Global, versioned app definition"
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6(Link6, {
-                            href: "/docs/architecture/app-config",
-                            className: "text-violet-400 hover:text-violet-300",
-                            children: "TenantAppConfig"
-                          }),
-                          " ",
-                          "- Per-tenant, per-environment configuration"
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6(Link6, {
-                            href: "/docs/architecture/integration-binding",
-                            className: "text-violet-400 hover:text-violet-300",
-                            children: "AppIntegrationBinding"
-                          }),
-                          " ",
-                          "- How apps use integrations"
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6(Link6, {
-                            href: "/docs/architecture/knowledge-binding",
-                            className: "text-violet-400 hover:text-violet-300",
-                            children: "AppKnowledgeBinding"
-                          }),
-                          " ",
-                          "- How apps access knowledge"
-                        ]
-                      })
-                    ]
+                    className: "text-muted-foreground text-sm leading-7",
+                    children: "How apps connect to tenant-owned integrations without leaking provider logic everywhere."
                   })
                 ]
               }),
-              /* @__PURE__ */ jsxs6("div", {
-                className: "space-y-3",
+              /* @__PURE__ */ jsxs6(Link6, {
+                href: "/docs/architecture/knowledge-binding",
+                className: "docs-footer-link",
                 children: [
                   /* @__PURE__ */ jsx6("h3", {
-                    className: "text-xl font-semibold",
-                    children: "3. Runtime Layer"
+                    className: "font-semibold text-lg",
+                    children: "Knowledge binding"
                   }),
                   /* @__PURE__ */ jsx6("p", {
-                    className: "text-muted-foreground",
-                    children: "How specifications are executed at runtime:"
-                  }),
-                  /* @__PURE__ */ jsxs6("ul", {
-                    className: "text-muted-foreground ml-4 list-inside list-disc space-y-2",
-                    children: [
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6("strong", {
-                            children: "ResolvedAppConfig"
-                          }),
-                          " - Merged blueprint + tenant config"
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6("strong", {
-                            children: "Policy Decision Point (PDP)"
-                          }),
-                          " - Enforces policies on every operation"
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6(Link6, {
-                            href: "/docs/architecture/control-plane",
-                            className: "text-violet-400 hover:text-violet-300",
-                            children: "Control Plane Runtime"
-                          }),
-                          " ",
-                          "- Deterministic intent to plan to policy to execution loop"
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6("strong", {
-                            children: "Presentation Runtime"
-                          }),
-                          " - React and React Native renderers"
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6("strong", {
-                            children: "Integration Connectors"
-                          }),
-                          " - Execute external API calls"
-                        ]
-                      }),
-                      /* @__PURE__ */ jsxs6("li", {
-                        children: [
-                          /* @__PURE__ */ jsx6("strong", {
-                            children: "Knowledge Retrieval"
-                          }),
-                          " - Query vector databases and knowledge sources"
-                        ]
-                      })
-                    ]
+                    className: "text-muted-foreground text-sm leading-7",
+                    children: "How trusted knowledge enters the system and stays isolated by context and tenant."
                   })
                 ]
-              })
-            ]
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs6("div", {
-        className: "space-y-4",
-        children: [
-          /* @__PURE__ */ jsx6("h2", {
-            className: "text-2xl font-bold",
-            children: "Configuration model"
-          }),
-          /* @__PURE__ */ jsx6("p", {
-            className: "text-muted-foreground",
-            children: "ContractSpec uses a three-tier configuration model:"
-          }),
-          /* @__PURE__ */ jsx6("div", {
-            className: "border-border/50 overflow-x-auto rounded-lg border",
-            children: /* @__PURE__ */ jsxs6("table", {
-              className: "w-full text-left text-sm",
-              children: [
-                /* @__PURE__ */ jsx6("thead", {
-                  className: "bg-card/50",
-                  children: /* @__PURE__ */ jsxs6("tr", {
-                    className: "border-border/50 border-b",
-                    children: [
-                      /* @__PURE__ */ jsx6("th", {
-                        className: "px-4 py-3 font-semibold",
-                        children: "Layer"
-                      }),
-                      /* @__PURE__ */ jsx6("th", {
-                        className: "px-4 py-3 font-semibold",
-                        children: "Type"
-                      }),
-                      /* @__PURE__ */ jsx6("th", {
-                        className: "px-4 py-3 font-semibold",
-                        children: "Scope"
-                      }),
-                      /* @__PURE__ */ jsx6("th", {
-                        className: "px-4 py-3 font-semibold",
-                        children: "Storage"
-                      })
-                    ]
-                  })
-                }),
-                /* @__PURE__ */ jsxs6("tbody", {
-                  className: "divide-border/50 divide-y",
-                  children: [
-                    /* @__PURE__ */ jsxs6("tr", {
-                      children: [
-                        /* @__PURE__ */ jsx6("td", {
-                          className: "px-4 py-3 align-top",
-                          children: /* @__PURE__ */ jsx6("strong", {
-                            children: "Blueprint"
-                          })
-                        }),
-                        /* @__PURE__ */ jsx6("td", {
-                          className: "px-4 py-3 align-top font-mono text-xs",
-                          children: "AppBlueprintSpec"
-                        }),
-                        /* @__PURE__ */ jsx6("td", {
-                          className: "px-4 py-3 align-top",
-                          children: "Global, versioned, no tenant info"
-                        }),
-                        /* @__PURE__ */ jsx6("td", {
-                          className: "px-4 py-3 align-top",
-                          children: "Version control, immutable"
-                        })
-                      ]
-                    }),
-                    /* @__PURE__ */ jsxs6("tr", {
-                      children: [
-                        /* @__PURE__ */ jsx6("td", {
-                          className: "px-4 py-3 align-top",
-                          children: /* @__PURE__ */ jsx6("strong", {
-                            children: "Tenant Config"
-                          })
-                        }),
-                        /* @__PURE__ */ jsx6("td", {
-                          className: "px-4 py-3 align-top font-mono text-xs",
-                          children: "TenantAppConfig"
-                        }),
-                        /* @__PURE__ */ jsx6("td", {
-                          className: "px-4 py-3 align-top",
-                          children: "Per-tenant, per-environment"
-                        }),
-                        /* @__PURE__ */ jsx6("td", {
-                          className: "px-4 py-3 align-top",
-                          children: "Database, mutable"
-                        })
-                      ]
-                    }),
-                    /* @__PURE__ */ jsxs6("tr", {
-                      children: [
-                        /* @__PURE__ */ jsx6("td", {
-                          className: "px-4 py-3 align-top",
-                          children: /* @__PURE__ */ jsx6("strong", {
-                            children: "Resolved Config"
-                          })
-                        }),
-                        /* @__PURE__ */ jsx6("td", {
-                          className: "px-4 py-3 align-top font-mono text-xs",
-                          children: "ResolvedAppConfig"
-                        }),
-                        /* @__PURE__ */ jsx6("td", {
-                          className: "px-4 py-3 align-top",
-                          children: "Runtime, ephemeral"
-                        }),
-                        /* @__PURE__ */ jsx6("td", {
-                          className: "px-4 py-3 align-top",
-                          children: "In-memory, not persisted"
-                        })
-                      ]
-                    })
-                  ]
-                })
-              ]
-            })
-          })
-        ]
-      }),
-      /* @__PURE__ */ jsxs6("div", {
-        className: "space-y-4",
-        children: [
-          /* @__PURE__ */ jsx6("h2", {
-            className: "text-2xl font-bold",
-            children: "Key architectural principles"
-          }),
-          /* @__PURE__ */ jsxs6("ul", {
-            className: "text-muted-foreground list-inside list-disc space-y-2",
-            children: [
-              /* @__PURE__ */ jsxs6("li", {
-                children: [
-                  /* @__PURE__ */ jsx6("strong", {
-                    children: "Spec-first"
-                  }),
-                  " - Everything is defined declaratively before code generation"
-                ]
               }),
-              /* @__PURE__ */ jsxs6("li", {
+              /* @__PURE__ */ jsxs6(Link6, {
+                href: "/docs/architecture/control-plane",
+                className: "docs-footer-link",
                 children: [
-                  /* @__PURE__ */ jsx6("strong", {
-                    children: "Type-safe"
-                  }),
-                  " - All specifications are strongly typed and validated at compile time"
-                ]
-              }),
-              /* @__PURE__ */ jsxs6("li", {
-                children: [
-                  /* @__PURE__ */ jsx6("strong", {
-                    children: "Policy-enforced"
-                  }),
-                  " - Every operation passes through the PDP"
-                ]
-              }),
-              /* @__PURE__ */ jsxs6("li", {
-                children: [
-                  /* @__PURE__ */ jsx6("strong", {
-                    children: "Multi-tenant by default"
-                  }),
-                  " - Tenant isolation is built-in, not bolted on"
-                ]
-              }),
-              /* @__PURE__ */ jsxs6("li", {
-                children: [
-                  /* @__PURE__ */ jsx6("strong", {
-                    children: "Environment-aware"
-                  }),
-                  " - Separate configurations for sandbox, staging, production"
-                ]
-              }),
-              /* @__PURE__ */ jsxs6("li", {
-                children: [
-                  /* @__PURE__ */ jsx6("strong", {
-                    children: "Auditable"
+                  /* @__PURE__ */ jsx6("h3", {
+                    className: "font-semibold text-lg",
+                    children: "Control plane runtime"
                   }),
-                  " - All operations are logged for compliance and debugging"
+                  /* @__PURE__ */ jsx6("p", {
+                    className: "text-muted-foreground text-sm leading-7",
+                    children: "How intent, policy, planning, and execution flow through the system runtime."
+                  })
                 ]
               })
             ]
           })
         ]
-      }),
-      /* @__PURE__ */ jsxs6("div", {
-        className: "flex items-center gap-4 pt-4",
-        children: [
-          /* @__PURE__ */ jsxs6(Link6, {
-            href: "/docs/architecture/app-config",
-            className: "btn-primary",
-            children: [
-              "App Configuration ",
-              /* @__PURE__ */ jsx6(ChevronRight6, {
-                size: 16
-              })
-            ]
-          }),
-          /* @__PURE__ */ jsx6(Link6, {
-            href: "/docs/architecture/control-plane",
-            className: "btn-ghost",
-            children: "Control Plane Runtime"
-          }),
-          /* @__PURE__ */ jsx6(Link6, {
-            href: "/docs/integrations",
-            className: "btn-ghost",
-            children: "Integrations"
-          }),
-          /* @__PURE__ */ jsx6(Link6, {
-            href: "/docs/knowledge",
-            className: "btn-ghost",
-            children: "Knowledge & Context"
-          })
-        ]
       })
     ]
   });