@contractspec/bundle.library 3.9.0 → 3.9.3

package/dist/node/components/docs/architecture/ArchitectureAppConfigPage.js

@@ -1,4 +1,4 @@
-import{CodeBlock as t}from"@contractspec/lib.design-system";import i from"@contractspec/lib.ui-link";import{ChevronRight as o}from"lucide-react";import{jsx as e,jsxs as n}from"react/jsx-runtime";function p(){return n("div",{className:"space-y-8",children:[n("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"App Configuration"}),e("p",{className:"text-muted-foreground",children:"ContractSpec uses a three-tier configuration model that separates global app definitions from tenant-specific settings and runtime resolution."})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"AppBlueprintSpec"}),n("p",{className:"text-muted-foreground",children:["The ",e("strong",{children:"AppBlueprintSpec"})," is the global, versioned definition of your application. It contains no tenant-specific information and is stored in version control."]}),e(t,{language:"typescript",code:`type AppBlueprintSpec = {
+var s=Object.defineProperty;var p=(t)=>t;function c(t,i){this[t]=p.bind(null,i)}var d=(t,i)=>{for(var a in i)s(t,a,{get:i[a],enumerable:!0,configurable:!0,set:c.bind(i,a)})};var g=(t,i)=>()=>(t&&(i=t(t=0)),i);import{CodeBlock as o}from"@contractspec/lib.design-system";import r from"@contractspec/lib.ui-link";import{ChevronRight as l}from"lucide-react";import{jsx as e,jsxs as n}from"react/jsx-runtime";function b(){return n("div",{className:"space-y-8",children:[n("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"App Configuration"}),e("p",{className:"text-muted-foreground",children:"ContractSpec uses a three-tier configuration model that separates global app definitions from tenant-specific settings and runtime resolution."})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"AppBlueprintSpec"}),n("p",{className:"text-muted-foreground",children:["The ",e("strong",{children:"AppBlueprintSpec"})," is the global, versioned definition of your application. It contains no tenant-specific information and is stored in version control."]}),e(o,{language:"typescript",code:`type AppBlueprintSpec = {
   id: string;
   version: string;
   name: string;
@@ -35,7 +35,7 @@ import{CodeBlock as t}from"@contractspec/lib.design-system";import i from"@contr
   
   // Schema evolution
   migrations: MigrationSpec[];
-};`})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"TenantAppConfig"}),n("p",{className:"text-muted-foreground",children:["The ",e("strong",{children:"TenantAppConfig"})," is the per-tenant, per-environment configuration that customizes how a specific tenant uses the app."]}),e(t,{language:"typescript",code:`type TenantAppConfig = {
+};`})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"TenantAppConfig"}),n("p",{className:"text-muted-foreground",children:["The ",e("strong",{children:"TenantAppConfig"})," is the per-tenant, per-environment configuration that customizes how a specific tenant uses the app."]}),e(o,{language:"typescript",code:`type TenantAppConfig = {
   tenantId: string;
   blueprintId: string;
   blueprintVersion: string;
@@ -66,7 +66,7 @@ import{CodeBlock as t}from"@contractspec/lib.design-system";import i from"@contr
   metadata: Record<string, unknown>;
   createdAt: string;
   updatedAt: string;
-};`})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"AppIntegrationBinding"}),e("p",{className:"text-muted-foreground",children:"Defines how a tenant connects specific integration instances to satisfy capabilities and workflows."}),e(t,{language:"typescript",code:`type AppIntegrationBinding = {
+};`})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"AppIntegrationBinding"}),e("p",{className:"text-muted-foreground",children:"Defines how a tenant connects specific integration instances to satisfy capabilities and workflows."}),e(o,{language:"typescript",code:`type AppIntegrationBinding = {
   slotId: string;          // References AppIntegrationSlot.slotId
   connectionId: string;    // References IntegrationConnection.meta.id
   scope?: {
@@ -86,7 +86,7 @@ import{CodeBlock as t}from"@contractspec/lib.design-system";import i from"@contr
     operations: ["payments.stripe.*"]
   },
   priority: 1
-}`})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"AppKnowledgeBinding"}),e("p",{className:"text-muted-foreground",children:"Defines which knowledge spaces a tenant's app can access and how."}),e(t,{language:"typescript",code:`type AppKnowledgeBinding = {
+}`})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"AppKnowledgeBinding"}),e("p",{className:"text-muted-foreground",children:"Defines which knowledge spaces a tenant's app can access and how."}),e(o,{language:"typescript",code:`type AppKnowledgeBinding = {
   spaceId: string;
   enabled: boolean;
   
@@ -116,7 +116,7 @@ import{CodeBlock as t}from"@contractspec/lib.design-system";import i from"@contr
   },
   allowedCategories: ["canonical", "operational"],
   sources: ["src_notion_product_docs", "src_database_schema"]
-}`})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"ResolvedAppConfig"}),n("p",{className:"text-muted-foreground",children:["The ",e("strong",{children:"ResolvedAppConfig"})," is the runtime result of merging AppBlueprintSpec with TenantAppConfig. It's computed on-demand and never persisted."]}),e(t,{language:"typescript",code:`type ResolvedAppConfig = {
+}`})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"ResolvedAppConfig"}),n("p",{className:"text-muted-foreground",children:["The ",e("strong",{children:"ResolvedAppConfig"})," is the runtime result of merging AppBlueprintSpec with TenantAppConfig. It's computed on-demand and never persisted."]}),e(o,{language:"typescript",code:`type ResolvedAppConfig = {
   appId: string;
   tenantId: string;
   blueprintName: string;
@@ -143,4 +143,4 @@ import{CodeBlock as t}from"@contractspec/lib.design-system";import i from"@contr
   knowledge: ResolvedKnowledge[];       // [{ binding, space, sources }]
   branding: ResolvedBranding;           // { appName, assets, colors, domain }
   notes?: string;
-};`})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Configuration flow"}),e("p",{className:"text-muted-foreground",children:"Here's how configuration flows from definition to runtime:"}),n("ol",{className:"list-inside list-decimal space-y-3 text-muted-foreground",children:[n("li",{children:[e("strong",{children:"Development"})," - Define AppBlueprintSpec with required integrations and knowledge spaces"]}),n("li",{children:[e("strong",{children:"Deployment"})," - Deploy blueprint to environment (sandbox, staging, production)"]}),n("li",{children:[e("strong",{children:"Tenant Setup"})," - Create TenantAppConfig with specific integration connections and knowledge sources"]}),n("li",{children:[e("strong",{children:"Runtime"})," - Resolve configuration on-demand when tenant accesses the app"]}),n("li",{children:[e("strong",{children:"Execution"})," - Use ResolvedAppConfig to execute capabilities, workflows, and enforce policies"]})]})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Best practices"}),n("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[e("li",{children:"Keep AppBlueprintSpec environment-agnostic - no secrets or tenant-specific data"}),e("li",{children:"Use TenantAppConfig for all tenant-specific settings and connections"}),e("li",{children:"Cache ResolvedAppConfig per request to avoid repeated resolution"}),e("li",{children:"Version blueprints carefully - migrations affect all tenants"}),e("li",{children:"Test blueprint changes in sandbox before promoting to production"})]})]}),n("div",{className:"flex items-center gap-4 pt-4",children:[e(i,{href:"/docs/architecture",className:"btn-ghost",children:"Back to Architecture"}),n(i,{href:"/docs/architecture/integration-binding",className:"btn-primary",children:["Integration Binding ",e(o,{size:16})]})]})]})}export{p as ArchitectureAppConfigPage};
+};`})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Configuration flow"}),e("p",{className:"text-muted-foreground",children:"Here's how configuration flows from definition to runtime:"}),n("ol",{className:"list-inside list-decimal space-y-3 text-muted-foreground",children:[n("li",{children:[e("strong",{children:"Development"})," - Define AppBlueprintSpec with required integrations and knowledge spaces"]}),n("li",{children:[e("strong",{children:"Deployment"})," - Deploy blueprint to environment (sandbox, staging, production)"]}),n("li",{children:[e("strong",{children:"Tenant Setup"})," - Create TenantAppConfig with specific integration connections and knowledge sources"]}),n("li",{children:[e("strong",{children:"Runtime"})," - Resolve configuration on-demand when tenant accesses the app"]}),n("li",{children:[e("strong",{children:"Execution"})," - Use ResolvedAppConfig to execute capabilities, workflows, and enforce policies"]})]})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Best practices"}),n("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[e("li",{children:"Keep AppBlueprintSpec environment-agnostic - no secrets or tenant-specific data"}),e("li",{children:"Use TenantAppConfig for all tenant-specific settings and connections"}),e("li",{children:"Cache ResolvedAppConfig per request to avoid repeated resolution"}),e("li",{children:"Version blueprints carefully - migrations affect all tenants"}),e("li",{children:"Test blueprint changes in sandbox before promoting to production"})]})]}),n("div",{className:"flex items-center gap-4 pt-4",children:[e(r,{href:"/docs/architecture",className:"btn-ghost",children:"Back to Architecture"}),n(r,{href:"/docs/architecture/integration-binding",className:"btn-primary",children:["Integration Binding ",e(l,{size:16})]})]})]})}export{b as ArchitectureAppConfigPage};

package/dist/node/components/docs/architecture/ArchitectureControlPlanePage.js

@@ -1,4 +1,4 @@
-import{CodeBlock as o}from"@contractspec/lib.design-system";import n from"@contractspec/lib.ui-link";import{ChevronRight as l}from"lucide-react";import{jsx as e,jsxs as t}from"react/jsx-runtime";function r(){return t("div",{className:"space-y-8",children:[t("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"Control Plane Runtime"}),e("p",{className:"text-muted-foreground",children:"The control plane is the governance layer for agentic execution. It turns incoming intent into deterministic plans, enforces risk policy before side effects, and records replayable traces for audits."})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Canonical execution loop"}),t("ol",{className:"list-inside list-decimal space-y-2 text-muted-foreground",children:[e("li",{children:"Accept intent and create execution identity + trace context."}),e("li",{children:"Compile intent into a typed, deterministic plan DAG."}),e("li",{children:"Verify plan against policy and risk rules."}),e("li",{children:"Route into autonomous or assist mode based on verdict."}),e("li",{children:"Execute steps with idempotent keys and explicit stage events."}),e("li",{children:"Persist outcomes for replay, audits, and operator visibility."})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Contract surfaces (v1 baseline)"}),t("p",{className:"text-muted-foreground",children:["The runtime is contract-first. Commands, queries, events, and capabilities are explicit and versioned under",e("code",{children:" @contractspec/lib.contracts-spec"}),"."]}),e(o,{language:"text",code:`Commands
+var c=Object.defineProperty;var r=(n)=>n;function s(n,o){this[n]=r.bind(null,o)}var d=(n,o)=>{for(var a in o)c(n,a,{get:o[a],enumerable:!0,configurable:!0,set:s.bind(o,a)})};var m=(n,o)=>()=>(n&&(o=n(n=0)),o);import{CodeBlock as i}from"@contractspec/lib.design-system";import l from"@contractspec/lib.ui-link";import{ChevronRight as p}from"lucide-react";import{jsx as e,jsxs as t}from"react/jsx-runtime";function v(){return t("div",{className:"space-y-8",children:[t("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"Control Plane Runtime"}),e("p",{className:"text-muted-foreground",children:"The control plane is the governance layer for agentic execution. It turns incoming intent into deterministic plans, enforces risk policy before side effects, and records replayable traces for audits."})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Canonical execution loop"}),t("ol",{className:"list-inside list-decimal space-y-2 text-muted-foreground",children:[e("li",{children:"Accept intent and create execution identity + trace context."}),e("li",{children:"Compile intent into a typed, deterministic plan DAG."}),e("li",{children:"Verify plan against policy and risk rules."}),e("li",{children:"Route into autonomous or assist mode based on verdict."}),e("li",{children:"Execute steps with idempotent keys and explicit stage events."}),e("li",{children:"Persist outcomes for replay, audits, and operator visibility."})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Contract surfaces (v1 baseline)"}),t("p",{className:"text-muted-foreground",children:["The runtime is contract-first. Commands, queries, events, and capabilities are explicit and versioned under",e("code",{children:" @contractspec/lib.contracts-spec"}),"."]}),e(i,{language:"text",code:`Commands
 - controlPlane.intent.submit
 - controlPlane.plan.compile
 - controlPlane.plan.verify
@@ -34,7 +34,7 @@ Capabilities
 - control-plane.approval
 - control-plane.audit
 - control-plane.skill-registry
-- control-plane.channel-runtime`})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Policy and safety posture"}),t("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[e("li",{children:"No side-effect action executes unless it comes from a compiled plan."}),e("li",{children:"High-risk actions are blocked from autonomous mode in v1."}),e("li",{children:"Approval commands provide explicit human-in-the-loop transitions."}),e("li",{children:"Skill installation is modeled as governance-controlled operations."}),e("li",{children:"Trace queries expose policy rationale and step outcomes for replay."})]})]}),t("section",{className:"editorial-panel space-y-4",children:[e("h2",{className:"font-serif text-3xl tracking-[-0.03em]",children:"Apply the runtime locally with Connect"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"The control plane defines the governance contracts. Connect is the local adapter that turns those contracts into task-scoped context, plan, verification, review, and replay flows for coding agents."}),t("div",{className:"flex flex-wrap gap-3",children:[e(n,{href:"/docs/specs/connect",className:"btn-primary",children:"Connect spec"}),e(n,{href:"/docs/guides/connect-in-a-repo",className:"btn-ghost",children:"Use Connect in a repo"})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Implementation map"}),e(o,{language:"text",code:`packages/libs/contracts-spec/src/control-plane/
+- control-plane.channel-runtime`})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Policy and safety posture"}),t("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[e("li",{children:"No side-effect action executes unless it comes from a compiled plan."}),e("li",{children:"High-risk actions are blocked from autonomous mode in v1."}),e("li",{children:"Approval commands provide explicit human-in-the-loop transitions."}),e("li",{children:"Skill installation is modeled as governance-controlled operations."}),e("li",{children:"Trace queries expose policy rationale and step outcomes for replay."})]})]}),t("section",{className:"editorial-panel space-y-4",children:[e("h2",{className:"font-serif text-3xl tracking-[-0.03em]",children:"Apply the runtime locally with Connect"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"The control plane defines the governance contracts. Connect is the local adapter that turns those contracts into task-scoped context, plan, verification, review, and replay flows for coding agents."}),t("div",{className:"flex flex-wrap gap-3",children:[e(l,{href:"/docs/specs/connect",className:"btn-primary",children:"Connect spec"}),e(l,{href:"/docs/guides/connect-in-a-repo",className:"btn-ghost",children:"Use Connect in a repo"})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Implementation map"}),e(i,{language:"text",code:`packages/libs/contracts-spec/src/control-plane/
   commands/
   queries/
   events/
@@ -43,4 +43,4 @@ Capabilities
   contracts.test.ts
 
 packages/apps/web-landing/src/app/docs/architecture/control-plane/page.tsx
-implementation_plan_controle_plane.md`})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"What comes next"}),e("p",{className:"text-muted-foreground",children:"WS1 delivers the contract fabric. Next increments add planner/executor split, policy escalation, capability-bound authorization, signed skill compatibility checks, and full replay tooling."})]}),t("div",{className:"flex items-center gap-4 pt-4",children:[e(n,{href:"/docs/architecture/integration-binding",className:"btn-ghost",children:"Previous: Integration Binding"}),t(n,{href:"/docs/safety/auditing",className:"btn-primary",children:["Audit Logs ",e(l,{size:16})]})]})]})}export{r as ArchitectureControlPlanePage};
+implementation_plan_controle_plane.md`})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"What comes next"}),e("p",{className:"text-muted-foreground",children:"WS1 delivers the contract fabric. Next increments add planner/executor split, policy escalation, capability-bound authorization, signed skill compatibility checks, and full replay tooling."})]}),t("div",{className:"flex items-center gap-4 pt-4",children:[e(l,{href:"/docs/architecture/integration-binding",className:"btn-ghost",children:"Previous: Integration Binding"}),t(l,{href:"/docs/safety/auditing",className:"btn-primary",children:["Audit Logs ",e(p,{size:16})]})]})]})}export{v as ArchitectureControlPlanePage};

package/dist/node/components/docs/architecture/ArchitectureIntegrationBindingPage.js

@@ -1,4 +1,4 @@
-import{CodeBlock as t}from"@contractspec/lib.design-system";import o from"@contractspec/lib.ui-link";import{ChevronRight as i}from"lucide-react";import{jsx as e,jsxs as n}from"react/jsx-runtime";function s(){return n("div",{className:"space-y-8",children:[n("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"Integration Binding"}),e("p",{className:"text-muted-foreground",children:"Integration binding connects your app's capabilities to external service providers. Each tenant can configure their own integration connections while sharing the same app blueprint."})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"How it works"}),e("p",{className:"text-muted-foreground",children:"Integration binding follows a three-layer model:"}),n("ol",{className:"list-inside list-decimal space-y-3 text-muted-foreground",children:[n("li",{children:[e("strong",{children:"IntegrationSpec"})," (global) - Defines what an integration provides"]}),n("li",{children:[e("strong",{children:"IntegrationConnection"})," (per-tenant) - A tenant's configured connection"]}),n("li",{children:[e("strong",{children:"AppIntegrationBinding"})," (per-app) - Maps named slots to concrete tenant connections"]})]})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Example: Payment processing"}),e("p",{className:"text-muted-foreground",children:"Let's walk through a complete example of binding Stripe for payments."}),n("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 1: Blueprint declares requirement"}),e(t,{language:"typescript",code:`// AppBlueprintSpec
+var c=Object.defineProperty;var s=(t)=>t;function l(t,o){this[t]=s.bind(null,o)}var d=(t,o)=>{for(var a in o)c(t,a,{get:o[a],enumerable:!0,configurable:!0,set:l.bind(o,a)})};var m=(t,o)=>()=>(t&&(o=t(t=0)),o);import{CodeBlock as i}from"@contractspec/lib.design-system";import r from"@contractspec/lib.ui-link";import{ChevronRight as p}from"lucide-react";import{jsx as e,jsxs as n}from"react/jsx-runtime";function h(){return n("div",{className:"space-y-8",children:[n("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"Integration Binding"}),e("p",{className:"text-muted-foreground",children:"Integration binding connects your app's capabilities to external service providers. Each tenant can configure their own integration connections while sharing the same app blueprint."})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"How it works"}),e("p",{className:"text-muted-foreground",children:"Integration binding follows a three-layer model:"}),n("ol",{className:"list-inside list-decimal space-y-3 text-muted-foreground",children:[n("li",{children:[e("strong",{children:"IntegrationSpec"})," (global) - Defines what an integration provides"]}),n("li",{children:[e("strong",{children:"IntegrationConnection"})," (per-tenant) - A tenant's configured connection"]}),n("li",{children:[e("strong",{children:"AppIntegrationBinding"})," (per-app) - Maps named slots to concrete tenant connections"]})]})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Example: Payment processing"}),e("p",{className:"text-muted-foreground",children:"Let's walk through a complete example of binding Stripe for payments."}),n("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 1: Blueprint declares requirement"}),e(i,{language:"typescript",code:`// AppBlueprintSpec
 {
   meta: { name: "invoice-app", version: '1.0.0', appId: "invoice" },
   integrationSlots: [
@@ -22,7 +22,7 @@ import{CodeBlock as t}from"@contractspec/lib.design-system";import o from"@contr
     assets: [{ type: "logo", url: "https://cdn.acme.dev/logo.png" }],
     colorTokens: { primary: "colors.brand.primary" }
   }
-}`})]}),n("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 2: Tenant creates connection"}),e(t,{language:"typescript",code:`// IntegrationConnection
+}`})]}),n("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 2: Tenant creates connection"}),e(i,{language:"typescript",code:`// IntegrationConnection
 {
   meta: {
     id: "conn_stripe_acme_prod",
@@ -42,7 +42,7 @@ import{CodeBlock as t}from"@contractspec/lib.design-system";import o from"@contr
   },
   secretRef: "vault://integrations/acme/conn_stripe_acme_prod",
   status: "active"
-}`})]}),n("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 3: TenantAppConfig binds connection"}),e(t,{language:"typescript",code:`// TenantAppConfig
+}`})]}),n("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 3: TenantAppConfig binds connection"}),e(i,{language:"typescript",code:`// TenantAppConfig
 {
   meta: {
     tenantId: "acme-corp",
@@ -68,7 +68,7 @@ import{CodeBlock as t}from"@contractspec/lib.design-system";import o from"@contr
     customDomain: "billing.acme.com",
     assets: [{ type: "logo", url: "https://assets.acme.com/logo.svg" }]
   }
-}`})]}),n("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 4: Runtime resolves and executes"}),e(t,{language:"typescript",code:`// ResolvedAppConfig (runtime)
+}`})]}),n("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 4: Runtime resolves and executes"}),e(i,{language:"typescript",code:`// ResolvedAppConfig (runtime)
 {
   integrations: {
     "payments.createPaymentIntent": {
@@ -85,7 +85,7 @@ const result = await executeCapability(
   { amount: 5000, currency: "usd" },
   resolvedConfig
 );
-// → Uses Stripe connection automatically`})]})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Multi-integration scenarios"}),e("p",{className:"text-muted-foreground",children:"A single app can use multiple integrations across different categories:"}),e(t,{language:"typescript",code:`integrations: [
+// → Uses Stripe connection automatically`})]})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Multi-integration scenarios"}),e("p",{className:"text-muted-foreground",children:"A single app can use multiple integrations across different categories:"}),e(i,{language:"typescript",code:`integrations: [
   {
     slotId: "payments.primary",
     connectionId: "conn_stripe_prod",
@@ -111,7 +111,7 @@ const result = await executeCapability(
       workflows: ["semantic-search", "rag-query"]
     }
   }
-]`})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Sandbox vs Production"}),e("p",{className:"text-muted-foreground",children:"Tenants typically maintain separate connections for sandbox and production environments:"}),e(t,{language:"typescript",code:`// Sandbox environment
+]`})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Sandbox vs Production"}),e("p",{className:"text-muted-foreground",children:"Tenants typically maintain separate connections for sandbox and production environments:"}),e(i,{language:"typescript",code:`// Sandbox environment
 {
   meta: { environment: "sandbox", status: "preview" },
   integrations: [
@@ -131,4 +131,4 @@ const result = await executeCapability(
       connectionId: "conn_stripe_acme_prod"
     }
   ]
-}`})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Security & validation"}),n("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[e("li",{children:"Integration connections are validated before binding - health checks ensure connectivity"}),e("li",{children:"Secrets are never stored in TenantAppConfig - only references to encrypted secrets"}),e("li",{children:"Policy Decision Point (PDP) enforces which workflows can use which integrations"}),e("li",{children:"All integration calls are audited with full request/response logging"}),e("li",{children:"Rate limiting and quotas are enforced per connection"})]})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Best practices"}),n("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[n("li",{children:["Use wildcard patterns sparingly in ",e("code",{children:"allowedWorkflows"})," - be explicit about access"]}),e("li",{children:"Always maintain separate sandbox and production connections"}),e("li",{children:"Monitor integration health checks and set up alerts for failures"}),e("li",{children:"Document the purpose of each integration binding for your team"}),e("li",{children:"Test integration changes in sandbox before promoting to production"})]})]}),n("div",{className:"flex items-center gap-4 pt-4",children:[e(o,{href:"/docs/architecture/app-config",className:"btn-ghost",children:"Previous: App Configuration"}),n(o,{href:"/docs/architecture/knowledge-binding",className:"btn-primary",children:["Knowledge Binding ",e(i,{size:16})]})]})]})}export{s as ArchitectureIntegrationBindingPage};
+}`})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Security & validation"}),n("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[e("li",{children:"Integration connections are validated before binding - health checks ensure connectivity"}),e("li",{children:"Secrets are never stored in TenantAppConfig - only references to encrypted secrets"}),e("li",{children:"Policy Decision Point (PDP) enforces which workflows can use which integrations"}),e("li",{children:"All integration calls are audited with full request/response logging"}),e("li",{children:"Rate limiting and quotas are enforced per connection"})]})]}),n("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Best practices"}),n("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[n("li",{children:["Use wildcard patterns sparingly in ",e("code",{children:"allowedWorkflows"})," - be explicit about access"]}),e("li",{children:"Always maintain separate sandbox and production connections"}),e("li",{children:"Monitor integration health checks and set up alerts for failures"}),e("li",{children:"Document the purpose of each integration binding for your team"}),e("li",{children:"Test integration changes in sandbox before promoting to production"})]})]}),n("div",{className:"flex items-center gap-4 pt-4",children:[e(r,{href:"/docs/architecture/app-config",className:"btn-ghost",children:"Previous: App Configuration"}),n(r,{href:"/docs/architecture/knowledge-binding",className:"btn-primary",children:["Knowledge Binding ",e(p,{size:16})]})]})]})}export{h as ArchitectureIntegrationBindingPage};

package/dist/node/components/docs/architecture/ArchitectureKnowledgeBindingPage.js

@@ -1,4 +1,4 @@
-import{CodeBlock as a}from"@contractspec/lib.design-system";import o from"@contractspec/lib.ui-link";import{ChevronRight as s}from"lucide-react";import{jsx as e,jsxs as t}from"react/jsx-runtime";function r(){return t("div",{className:"space-y-8",children:[t("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"Knowledge Binding"}),e("p",{className:"text-muted-foreground",children:"Knowledge binding connects your app's workflows and agents to structured knowledge spaces. This enables semantic search, RAG (Retrieval-Augmented Generation), and context-aware decision-making."})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"How it works"}),e("p",{className:"text-muted-foreground",children:"Knowledge binding follows a three-layer model:"}),t("ol",{className:"list-inside list-decimal space-y-3 text-muted-foreground",children:[t("li",{children:[e("strong",{children:"KnowledgeSpaceSpec"})," (global) - Defines a logical knowledge domain"]}),t("li",{children:[e("strong",{children:"KnowledgeSourceConfig"})," (per-tenant) - Tenant's data sources feeding spaces"]}),t("li",{children:[e("strong",{children:"AppKnowledgeBinding"})," (per-app) - Maps spaces to workflows/agents"]})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Example: Support agent with RAG"}),e("p",{className:"text-muted-foreground",children:"Let's build a support agent that uses canonical product documentation and operational support history."}),t("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 1: Blueprint declares knowledge needs"}),e(a,{language:"typescript",code:`// AppBlueprintSpec
+var c=Object.defineProperty;var r=(a)=>a;function l(a,o){this[a]=r.bind(null,o)}var p=(a,o)=>{for(var n in o)c(a,n,{get:o[n],enumerable:!0,configurable:!0,set:l.bind(o,n)})};var u=(a,o)=>()=>(a&&(o=a(a=0)),o);import{CodeBlock as s}from"@contractspec/lib.design-system";import i from"@contractspec/lib.ui-link";import{ChevronRight as d}from"lucide-react";import{jsx as e,jsxs as t}from"react/jsx-runtime";function w(){return t("div",{className:"space-y-8",children:[t("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"Knowledge Binding"}),e("p",{className:"text-muted-foreground",children:"Knowledge binding connects your app's workflows and agents to structured knowledge spaces. This enables semantic search, RAG (Retrieval-Augmented Generation), and context-aware decision-making."})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"How it works"}),e("p",{className:"text-muted-foreground",children:"Knowledge binding follows a three-layer model:"}),t("ol",{className:"list-inside list-decimal space-y-3 text-muted-foreground",children:[t("li",{children:[e("strong",{children:"KnowledgeSpaceSpec"})," (global) - Defines a logical knowledge domain"]}),t("li",{children:[e("strong",{children:"KnowledgeSourceConfig"})," (per-tenant) - Tenant's data sources feeding spaces"]}),t("li",{children:[e("strong",{children:"AppKnowledgeBinding"})," (per-app) - Maps spaces to workflows/agents"]})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Example: Support agent with RAG"}),e("p",{className:"text-muted-foreground",children:"Let's build a support agent that uses canonical product documentation and operational support history."}),t("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 1: Blueprint declares knowledge needs"}),e(s,{language:"typescript",code:`// AppBlueprintSpec
 {
   id: "support-app",
   version: "1.0.0",
@@ -22,7 +22,7 @@ import{CodeBlock as a}from"@contractspec/lib.design-system";import o from"@contr
       purpose: "Third-party integration documentation"
     }
   ]
-}`})]}),t("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 2: Tenant configures sources"}),e(a,{language:"typescript",code:`// KnowledgeSourceConfig (per-tenant)
+}`})]}),t("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 2: Tenant configures sources"}),e(s,{language:"typescript",code:`// KnowledgeSourceConfig (per-tenant)
 [
   {
     id: "src_notion_product_docs",
@@ -51,7 +51,7 @@ import{CodeBlock as a}from"@contractspec/lib.design-system";import o from"@contr
     syncPolicy: { interval: "24h" },
     lastSyncedAt: "2025-01-15T00:00:00Z"
   }
-]`})]}),t("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 3: TenantAppConfig binds spaces"}),e(a,{language:"typescript",code:`// TenantAppConfig
+]`})]}),t("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 3: TenantAppConfig binds spaces"}),e(s,{language:"typescript",code:`// TenantAppConfig
 {
   tenantId: "acme-corp",
   blueprintId: "support-app",
@@ -87,7 +87,7 @@ import{CodeBlock as a}from"@contractspec/lib.design-system";import o from"@contr
       sources: ["src_stripe_docs"]
     }
   ]
-}`})]}),t("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 4: Workflow uses knowledge"}),e(a,{language:"yaml",code:`// WorkflowSpec
+}`})]}),t("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 4: Workflow uses knowledge"}),e(s,{language:"yaml",code:`// WorkflowSpec
 workflowId: answer-question
 version: '1.0.0'.0.0
 
@@ -129,7 +129,7 @@ steps:
             \${steps.search-canonical.output.results}
             
             Support history:
-            \${steps.search-support-history.output.results}`})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Category-based access control"}),e("p",{className:"text-muted-foreground",children:"Different knowledge categories have different trust levels and access patterns:"}),e("div",{className:"overflow-x-auto rounded-lg border border-border/50",children:t("table",{className:"w-full text-left text-sm",children:[e("thead",{className:"bg-card/50",children:t("tr",{className:"border-border/50 border-b",children:[e("th",{className:"px-4 py-3 font-semibold",children:"Category"}),e("th",{className:"px-4 py-3 font-semibold",children:"Trust Level"}),e("th",{className:"px-4 py-3 font-semibold",children:"Use Cases"}),e("th",{className:"px-4 py-3 font-semibold",children:"Policy Impact"})]})}),t("tbody",{className:"divide-y divide-border/50",children:[t("tr",{children:[e("td",{className:"px-4 py-3 font-mono text-xs",children:"canonical"}),e("td",{className:"px-4 py-3",children:"Highest"}),e("td",{className:"px-4 py-3",children:"Product specs, schemas, official policies"}),e("td",{className:"px-4 py-3",children:"Can drive policy decisions"})]}),t("tr",{children:[e("td",{className:"px-4 py-3 font-mono text-xs",children:"operational"}),e("td",{className:"px-4 py-3",children:"High"}),e("td",{className:"px-4 py-3",children:"Support tickets, sales docs, internal runbooks"}),e("td",{className:"px-4 py-3",children:"Can inform decisions"})]}),t("tr",{children:[e("td",{className:"px-4 py-3 font-mono text-xs",children:"external"}),e("td",{className:"px-4 py-3",children:"Medium"}),e("td",{className:"px-4 py-3",children:"Third-party docs, regulations, PSP guides"}),e("td",{className:"px-4 py-3",children:"Reference only, not authoritative"})]}),t("tr",{children:[e("td",{className:"px-4 py-3 font-mono text-xs",children:"ephemeral"}),e("td",{className:"px-4 py-3",children:"Low"}),e("td",{className:"px-4 py-3",children:"Agent scratchpads, session context, drafts"}),e("td",{className:"px-4 py-3",children:"Never used for decisions"})]})]})]})})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Multi-space workflows"}),e("p",{className:"text-muted-foreground",children:"Workflows can query multiple knowledge spaces and combine results:"}),e(a,{language:"typescript",code:`knowledgeBindings: [
+            \${steps.search-support-history.output.results}`})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Category-based access control"}),e("p",{className:"text-muted-foreground",children:"Different knowledge categories have different trust levels and access patterns:"}),e("div",{className:"overflow-x-auto rounded-lg border border-border/50",children:t("table",{className:"w-full text-left text-sm",children:[e("thead",{className:"bg-card/50",children:t("tr",{className:"border-border/50 border-b",children:[e("th",{className:"px-4 py-3 font-semibold",children:"Category"}),e("th",{className:"px-4 py-3 font-semibold",children:"Trust Level"}),e("th",{className:"px-4 py-3 font-semibold",children:"Use Cases"}),e("th",{className:"px-4 py-3 font-semibold",children:"Policy Impact"})]})}),t("tbody",{className:"divide-y divide-border/50",children:[t("tr",{children:[e("td",{className:"px-4 py-3 font-mono text-xs",children:"canonical"}),e("td",{className:"px-4 py-3",children:"Highest"}),e("td",{className:"px-4 py-3",children:"Product specs, schemas, official policies"}),e("td",{className:"px-4 py-3",children:"Can drive policy decisions"})]}),t("tr",{children:[e("td",{className:"px-4 py-3 font-mono text-xs",children:"operational"}),e("td",{className:"px-4 py-3",children:"High"}),e("td",{className:"px-4 py-3",children:"Support tickets, sales docs, internal runbooks"}),e("td",{className:"px-4 py-3",children:"Can inform decisions"})]}),t("tr",{children:[e("td",{className:"px-4 py-3 font-mono text-xs",children:"external"}),e("td",{className:"px-4 py-3",children:"Medium"}),e("td",{className:"px-4 py-3",children:"Third-party docs, regulations, PSP guides"}),e("td",{className:"px-4 py-3",children:"Reference only, not authoritative"})]}),t("tr",{children:[e("td",{className:"px-4 py-3 font-mono text-xs",children:"ephemeral"}),e("td",{className:"px-4 py-3",children:"Low"}),e("td",{className:"px-4 py-3",children:"Agent scratchpads, session context, drafts"}),e("td",{className:"px-4 py-3",children:"Never used for decisions"})]})]})]})})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Multi-space workflows"}),e("p",{className:"text-muted-foreground",children:"Workflows can query multiple knowledge spaces and combine results:"}),e(s,{language:"typescript",code:`knowledgeBindings: [
   {
     spaceId: "product-canon",
     enabled: true,
@@ -157,4 +157,4 @@ steps:
     allowedCategories: ["operational"],
     sources: ["src_crm_data", "src_past_invoices"]
   }
-]`})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Security & validation"}),t("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[e("li",{children:"Knowledge sources are validated before sync - credentials and permissions checked"}),e("li",{children:"PDP enforces which workflows/agents can access which spaces"}),e("li",{children:"All knowledge queries are audited with search terms and results"}),e("li",{children:"Canonical knowledge is immutable once indexed - changes require re-sync"}),e("li",{children:"Ephemeral knowledge is automatically purged based on retention policies"})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Best practices"}),t("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[e("li",{children:"Use canonical spaces for policy-critical decisions, operational for suggestions"}),e("li",{children:"Never allow workflows to write to canonical spaces - maintain read-only access"}),e("li",{children:"Set up monitoring for sync failures and stale knowledge sources"}),e("li",{children:"Document the purpose and trust level of each knowledge space"}),e("li",{children:"Test knowledge queries in sandbox before promoting to production"}),t("li",{children:["Use explicit ",e("code",{children:"allowedConsumers"})," - avoid wildcard access"]})]})]}),t("div",{className:"flex items-center gap-4 pt-4",children:[e(o,{href:"/docs/architecture/integration-binding",className:"btn-ghost",children:"Previous: Integration Binding"}),t(o,{href:"/docs/knowledge",className:"btn-primary",children:["Knowledge & Context ",e(s,{size:16})]})]})]})}export{r as ArchitectureKnowledgeBindingPage};
+]`})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Security & validation"}),t("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[e("li",{children:"Knowledge sources are validated before sync - credentials and permissions checked"}),e("li",{children:"PDP enforces which workflows/agents can access which spaces"}),e("li",{children:"All knowledge queries are audited with search terms and results"}),e("li",{children:"Canonical knowledge is immutable once indexed - changes require re-sync"}),e("li",{children:"Ephemeral knowledge is automatically purged based on retention policies"})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Best practices"}),t("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[e("li",{children:"Use canonical spaces for policy-critical decisions, operational for suggestions"}),e("li",{children:"Never allow workflows to write to canonical spaces - maintain read-only access"}),e("li",{children:"Set up monitoring for sync failures and stale knowledge sources"}),e("li",{children:"Document the purpose and trust level of each knowledge space"}),e("li",{children:"Test knowledge queries in sandbox before promoting to production"}),t("li",{children:["Use explicit ",e("code",{children:"allowedConsumers"})," - avoid wildcard access"]})]})]}),t("div",{className:"flex items-center gap-4 pt-4",children:[e(i,{href:"/docs/architecture/integration-binding",className:"btn-ghost",children:"Previous: Integration Binding"}),t(i,{href:"/docs/knowledge",className:"btn-primary",children:["Knowledge & Context ",e(d,{size:16})]})]})]})}export{w as ArchitectureKnowledgeBindingPage};

package/dist/node/components/docs/architecture/ArchitectureMultiTenancyPage.js

@@ -1,8 +1,8 @@
-import{CodeBlock as a}from"@contractspec/lib.design-system";import n from"@contractspec/lib.ui-link";import{ChevronRight as i}from"lucide-react";import{jsx as e,jsxs as t}from"react/jsx-runtime";function l(){return t("div",{className:"space-y-8",children:[t("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"Multi-Tenancy"}),e("p",{className:"text-muted-foreground",children:"ContractSpec is designed from the ground up for multi-tenancy. Apps built with ContractSpec can serve multiple organizations (tenants) from a single deployment, while ensuring strict data isolation and configuration separation."})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Core Concepts"}),t("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[t("li",{children:[e("strong",{children:"Tenant"}),": An organization or customer that uses your app. Each tenant has a unique ",e("code",{children:"tenantId"}),"."]}),t("li",{children:[e("strong",{children:"Tenant Isolation"}),": Data and configuration for one tenant is never accessible to another tenant unless explicitly shared."]}),t("li",{children:[e("strong",{children:"Tenant Context"}),": Every request and operation runs within the context of a specific tenant."]})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Tenant Resolution"}),e("p",{className:"text-muted-foreground",children:"The runtime automatically resolves the tenant context for every request based on:"}),t("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[t("li",{children:["Subdomain (e.g., ",e("code",{children:"acme.app.com"}),")"]}),t("li",{children:["Custom Domain (e.g., ",e("code",{children:"portal.acme.com"}),")"]}),t("li",{children:["Header (e.g., ",e("code",{children:"x-tenant-id: acme-corp"}),")"]}),e("li",{children:"Authentication Token (embedded tenant claim)"})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Configuration Isolation"}),t("p",{className:"text-muted-foreground",children:["Each tenant has its own ",e("code",{children:"TenantAppConfig"})," which defines:"]}),e(a,{language:"typescript",code:`type TenantAppConfig = {
+var c=Object.defineProperty;var r=(n)=>n;function l(n,a){this[n]=r.bind(null,a)}var p=(n,a)=>{for(var i in a)c(n,i,{get:a[i],enumerable:!0,configurable:!0,set:l.bind(a,i)})};var u=(n,a)=>()=>(n&&(a=n(n=0)),a);import{CodeBlock as d}from"@contractspec/lib.design-system";import o from"@contractspec/lib.ui-link";import{ChevronRight as s}from"lucide-react";import{jsx as e,jsxs as t}from"react/jsx-runtime";function y(){return t("div",{className:"space-y-8",children:[t("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"Multi-Tenancy"}),e("p",{className:"text-muted-foreground",children:"ContractSpec is designed from the ground up for multi-tenancy. Apps built with ContractSpec can serve multiple organizations (tenants) from a single deployment, while ensuring strict data isolation and configuration separation."})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Core Concepts"}),t("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[t("li",{children:[e("strong",{children:"Tenant"}),": An organization or customer that uses your app. Each tenant has a unique ",e("code",{children:"tenantId"}),"."]}),t("li",{children:[e("strong",{children:"Tenant Isolation"}),": Data and configuration for one tenant is never accessible to another tenant unless explicitly shared."]}),t("li",{children:[e("strong",{children:"Tenant Context"}),": Every request and operation runs within the context of a specific tenant."]})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Tenant Resolution"}),e("p",{className:"text-muted-foreground",children:"The runtime automatically resolves the tenant context for every request based on:"}),t("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[t("li",{children:["Subdomain (e.g., ",e("code",{children:"acme.app.com"}),")"]}),t("li",{children:["Custom Domain (e.g., ",e("code",{children:"portal.acme.com"}),")"]}),t("li",{children:["Header (e.g., ",e("code",{children:"x-tenant-id: acme-corp"}),")"]}),e("li",{children:"Authentication Token (embedded tenant claim)"})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Configuration Isolation"}),t("p",{className:"text-muted-foreground",children:["Each tenant has its own ",e("code",{children:"TenantAppConfig"})," which defines:"]}),e(d,{language:"typescript",code:`type TenantAppConfig = {
   tenantId: string;
   blueprintId: string;
   // ...
   integrationBindings: AppIntegrationBinding[];
   knowledgeBindings: AppKnowledgeBinding[];
   featureFlags: Record<string, boolean>;
-};`}),e("p",{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."})]}),t("div",{className:"flex items-center gap-4 pt-4",children:[e(n,{href:"/docs/architecture",className:"btn-ghost",children:"Back to Architecture"}),t(n,{href:"/docs/libraries/multi-tenancy",className:"btn-primary",children:["Multi-Tenancy Library ",e(i,{size:16})]})]})]})}export{l as ArchitectureMultiTenancyPage};
+};`}),e("p",{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."})]}),t("div",{className:"flex items-center gap-4 pt-4",children:[e(o,{href:"/docs/architecture",className:"btn-ghost",children:"Back to Architecture"}),t(o,{href:"/docs/libraries/multi-tenancy",className:"btn-primary",children:["Multi-Tenancy Library ",e(s,{size:16})]})]})]})}export{y as ArchitectureMultiTenancyPage};

package/dist/node/components/docs/architecture/ArchitectureOverviewPage.js

@@ -1 +1 @@
-import a from"@contractspec/lib.ui-link";import{jsx as e,jsxs as t}from"react/jsx-runtime";var o=[{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 l(){return t("div",{className:"space-y-10",children:[t("div",{className:"space-y-3",children:[e("p",{className:"editorial-kicker",children:"Build"}),e("h1",{className:"font-serif text-4xl tracking-[-0.04em] md:text-5xl",children:"The architecture keeps contracts, runtime behavior, and operations in the same system."}),e("p",{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."})]}),e("div",{className:"grid gap-4 md:grid-cols-2",children:o.map((n)=>t("article",{className:"editorial-panel space-y-3",children:[e("h2",{className:"font-semibold text-xl",children:n.title}),e("p",{className:"text-muted-foreground text-sm leading-7",children:n.body})]},n.title))}),t("section",{className:"editorial-panel space-y-5",children:[t("div",{className:"space-y-2",children:[e("h2",{className:"font-serif text-3xl tracking-[-0.03em]",children:"UI composition belongs in the bundle runtime layer"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"When the system needs adaptive layouts, entity workbenches, assistant slots, and safe overlays, use module bundles as the layer between the contract model and the rendered surface."})]}),t("div",{className:"grid gap-4 md:grid-cols-2",children:[t(a,{href:"/docs/specs/module-bundles",className:"docs-footer-link",children:[e("h3",{className:"font-semibold text-lg",children:"Module bundles spec"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"See the typed bundle contract, resolved surface plan model, and bounded AI/runtime behavior."})]}),t(a,{href:"/docs/guides/first-module-bundle",className:"docs-footer-link",children:[e("h3",{className:"font-semibold text-lg",children:"Build a first module bundle"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"Follow the route-to-plan-to-render path with one practical host example."})]})]})]}),t("section",{className:"editorial-panel space-y-5",children:[t("div",{className:"space-y-2",children:[e("h2",{className:"font-serif text-3xl tracking-[-0.03em]",children:"Follow the architecture by responsibility"}),e("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."})]}),t("div",{className:"grid gap-4 md:grid-cols-2",children:[t(a,{href:"/docs/architecture/app-config",className:"docs-footer-link",children:[e("h3",{className:"font-semibold text-lg",children:"App configuration"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"How blueprint-level and tenant-level config stay explicit and merge safely."})]}),t(a,{href:"/docs/architecture/integration-binding",className:"docs-footer-link",children:[e("h3",{className:"font-semibold text-lg",children:"Integration binding"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"How apps connect to tenant-owned integrations without leaking provider logic everywhere."})]}),t(a,{href:"/docs/architecture/knowledge-binding",className:"docs-footer-link",children:[e("h3",{className:"font-semibold text-lg",children:"Knowledge binding"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"How trusted knowledge enters the system and stays isolated by context and tenant."})]}),t(a,{href:"/docs/architecture/control-plane",className:"docs-footer-link",children:[e("h3",{className:"font-semibold text-lg",children:"Control plane runtime"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"How intent, policy, planning, and execution flow through the system runtime."})]})]})]})]})}export{l as ArchitectureOverviewPage};
+var l=Object.defineProperty;var d=(a)=>a;function s(a,n){this[a]=d.bind(null,n)}var c=(a,n)=>{for(var i in n)l(a,i,{get:n[i],enumerable:!0,configurable:!0,set:s.bind(n,i)})};var m=(a,n)=>()=>(a&&(n=a(a=0)),n);import o from"@contractspec/lib.ui-link";import{jsx as e,jsxs as t}from"react/jsx-runtime";var r=[{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 p(){return t("div",{className:"space-y-10",children:[t("div",{className:"space-y-3",children:[e("p",{className:"editorial-kicker",children:"Build"}),e("h1",{className:"font-serif text-4xl tracking-[-0.04em] md:text-5xl",children:"The architecture keeps contracts, runtime behavior, and operations in the same system."}),e("p",{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."})]}),e("div",{className:"grid gap-4 md:grid-cols-2",children:r.map((a)=>t("article",{className:"editorial-panel space-y-3",children:[e("h2",{className:"font-semibold text-xl",children:a.title}),e("p",{className:"text-muted-foreground text-sm leading-7",children:a.body})]},a.title))}),t("section",{className:"editorial-panel space-y-5",children:[t("div",{className:"space-y-2",children:[e("h2",{className:"font-serif text-3xl tracking-[-0.03em]",children:"UI composition belongs in the bundle runtime layer"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"When the system needs adaptive layouts, entity workbenches, assistant slots, and safe overlays, use module bundles as the layer between the contract model and the rendered surface."})]}),t("div",{className:"grid gap-4 md:grid-cols-2",children:[t(o,{href:"/docs/specs/module-bundles",className:"docs-footer-link",children:[e("h3",{className:"font-semibold text-lg",children:"Module bundles spec"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"See the typed bundle contract, resolved surface plan model, and bounded AI/runtime behavior."})]}),t(o,{href:"/docs/guides/first-module-bundle",className:"docs-footer-link",children:[e("h3",{className:"font-semibold text-lg",children:"Build a first module bundle"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"Follow the route-to-plan-to-render path with one practical host example."})]})]})]}),t("section",{className:"editorial-panel space-y-5",children:[t("div",{className:"space-y-2",children:[e("h2",{className:"font-serif text-3xl tracking-[-0.03em]",children:"Follow the architecture by responsibility"}),e("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."})]}),t("div",{className:"grid gap-4 md:grid-cols-2",children:[t(o,{href:"/docs/architecture/app-config",className:"docs-footer-link",children:[e("h3",{className:"font-semibold text-lg",children:"App configuration"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"How blueprint-level and tenant-level config stay explicit and merge safely."})]}),t(o,{href:"/docs/architecture/integration-binding",className:"docs-footer-link",children:[e("h3",{className:"font-semibold text-lg",children:"Integration binding"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"How apps connect to tenant-owned integrations without leaking provider logic everywhere."})]}),t(o,{href:"/docs/architecture/knowledge-binding",className:"docs-footer-link",children:[e("h3",{className:"font-semibold text-lg",children:"Knowledge binding"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"How trusted knowledge enters the system and stays isolated by context and tenant."})]}),t(o,{href:"/docs/architecture/control-plane",className:"docs-footer-link",children:[e("h3",{className:"font-semibold text-lg",children:"Control plane runtime"}),e("p",{className:"text-muted-foreground text-sm leading-7",children:"How intent, policy, planning, and execution flow through the system runtime."})]})]})]})]})}export{p as ArchitectureOverviewPage};