@contractspec/bundle.library 3.9.0 → 3.9.3

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

@@ -1,5 +1,5 @@
 // @bun
-import{CodeBlock as g}from"@contractspec/lib.design-system";import b from"@contractspec/lib.ui-link";import{ChevronRight as C}from"lucide-react";import{jsx as n,jsxs as r}from"react/jsx-runtime";function I(){return r("div",{className:"space-y-8",children:[r("div",{className:"space-y-4",children:[n("h1",{className:"font-bold text-4xl",children:"App Configuration"}),n("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."})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"AppBlueprintSpec"}),r("p",{className:"text-muted-foreground",children:["The ",n("strong",{children:"AppBlueprintSpec"})," is the global, versioned definition of your application. It contains no tenant-specific information and is stored in version control."]}),n(g,{language:"typescript",code:`type AppBlueprintSpec = {
+var A=Object.defineProperty;var S=(m)=>m;function P(m,u){this[m]=S.bind(null,u)}var V=(m,u)=>{for(var v in u)A(m,v,{get:u[v],enumerable:!0,configurable:!0,set:P.bind(u,v)})};var W=(m,u)=>()=>(m&&(u=m(m=0)),u);import{CodeBlock as h}from"@contractspec/lib.design-system";import w from"@contractspec/lib.ui-link";import{ChevronRight as _}from"lucide-react";import{jsx as n,jsxs as r}from"react/jsx-runtime";function T(){return r("div",{className:"space-y-8",children:[r("div",{className:"space-y-4",children:[n("h1",{className:"font-bold text-4xl",children:"App Configuration"}),n("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."})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"AppBlueprintSpec"}),r("p",{className:"text-muted-foreground",children:["The ",n("strong",{children:"AppBlueprintSpec"})," is the global, versioned definition of your application. It contains no tenant-specific information and is stored in version control."]}),n(h,{language:"typescript",code:`type AppBlueprintSpec = {
   id: string;
   version: string;
   name: string;
@@ -36,7 +36,7 @@ import{CodeBlock as g}from"@contractspec/lib.design-system";import b from"@contr
   
   // Schema evolution
   migrations: MigrationSpec[];
-};`})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"TenantAppConfig"}),r("p",{className:"text-muted-foreground",children:["The ",n("strong",{children:"TenantAppConfig"})," is the per-tenant, per-environment configuration that customizes how a specific tenant uses the app."]}),n(g,{language:"typescript",code:`type TenantAppConfig = {
+};`})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"TenantAppConfig"}),r("p",{className:"text-muted-foreground",children:["The ",n("strong",{children:"TenantAppConfig"})," is the per-tenant, per-environment configuration that customizes how a specific tenant uses the app."]}),n(h,{language:"typescript",code:`type TenantAppConfig = {
   tenantId: string;
   blueprintId: string;
   blueprintVersion: string;
@@ -67,7 +67,7 @@ import{CodeBlock as g}from"@contractspec/lib.design-system";import b from"@contr
   metadata: Record<string, unknown>;
   createdAt: string;
   updatedAt: string;
-};`})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"AppIntegrationBinding"}),n("p",{className:"text-muted-foreground",children:"Defines how a tenant connects specific integration instances to satisfy capabilities and workflows."}),n(g,{language:"typescript",code:`type AppIntegrationBinding = {
+};`})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"AppIntegrationBinding"}),n("p",{className:"text-muted-foreground",children:"Defines how a tenant connects specific integration instances to satisfy capabilities and workflows."}),n(h,{language:"typescript",code:`type AppIntegrationBinding = {
   slotId: string;          // References AppIntegrationSlot.slotId
   connectionId: string;    // References IntegrationConnection.meta.id
   scope?: {
@@ -87,7 +87,7 @@ import{CodeBlock as g}from"@contractspec/lib.design-system";import b from"@contr
     operations: ["payments.stripe.*"]
   },
   priority: 1
-}`})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"AppKnowledgeBinding"}),n("p",{className:"text-muted-foreground",children:"Defines which knowledge spaces a tenant's app can access and how."}),n(g,{language:"typescript",code:`type AppKnowledgeBinding = {
+}`})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"AppKnowledgeBinding"}),n("p",{className:"text-muted-foreground",children:"Defines which knowledge spaces a tenant's app can access and how."}),n(h,{language:"typescript",code:`type AppKnowledgeBinding = {
   spaceId: string;
   enabled: boolean;
   
@@ -117,7 +117,7 @@ import{CodeBlock as g}from"@contractspec/lib.design-system";import b from"@contr
   },
   allowedCategories: ["canonical", "operational"],
   sources: ["src_notion_product_docs", "src_database_schema"]
-}`})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"ResolvedAppConfig"}),r("p",{className:"text-muted-foreground",children:["The ",n("strong",{children:"ResolvedAppConfig"})," is the runtime result of merging AppBlueprintSpec with TenantAppConfig. It's computed on-demand and never persisted."]}),n(g,{language:"typescript",code:`type ResolvedAppConfig = {
+}`})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"ResolvedAppConfig"}),r("p",{className:"text-muted-foreground",children:["The ",n("strong",{children:"ResolvedAppConfig"})," is the runtime result of merging AppBlueprintSpec with TenantAppConfig. It's computed on-demand and never persisted."]}),n(h,{language:"typescript",code:`type ResolvedAppConfig = {
   appId: string;
   tenantId: string;
   blueprintName: string;
@@ -144,7 +144,7 @@ import{CodeBlock as g}from"@contractspec/lib.design-system";import b from"@contr
   knowledge: ResolvedKnowledge[];       // [{ binding, space, sources }]
   branding: ResolvedBranding;           // { appName, assets, colors, domain }
   notes?: string;
-};`})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"Configuration flow"}),n("p",{className:"text-muted-foreground",children:"Here's how configuration flows from definition to runtime:"}),r("ol",{className:"list-inside list-decimal space-y-3 text-muted-foreground",children:[r("li",{children:[n("strong",{children:"Development"})," - Define AppBlueprintSpec with required integrations and knowledge spaces"]}),r("li",{children:[n("strong",{children:"Deployment"})," - Deploy blueprint to environment (sandbox, staging, production)"]}),r("li",{children:[n("strong",{children:"Tenant Setup"})," - Create TenantAppConfig with specific integration connections and knowledge sources"]}),r("li",{children:[n("strong",{children:"Runtime"})," - Resolve configuration on-demand when tenant accesses the app"]}),r("li",{children:[n("strong",{children:"Execution"})," - Use ResolvedAppConfig to execute capabilities, workflows, and enforce policies"]})]})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"Best practices"}),r("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[n("li",{children:"Keep AppBlueprintSpec environment-agnostic - no secrets or tenant-specific data"}),n("li",{children:"Use TenantAppConfig for all tenant-specific settings and connections"}),n("li",{children:"Cache ResolvedAppConfig per request to avoid repeated resolution"}),n("li",{children:"Version blueprints carefully - migrations affect all tenants"}),n("li",{children:"Test blueprint changes in sandbox before promoting to production"})]})]}),r("div",{className:"flex items-center gap-4 pt-4",children:[n(b,{href:"/docs/architecture",className:"btn-ghost",children:"Back to Architecture"}),r(b,{href:"/docs/architecture/integration-binding",className:"btn-primary",children:["Integration Binding ",n(C,{size:16})]})]})]})}import{CodeBlock as v}from"@contractspec/lib.design-system";import h from"@contractspec/lib.ui-link";import{ChevronRight as A}from"lucide-react";import{jsx as o,jsxs as p}from"react/jsx-runtime";function S(){return p("div",{className:"space-y-8",children:[p("div",{className:"space-y-4",children:[o("h1",{className:"font-bold text-4xl",children:"Control Plane Runtime"}),o("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."})]}),p("div",{className:"space-y-4",children:[o("h2",{className:"font-bold text-2xl",children:"Canonical execution loop"}),p("ol",{className:"list-inside list-decimal space-y-2 text-muted-foreground",children:[o("li",{children:"Accept intent and create execution identity + trace context."}),o("li",{children:"Compile intent into a typed, deterministic plan DAG."}),o("li",{children:"Verify plan against policy and risk rules."}),o("li",{children:"Route into autonomous or assist mode based on verdict."}),o("li",{children:"Execute steps with idempotent keys and explicit stage events."}),o("li",{children:"Persist outcomes for replay, audits, and operator visibility."})]})]}),p("div",{className:"space-y-4",children:[o("h2",{className:"font-bold text-2xl",children:"Contract surfaces (v1 baseline)"}),p("p",{className:"text-muted-foreground",children:["The runtime is contract-first. Commands, queries, events, and capabilities are explicit and versioned under",o("code",{children:" @contractspec/lib.contracts-spec"}),"."]}),o(v,{language:"text",code:`Commands
+};`})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"Configuration flow"}),n("p",{className:"text-muted-foreground",children:"Here's how configuration flows from definition to runtime:"}),r("ol",{className:"list-inside list-decimal space-y-3 text-muted-foreground",children:[r("li",{children:[n("strong",{children:"Development"})," - Define AppBlueprintSpec with required integrations and knowledge spaces"]}),r("li",{children:[n("strong",{children:"Deployment"})," - Deploy blueprint to environment (sandbox, staging, production)"]}),r("li",{children:[n("strong",{children:"Tenant Setup"})," - Create TenantAppConfig with specific integration connections and knowledge sources"]}),r("li",{children:[n("strong",{children:"Runtime"})," - Resolve configuration on-demand when tenant accesses the app"]}),r("li",{children:[n("strong",{children:"Execution"})," - Use ResolvedAppConfig to execute capabilities, workflows, and enforce policies"]})]})]}),r("div",{className:"space-y-4",children:[n("h2",{className:"font-bold text-2xl",children:"Best practices"}),r("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[n("li",{children:"Keep AppBlueprintSpec environment-agnostic - no secrets or tenant-specific data"}),n("li",{children:"Use TenantAppConfig for all tenant-specific settings and connections"}),n("li",{children:"Cache ResolvedAppConfig per request to avoid repeated resolution"}),n("li",{children:"Version blueprints carefully - migrations affect all tenants"}),n("li",{children:"Test blueprint changes in sandbox before promoting to production"})]})]}),r("div",{className:"flex items-center gap-4 pt-4",children:[n(w,{href:"/docs/architecture",className:"btn-ghost",children:"Back to Architecture"}),r(w,{href:"/docs/architecture/integration-binding",className:"btn-primary",children:["Integration Binding ",n(_,{size:16})]})]})]})}import{CodeBlock as N}from"@contractspec/lib.design-system";import b from"@contractspec/lib.ui-link";import{ChevronRight as B}from"lucide-react";import{jsx as o,jsxs as p}from"react/jsx-runtime";function R(){return p("div",{className:"space-y-8",children:[p("div",{className:"space-y-4",children:[o("h1",{className:"font-bold text-4xl",children:"Control Plane Runtime"}),o("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."})]}),p("div",{className:"space-y-4",children:[o("h2",{className:"font-bold text-2xl",children:"Canonical execution loop"}),p("ol",{className:"list-inside list-decimal space-y-2 text-muted-foreground",children:[o("li",{children:"Accept intent and create execution identity + trace context."}),o("li",{children:"Compile intent into a typed, deterministic plan DAG."}),o("li",{children:"Verify plan against policy and risk rules."}),o("li",{children:"Route into autonomous or assist mode based on verdict."}),o("li",{children:"Execute steps with idempotent keys and explicit stage events."}),o("li",{children:"Persist outcomes for replay, audits, and operator visibility."})]})]}),p("div",{className:"space-y-4",children:[o("h2",{className:"font-bold text-2xl",children:"Contract surfaces (v1 baseline)"}),p("p",{className:"text-muted-foreground",children:["The runtime is contract-first. Commands, queries, events, and capabilities are explicit and versioned under",o("code",{children:" @contractspec/lib.contracts-spec"}),"."]}),o(N,{language:"text",code:`Commands
 - controlPlane.intent.submit
 - controlPlane.plan.compile
 - controlPlane.plan.verify
@@ -180,7 +180,7 @@ Capabilities
 - control-plane.approval
 - control-plane.audit
 - control-plane.skill-registry
-- control-plane.channel-runtime`})]}),p("div",{className:"space-y-4",children:[o("h2",{className:"font-bold text-2xl",children:"Policy and safety posture"}),p("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[o("li",{children:"No side-effect action executes unless it comes from a compiled plan."}),o("li",{children:"High-risk actions are blocked from autonomous mode in v1."}),o("li",{children:"Approval commands provide explicit human-in-the-loop transitions."}),o("li",{children:"Skill installation is modeled as governance-controlled operations."}),o("li",{children:"Trace queries expose policy rationale and step outcomes for replay."})]})]}),p("section",{className:"editorial-panel space-y-4",children:[o("h2",{className:"font-serif text-3xl tracking-[-0.03em]",children:"Apply the runtime locally with Connect"}),o("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."}),p("div",{className:"flex flex-wrap gap-3",children:[o(h,{href:"/docs/specs/connect",className:"btn-primary",children:"Connect spec"}),o(h,{href:"/docs/guides/connect-in-a-repo",className:"btn-ghost",children:"Use Connect in a repo"})]})]}),p("div",{className:"space-y-4",children:[o("h2",{className:"font-bold text-2xl",children:"Implementation map"}),o(v,{language:"text",code:`packages/libs/contracts-spec/src/control-plane/
+- control-plane.channel-runtime`})]}),p("div",{className:"space-y-4",children:[o("h2",{className:"font-bold text-2xl",children:"Policy and safety posture"}),p("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[o("li",{children:"No side-effect action executes unless it comes from a compiled plan."}),o("li",{children:"High-risk actions are blocked from autonomous mode in v1."}),o("li",{children:"Approval commands provide explicit human-in-the-loop transitions."}),o("li",{children:"Skill installation is modeled as governance-controlled operations."}),o("li",{children:"Trace queries expose policy rationale and step outcomes for replay."})]})]}),p("section",{className:"editorial-panel space-y-4",children:[o("h2",{className:"font-serif text-3xl tracking-[-0.03em]",children:"Apply the runtime locally with Connect"}),o("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."}),p("div",{className:"flex flex-wrap gap-3",children:[o(b,{href:"/docs/specs/connect",className:"btn-primary",children:"Connect spec"}),o(b,{href:"/docs/guides/connect-in-a-repo",className:"btn-ghost",children:"Use Connect in a repo"})]})]}),p("div",{className:"space-y-4",children:[o("h2",{className:"font-bold text-2xl",children:"Implementation map"}),o(N,{language:"text",code:`packages/libs/contracts-spec/src/control-plane/
   commands/
   queries/
   events/
@@ -189,7 +189,7 @@ Capabilities
   contracts.test.ts
 
 packages/apps/web-landing/src/app/docs/architecture/control-plane/page.tsx
-implementation_plan_controle_plane.md`})]}),p("div",{className:"space-y-4",children:[o("h2",{className:"font-bold text-2xl",children:"What comes next"}),o("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."})]}),p("div",{className:"flex items-center gap-4 pt-4",children:[o(h,{href:"/docs/architecture/integration-binding",className:"btn-ghost",children:"Previous: Integration Binding"}),p(h,{href:"/docs/safety/auditing",className:"btn-primary",children:["Audit Logs ",o(A,{size:16})]})]})]})}import{CodeBlock as m}from"@contractspec/lib.design-system";import w from"@contractspec/lib.ui-link";import{ChevronRight as P}from"lucide-react";import{jsx as t,jsxs as s}from"react/jsx-runtime";function _(){return s("div",{className:"space-y-8",children:[s("div",{className:"space-y-4",children:[t("h1",{className:"font-bold text-4xl",children:"Integration Binding"}),t("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."})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"How it works"}),t("p",{className:"text-muted-foreground",children:"Integration binding follows a three-layer model:"}),s("ol",{className:"list-inside list-decimal space-y-3 text-muted-foreground",children:[s("li",{children:[t("strong",{children:"IntegrationSpec"})," (global) - Defines what an integration provides"]}),s("li",{children:[t("strong",{children:"IntegrationConnection"})," (per-tenant) - A tenant's configured connection"]}),s("li",{children:[t("strong",{children:"AppIntegrationBinding"})," (per-app) - Maps named slots to concrete tenant connections"]})]})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Example: Payment processing"}),t("p",{className:"text-muted-foreground",children:"Let's walk through a complete example of binding Stripe for payments."}),s("div",{className:"space-y-3",children:[t("h3",{className:"font-semibold text-lg",children:"Step 1: Blueprint declares requirement"}),t(m,{language:"typescript",code:`// AppBlueprintSpec
+implementation_plan_controle_plane.md`})]}),p("div",{className:"space-y-4",children:[o("h2",{className:"font-bold text-2xl",children:"What comes next"}),o("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."})]}),p("div",{className:"flex items-center gap-4 pt-4",children:[o(b,{href:"/docs/architecture/integration-binding",className:"btn-ghost",children:"Previous: Integration Binding"}),p(b,{href:"/docs/safety/auditing",className:"btn-primary",children:["Audit Logs ",o(B,{size:16})]})]})]})}import{CodeBlock as g}from"@contractspec/lib.design-system";import k from"@contractspec/lib.ui-link";import{ChevronRight as q}from"lucide-react";import{jsx as t,jsxs as s}from"react/jsx-runtime";function L(){return s("div",{className:"space-y-8",children:[s("div",{className:"space-y-4",children:[t("h1",{className:"font-bold text-4xl",children:"Integration Binding"}),t("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."})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"How it works"}),t("p",{className:"text-muted-foreground",children:"Integration binding follows a three-layer model:"}),s("ol",{className:"list-inside list-decimal space-y-3 text-muted-foreground",children:[s("li",{children:[t("strong",{children:"IntegrationSpec"})," (global) - Defines what an integration provides"]}),s("li",{children:[t("strong",{children:"IntegrationConnection"})," (per-tenant) - A tenant's configured connection"]}),s("li",{children:[t("strong",{children:"AppIntegrationBinding"})," (per-app) - Maps named slots to concrete tenant connections"]})]})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Example: Payment processing"}),t("p",{className:"text-muted-foreground",children:"Let's walk through a complete example of binding Stripe for payments."}),s("div",{className:"space-y-3",children:[t("h3",{className:"font-semibold text-lg",children:"Step 1: Blueprint declares requirement"}),t(g,{language:"typescript",code:`// AppBlueprintSpec
 {
   meta: { name: "invoice-app", version: '1.0.0', appId: "invoice" },
   integrationSlots: [
@@ -213,7 +213,7 @@ implementation_plan_controle_plane.md`})]}),p("div",{className:"space-y-4",child
     assets: [{ type: "logo", url: "https://cdn.acme.dev/logo.png" }],
     colorTokens: { primary: "colors.brand.primary" }
   }
-}`})]}),s("div",{className:"space-y-3",children:[t("h3",{className:"font-semibold text-lg",children:"Step 2: Tenant creates connection"}),t(m,{language:"typescript",code:`// IntegrationConnection
+}`})]}),s("div",{className:"space-y-3",children:[t("h3",{className:"font-semibold text-lg",children:"Step 2: Tenant creates connection"}),t(g,{language:"typescript",code:`// IntegrationConnection
 {
   meta: {
     id: "conn_stripe_acme_prod",
@@ -233,7 +233,7 @@ implementation_plan_controle_plane.md`})]}),p("div",{className:"space-y-4",child
   },
   secretRef: "vault://integrations/acme/conn_stripe_acme_prod",
   status: "active"
-}`})]}),s("div",{className:"space-y-3",children:[t("h3",{className:"font-semibold text-lg",children:"Step 3: TenantAppConfig binds connection"}),t(m,{language:"typescript",code:`// TenantAppConfig
+}`})]}),s("div",{className:"space-y-3",children:[t("h3",{className:"font-semibold text-lg",children:"Step 3: TenantAppConfig binds connection"}),t(g,{language:"typescript",code:`// TenantAppConfig
 {
   meta: {
     tenantId: "acme-corp",
@@ -259,7 +259,7 @@ implementation_plan_controle_plane.md`})]}),p("div",{className:"space-y-4",child
     customDomain: "billing.acme.com",
     assets: [{ type: "logo", url: "https://assets.acme.com/logo.svg" }]
   }
-}`})]}),s("div",{className:"space-y-3",children:[t("h3",{className:"font-semibold text-lg",children:"Step 4: Runtime resolves and executes"}),t(m,{language:"typescript",code:`// ResolvedAppConfig (runtime)
+}`})]}),s("div",{className:"space-y-3",children:[t("h3",{className:"font-semibold text-lg",children:"Step 4: Runtime resolves and executes"}),t(g,{language:"typescript",code:`// ResolvedAppConfig (runtime)
 {
   integrations: {
     "payments.createPaymentIntent": {
@@ -276,7 +276,7 @@ const result = await executeCapability(
   { amount: 5000, currency: "usd" },
   resolvedConfig
 );
-// \u2192 Uses Stripe connection automatically`})]})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Multi-integration scenarios"}),t("p",{className:"text-muted-foreground",children:"A single app can use multiple integrations across different categories:"}),t(m,{language:"typescript",code:`integrations: [
+// \u2192 Uses Stripe connection automatically`})]})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Multi-integration scenarios"}),t("p",{className:"text-muted-foreground",children:"A single app can use multiple integrations across different categories:"}),t(g,{language:"typescript",code:`integrations: [
   {
     slotId: "payments.primary",
     connectionId: "conn_stripe_prod",
@@ -302,7 +302,7 @@ const result = await executeCapability(
       workflows: ["semantic-search", "rag-query"]
     }
   }
-]`})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Sandbox vs Production"}),t("p",{className:"text-muted-foreground",children:"Tenants typically maintain separate connections for sandbox and production environments:"}),t(m,{language:"typescript",code:`// Sandbox environment
+]`})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Sandbox vs Production"}),t("p",{className:"text-muted-foreground",children:"Tenants typically maintain separate connections for sandbox and production environments:"}),t(g,{language:"typescript",code:`// Sandbox environment
 {
   meta: { environment: "sandbox", status: "preview" },
   integrations: [
@@ -322,7 +322,7 @@ const result = await executeCapability(
       connectionId: "conn_stripe_acme_prod"
     }
   ]
-}`})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Security & validation"}),s("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[t("li",{children:"Integration connections are validated before binding - health checks ensure connectivity"}),t("li",{children:"Secrets are never stored in TenantAppConfig - only references to encrypted secrets"}),t("li",{children:"Policy Decision Point (PDP) enforces which workflows can use which integrations"}),t("li",{children:"All integration calls are audited with full request/response logging"}),t("li",{children:"Rate limiting and quotas are enforced per connection"})]})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Best practices"}),s("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[s("li",{children:["Use wildcard patterns sparingly in ",t("code",{children:"allowedWorkflows"})," - be explicit about access"]}),t("li",{children:"Always maintain separate sandbox and production connections"}),t("li",{children:"Monitor integration health checks and set up alerts for failures"}),t("li",{children:"Document the purpose of each integration binding for your team"}),t("li",{children:"Test integration changes in sandbox before promoting to production"})]})]}),s("div",{className:"flex items-center gap-4 pt-4",children:[t(w,{href:"/docs/architecture/app-config",className:"btn-ghost",children:"Previous: App Configuration"}),s(w,{href:"/docs/architecture/knowledge-binding",className:"btn-primary",children:["Knowledge Binding ",t(P,{size:16})]})]})]})}import{CodeBlock as f}from"@contractspec/lib.design-system";import N from"@contractspec/lib.ui-link";import{ChevronRight as T}from"lucide-react";import{jsx as e,jsxs as a}from"react/jsx-runtime";function B(){return a("div",{className:"space-y-8",children:[a("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."})]}),a("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:"}),a("ol",{className:"list-inside list-decimal space-y-3 text-muted-foreground",children:[a("li",{children:[e("strong",{children:"KnowledgeSpaceSpec"})," (global) - Defines a logical knowledge domain"]}),a("li",{children:[e("strong",{children:"KnowledgeSourceConfig"})," (per-tenant) - Tenant's data sources feeding spaces"]}),a("li",{children:[e("strong",{children:"AppKnowledgeBinding"})," (per-app) - Maps spaces to workflows/agents"]})]})]}),a("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."}),a("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 1: Blueprint declares knowledge needs"}),e(f,{language:"typescript",code:`// AppBlueprintSpec
+}`})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Security & validation"}),s("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[t("li",{children:"Integration connections are validated before binding - health checks ensure connectivity"}),t("li",{children:"Secrets are never stored in TenantAppConfig - only references to encrypted secrets"}),t("li",{children:"Policy Decision Point (PDP) enforces which workflows can use which integrations"}),t("li",{children:"All integration calls are audited with full request/response logging"}),t("li",{children:"Rate limiting and quotas are enforced per connection"})]})]}),s("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Best practices"}),s("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[s("li",{children:["Use wildcard patterns sparingly in ",t("code",{children:"allowedWorkflows"})," - be explicit about access"]}),t("li",{children:"Always maintain separate sandbox and production connections"}),t("li",{children:"Monitor integration health checks and set up alerts for failures"}),t("li",{children:"Document the purpose of each integration binding for your team"}),t("li",{children:"Test integration changes in sandbox before promoting to production"})]})]}),s("div",{className:"flex items-center gap-4 pt-4",children:[t(k,{href:"/docs/architecture/app-config",className:"btn-ghost",children:"Previous: App Configuration"}),s(k,{href:"/docs/architecture/knowledge-binding",className:"btn-primary",children:["Knowledge Binding ",t(q,{size:16})]})]})]})}import{CodeBlock as y}from"@contractspec/lib.design-system";import C from"@contractspec/lib.ui-link";import{ChevronRight as K}from"lucide-react";import{jsx as e,jsxs as a}from"react/jsx-runtime";function D(){return a("div",{className:"space-y-8",children:[a("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."})]}),a("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:"}),a("ol",{className:"list-inside list-decimal space-y-3 text-muted-foreground",children:[a("li",{children:[e("strong",{children:"KnowledgeSpaceSpec"})," (global) - Defines a logical knowledge domain"]}),a("li",{children:[e("strong",{children:"KnowledgeSourceConfig"})," (per-tenant) - Tenant's data sources feeding spaces"]}),a("li",{children:[e("strong",{children:"AppKnowledgeBinding"})," (per-app) - Maps spaces to workflows/agents"]})]})]}),a("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."}),a("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 1: Blueprint declares knowledge needs"}),e(y,{language:"typescript",code:`// AppBlueprintSpec
 {
   id: "support-app",
   version: "1.0.0",
@@ -346,7 +346,7 @@ const result = await executeCapability(
       purpose: "Third-party integration documentation"
     }
   ]
-}`})]}),a("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 2: Tenant configures sources"}),e(f,{language:"typescript",code:`// KnowledgeSourceConfig (per-tenant)
+}`})]}),a("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 2: Tenant configures sources"}),e(y,{language:"typescript",code:`// KnowledgeSourceConfig (per-tenant)
 [
   {
     id: "src_notion_product_docs",
@@ -375,7 +375,7 @@ const result = await executeCapability(
     syncPolicy: { interval: "24h" },
     lastSyncedAt: "2025-01-15T00:00:00Z"
   }
-]`})]}),a("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 3: TenantAppConfig binds spaces"}),e(f,{language:"typescript",code:`// TenantAppConfig
+]`})]}),a("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 3: TenantAppConfig binds spaces"}),e(y,{language:"typescript",code:`// TenantAppConfig
 {
   tenantId: "acme-corp",
   blueprintId: "support-app",
@@ -411,7 +411,7 @@ const result = await executeCapability(
       sources: ["src_stripe_docs"]
     }
   ]
-}`})]}),a("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 4: Workflow uses knowledge"}),e(f,{language:"yaml",code:`// WorkflowSpec
+}`})]}),a("div",{className:"space-y-3",children:[e("h3",{className:"font-semibold text-lg",children:"Step 4: Workflow uses knowledge"}),e(y,{language:"yaml",code:`// WorkflowSpec
 workflowId: answer-question
 version: '1.0.0'.0.0
 
@@ -453,7 +453,7 @@ steps:
             \${steps.search-canonical.output.results}
             
             Support history:
-            \${steps.search-support-history.output.results}`})]})]}),a("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:a("table",{className:"w-full text-left text-sm",children:[e("thead",{className:"bg-card/50",children:a("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"})]})}),a("tbody",{className:"divide-y divide-border/50",children:[a("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"})]}),a("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"})]}),a("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"})]}),a("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"})]})]})]})})]}),a("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(f,{language:"typescript",code:`knowledgeBindings: [
+            \${steps.search-support-history.output.results}`})]})]}),a("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:a("table",{className:"w-full text-left text-sm",children:[e("thead",{className:"bg-card/50",children:a("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"})]})}),a("tbody",{className:"divide-y divide-border/50",children:[a("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"})]}),a("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"})]}),a("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"})]}),a("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"})]})]})]})})]}),a("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(y,{language:"typescript",code:`knowledgeBindings: [
   {
     spaceId: "product-canon",
     enabled: true,
@@ -481,11 +481,11 @@ steps:
     allowedCategories: ["operational"],
     sources: ["src_crm_data", "src_past_invoices"]
   }
-]`})]}),a("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Security & validation"}),a("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"})]})]}),a("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Best practices"}),a("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"}),a("li",{children:["Use explicit ",e("code",{children:"allowedConsumers"})," - avoid wildcard access"]})]})]}),a("div",{className:"flex items-center gap-4 pt-4",children:[e(N,{href:"/docs/architecture/integration-binding",className:"btn-ghost",children:"Previous: Integration Binding"}),a(N,{href:"/docs/knowledge",className:"btn-primary",children:["Knowledge & Context ",e(T,{size:16})]})]})]})}import{CodeBlock as R}from"@contractspec/lib.design-system";import k from"@contractspec/lib.ui-link";import{ChevronRight as q}from"lucide-react";import{jsx as c,jsxs as l}from"react/jsx-runtime";function L(){return l("div",{className:"space-y-8",children:[l("div",{className:"space-y-4",children:[c("h1",{className:"font-bold text-4xl",children:"Multi-Tenancy"}),c("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."})]}),l("div",{className:"space-y-4",children:[c("h2",{className:"font-bold text-2xl",children:"Core Concepts"}),l("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[l("li",{children:[c("strong",{children:"Tenant"}),": An organization or customer that uses your app. Each tenant has a unique ",c("code",{children:"tenantId"}),"."]}),l("li",{children:[c("strong",{children:"Tenant Isolation"}),": Data and configuration for one tenant is never accessible to another tenant unless explicitly shared."]}),l("li",{children:[c("strong",{children:"Tenant Context"}),": Every request and operation runs within the context of a specific tenant."]})]})]}),l("div",{className:"space-y-4",children:[c("h2",{className:"font-bold text-2xl",children:"Tenant Resolution"}),c("p",{className:"text-muted-foreground",children:"The runtime automatically resolves the tenant context for every request based on:"}),l("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[l("li",{children:["Subdomain (e.g., ",c("code",{children:"acme.app.com"}),")"]}),l("li",{children:["Custom Domain (e.g., ",c("code",{children:"portal.acme.com"}),")"]}),l("li",{children:["Header (e.g., ",c("code",{children:"x-tenant-id: acme-corp"}),")"]}),c("li",{children:"Authentication Token (embedded tenant claim)"})]})]}),l("div",{className:"space-y-4",children:[c("h2",{className:"font-bold text-2xl",children:"Configuration Isolation"}),l("p",{className:"text-muted-foreground",children:["Each tenant has its own ",c("code",{children:"TenantAppConfig"})," which defines:"]}),c(R,{language:"typescript",code:`type TenantAppConfig = {
+]`})]}),a("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Security & validation"}),a("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"})]})]}),a("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Best practices"}),a("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"}),a("li",{children:["Use explicit ",e("code",{children:"allowedConsumers"})," - avoid wildcard access"]})]})]}),a("div",{className:"flex items-center gap-4 pt-4",children:[e(C,{href:"/docs/architecture/integration-binding",className:"btn-ghost",children:"Previous: Integration Binding"}),a(C,{href:"/docs/knowledge",className:"btn-primary",children:["Knowledge & Context ",e(K,{size:16})]})]})]})}import{CodeBlock as E}from"@contractspec/lib.design-system";import I from"@contractspec/lib.ui-link";import{ChevronRight as M}from"lucide-react";import{jsx as c,jsxs as l}from"react/jsx-runtime";function U(){return l("div",{className:"space-y-8",children:[l("div",{className:"space-y-4",children:[c("h1",{className:"font-bold text-4xl",children:"Multi-Tenancy"}),c("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."})]}),l("div",{className:"space-y-4",children:[c("h2",{className:"font-bold text-2xl",children:"Core Concepts"}),l("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[l("li",{children:[c("strong",{children:"Tenant"}),": An organization or customer that uses your app. Each tenant has a unique ",c("code",{children:"tenantId"}),"."]}),l("li",{children:[c("strong",{children:"Tenant Isolation"}),": Data and configuration for one tenant is never accessible to another tenant unless explicitly shared."]}),l("li",{children:[c("strong",{children:"Tenant Context"}),": Every request and operation runs within the context of a specific tenant."]})]})]}),l("div",{className:"space-y-4",children:[c("h2",{className:"font-bold text-2xl",children:"Tenant Resolution"}),c("p",{className:"text-muted-foreground",children:"The runtime automatically resolves the tenant context for every request based on:"}),l("ul",{className:"list-inside list-disc space-y-2 text-muted-foreground",children:[l("li",{children:["Subdomain (e.g., ",c("code",{children:"acme.app.com"}),")"]}),l("li",{children:["Custom Domain (e.g., ",c("code",{children:"portal.acme.com"}),")"]}),l("li",{children:["Header (e.g., ",c("code",{children:"x-tenant-id: acme-corp"}),")"]}),c("li",{children:"Authentication Token (embedded tenant claim)"})]})]}),l("div",{className:"space-y-4",children:[c("h2",{className:"font-bold text-2xl",children:"Configuration Isolation"}),l("p",{className:"text-muted-foreground",children:["Each tenant has its own ",c("code",{children:"TenantAppConfig"})," which defines:"]}),c(E,{language:"typescript",code:`type TenantAppConfig = {
   tenantId: string;
   blueprintId: string;
   // ...
   integrationBindings: AppIntegrationBinding[];
   knowledgeBindings: AppKnowledgeBinding[];
   featureFlags: Record<string, boolean>;
-};`}),c("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."})]}),l("div",{className:"flex items-center gap-4 pt-4",children:[c(k,{href:"/docs/architecture",className:"btn-ghost",children:"Back to Architecture"}),l(k,{href:"/docs/libraries/multi-tenancy",className:"btn-primary",children:["Multi-Tenancy Library ",c(q,{size:16})]})]})]})}import u from"@contractspec/lib.ui-link";import{jsx as i,jsxs as d}from"react/jsx-runtime";var K=[{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 D(){return d("div",{className:"space-y-10",children:[d("div",{className:"space-y-3",children:[i("p",{className:"editorial-kicker",children:"Build"}),i("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."}),i("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."})]}),i("div",{className:"grid gap-4 md:grid-cols-2",children:K.map((y)=>d("article",{className:"editorial-panel space-y-3",children:[i("h2",{className:"font-semibold text-xl",children:y.title}),i("p",{className:"text-muted-foreground text-sm leading-7",children:y.body})]},y.title))}),d("section",{className:"editorial-panel space-y-5",children:[d("div",{className:"space-y-2",children:[i("h2",{className:"font-serif text-3xl tracking-[-0.03em]",children:"UI composition belongs in the bundle runtime layer"}),i("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."})]}),d("div",{className:"grid gap-4 md:grid-cols-2",children:[d(u,{href:"/docs/specs/module-bundles",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"Module bundles spec"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"See the typed bundle contract, resolved surface plan model, and bounded AI/runtime behavior."})]}),d(u,{href:"/docs/guides/first-module-bundle",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"Build a first module bundle"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"Follow the route-to-plan-to-render path with one practical host example."})]})]})]}),d("section",{className:"editorial-panel space-y-5",children:[d("div",{className:"space-y-2",children:[i("h2",{className:"font-serif text-3xl tracking-[-0.03em]",children:"Follow the architecture by responsibility"}),i("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."})]}),d("div",{className:"grid gap-4 md:grid-cols-2",children:[d(u,{href:"/docs/architecture/app-config",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"App configuration"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"How blueprint-level and tenant-level config stay explicit and merge safely."})]}),d(u,{href:"/docs/architecture/integration-binding",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"Integration binding"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"How apps connect to tenant-owned integrations without leaking provider logic everywhere."})]}),d(u,{href:"/docs/architecture/knowledge-binding",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"Knowledge binding"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"How trusted knowledge enters the system and stays isolated by context and tenant."})]}),d(u,{href:"/docs/architecture/control-plane",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"Control plane runtime"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"How intent, policy, planning, and execution flow through the system runtime."})]})]})]})]})}export{D as ArchitectureOverviewPage,L as ArchitectureMultiTenancyPage,B as ArchitectureKnowledgeBindingPage,_ as ArchitectureIntegrationBindingPage,S as ArchitectureControlPlanePage,I as ArchitectureAppConfigPage};
+};`}),c("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."})]}),l("div",{className:"flex items-center gap-4 pt-4",children:[c(I,{href:"/docs/architecture",className:"btn-ghost",children:"Back to Architecture"}),l(I,{href:"/docs/libraries/multi-tenancy",className:"btn-primary",children:["Multi-Tenancy Library ",c(M,{size:16})]})]})]})}import f from"@contractspec/lib.ui-link";import{jsx as i,jsxs as d}from"react/jsx-runtime";var z=[{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 H(){return d("div",{className:"space-y-10",children:[d("div",{className:"space-y-3",children:[i("p",{className:"editorial-kicker",children:"Build"}),i("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."}),i("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."})]}),i("div",{className:"grid gap-4 md:grid-cols-2",children:z.map((m)=>d("article",{className:"editorial-panel space-y-3",children:[i("h2",{className:"font-semibold text-xl",children:m.title}),i("p",{className:"text-muted-foreground text-sm leading-7",children:m.body})]},m.title))}),d("section",{className:"editorial-panel space-y-5",children:[d("div",{className:"space-y-2",children:[i("h2",{className:"font-serif text-3xl tracking-[-0.03em]",children:"UI composition belongs in the bundle runtime layer"}),i("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."})]}),d("div",{className:"grid gap-4 md:grid-cols-2",children:[d(f,{href:"/docs/specs/module-bundles",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"Module bundles spec"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"See the typed bundle contract, resolved surface plan model, and bounded AI/runtime behavior."})]}),d(f,{href:"/docs/guides/first-module-bundle",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"Build a first module bundle"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"Follow the route-to-plan-to-render path with one practical host example."})]})]})]}),d("section",{className:"editorial-panel space-y-5",children:[d("div",{className:"space-y-2",children:[i("h2",{className:"font-serif text-3xl tracking-[-0.03em]",children:"Follow the architecture by responsibility"}),i("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."})]}),d("div",{className:"grid gap-4 md:grid-cols-2",children:[d(f,{href:"/docs/architecture/app-config",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"App configuration"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"How blueprint-level and tenant-level config stay explicit and merge safely."})]}),d(f,{href:"/docs/architecture/integration-binding",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"Integration binding"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"How apps connect to tenant-owned integrations without leaking provider logic everywhere."})]}),d(f,{href:"/docs/architecture/knowledge-binding",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"Knowledge binding"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"How trusted knowledge enters the system and stays isolated by context and tenant."})]}),d(f,{href:"/docs/architecture/control-plane",className:"docs-footer-link",children:[i("h3",{className:"font-semibold text-lg",children:"Control plane runtime"}),i("p",{className:"text-muted-foreground text-sm leading-7",children:"How intent, policy, planning, and execution flow through the system runtime."})]})]})]})]})}export{H as ArchitectureOverviewPage,U as ArchitectureMultiTenancyPage,D as ArchitectureKnowledgeBindingPage,L as ArchitectureIntegrationBindingPage,R as ArchitectureControlPlanePage,T as ArchitectureAppConfigPage};

package/dist/components/docs/comparison/ComparisonAutomationPlatformsPage.js

@@ -1,2 +1,2 @@
 // @bun
-import{jsx as t,jsxs as a}from"react/jsx-runtime";function e(){return a("div",{className:"space-y-8",children:[a("div",{className:"space-y-4",children:[t("h1",{className:"font-bold text-4xl",children:"Automation platforms"}),t("p",{className:"text-muted-foreground",children:"Automation platforms connect apps and automate tasks through triggers and actions. They serve operations and non-technical users well but stop short of generating full applications or enforcing fine-grained policies."})]}),a("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Feature comparison"}),t("div",{className:"overflow-x-auto rounded-lg border border-border/50",children:a("table",{className:"w-full text-left text-sm",children:[t("thead",{className:"bg-card/50",children:a("tr",{className:"border-border/50 border-b",children:[t("th",{className:"px-4 py-3 font-semibold",children:"Feature"}),t("th",{className:"px-4 py-3 font-semibold",children:"Zapier"}),t("th",{className:"px-4 py-3 font-semibold",children:"Make (Integromat)"}),t("th",{className:"px-4 py-3 font-semibold",children:"n8n"}),t("th",{className:"px-4 py-3 font-semibold",children:"Pipedream"})]})}),a("tbody",{className:"divide-y divide-border/50",children:[a("tr",{children:[t("td",{className:"px-4 py-3 align-top font-semibold",children:"Workflow model"}),t("td",{className:"px-4 py-3 align-top",children:"Zaps: trigger + one or more actions"}),t("td",{className:"px-4 py-3 align-top",children:"Real-time visual orchestration for AI agents and automations"}),t("td",{className:"px-4 py-3 align-top",children:"Node-based workflow builder with drag-and-drop and code; build multi-step AI agents"}),t("td",{className:"px-4 py-3 align-top",children:"Workflows connect any API; Pipedream Connect SDK adds integrations quickly"})]}),a("tr",{children:[t("td",{className:"px-4 py-3 align-top font-semibold",children:"Visual builder?"}),t("td",{className:"px-4 py-3 align-top",children:"Yes (simple; web-based)."}),t("td",{className:"px-4 py-3 align-top",children:"Yes; AI-assisted editor"}),t("td",{className:"px-4 py-3 align-top",children:"Yes; visual canvas."}),t("td",{className:"px-4 py-3 align-top",children:"Code-centric editor; no visual UI builder"})]}),a("tr",{children:[t("td",{className:"px-4 py-3 align-top font-semibold",children:"Self-host?"}),t("td",{className:"px-4 py-3 align-top",children:"No (cloud only)."}),t("td",{className:"px-4 py-3 align-top",children:"Cloud only."}),t("td",{className:"px-4 py-3 align-top",children:"Yes (Docker, self-host)"}),t("td",{className:"px-4 py-3 align-top",children:"Cloud only (hosted)."})]}),a("tr",{children:[t("td",{className:"px-4 py-3 align-top font-semibold",children:"Integrations & AI"}),t("td",{className:"px-4 py-3 align-top",children:"Connects almost 8 000 apps; limited AI features."}),t("td",{className:"px-4 py-3 align-top",children:"3 000+ pre-built apps; supports GenAI tools; GDPR/SOC2 and SSO"}),t("td",{className:"px-4 py-3 align-top",children:"Integrates LLMs; allows JS or Python code and library imports; chatbots with Slack/Teams"}),t("td",{className:"px-4 py-3 align-top",children:"MCP servers add 3 000+ APIs and 10 000+ tools to agents; AI agent builder prompts and deploys agents; SOC 2/ HIPAA/GDPR compliant"})]}),a("tr",{children:[t("td",{className:"px-4 py-3 align-top font-semibold",children:"Policy & UI generation"}),t("td",{className:"px-4 py-3 align-top",children:"No policy engine; does not generate user interfaces."}),t("td",{className:"px-4 py-3 align-top",children:"No policy engine; does not generate UIs beyond a workflow dashboard."}),t("td",{className:"px-4 py-3 align-top",children:"No policy engine; no UI builder"}),t("td",{className:"px-4 py-3 align-top",children:"No policy engine; does not generate UI."})]})]})]})})]}),a("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"Why ContractSpec differs"}),a("ul",{className:"space-y-2 text-muted-foreground",children:[a("li",{children:[t("strong",{children:"Full application generation"})," \u2013 ContractSpec compiles specs into back-end, events and user interfaces for both web and mobile."]}),a("li",{children:[t("strong",{children:"Policy enforcement"})," \u2013 A built-in policy engine governs PII access and mutations across the UI."]}),a("li",{children:[t("strong",{children:"Customisation via overlays"})," \u2013 Non-technical users can safely personalise layouts while respecting policies."]}),a("li",{children:[t("strong",{children:"Extensible capabilities"})," \u2013 Connect to external APIs and services via capability providers while maintaining type safety."]})]}),t("p",{className:"text-muted-foreground",children:"Automation tools simplify integrations and tasks; ContractSpec goes further by generating a complete, policy-safe application around your data and processes."})]})]})}export{e as ComparisonAutomationPlatformsPage};
+var l=Object.defineProperty;var i=(e)=>e;function s(e,o){this[e]=i.bind(null,o)}var p=(e,o)=>{for(var n in o)l(e,n,{get:o[n],enumerable:!0,configurable:!0,set:s.bind(o,n)})};var d=(e,o)=>()=>(e&&(o=e(e=0)),o);import{jsx as t,jsxs as a}from"react/jsx-runtime";function c(){return a("div",{className:"space-y-8",children:[a("div",{className:"space-y-4",children:[t("h1",{className:"font-bold text-4xl",children:"Automation platforms"}),t("p",{className:"text-muted-foreground",children:"Automation platforms connect apps and automate tasks through triggers and actions. They serve operations and non-technical users well but stop short of generating full applications or enforcing fine-grained policies."})]}),a("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Feature comparison"}),t("div",{className:"overflow-x-auto rounded-lg border border-border/50",children:a("table",{className:"w-full text-left text-sm",children:[t("thead",{className:"bg-card/50",children:a("tr",{className:"border-border/50 border-b",children:[t("th",{className:"px-4 py-3 font-semibold",children:"Feature"}),t("th",{className:"px-4 py-3 font-semibold",children:"Zapier"}),t("th",{className:"px-4 py-3 font-semibold",children:"Make (Integromat)"}),t("th",{className:"px-4 py-3 font-semibold",children:"n8n"}),t("th",{className:"px-4 py-3 font-semibold",children:"Pipedream"})]})}),a("tbody",{className:"divide-y divide-border/50",children:[a("tr",{children:[t("td",{className:"px-4 py-3 align-top font-semibold",children:"Workflow model"}),t("td",{className:"px-4 py-3 align-top",children:"Zaps: trigger + one or more actions"}),t("td",{className:"px-4 py-3 align-top",children:"Real-time visual orchestration for AI agents and automations"}),t("td",{className:"px-4 py-3 align-top",children:"Node-based workflow builder with drag-and-drop and code; build multi-step AI agents"}),t("td",{className:"px-4 py-3 align-top",children:"Workflows connect any API; Pipedream Connect SDK adds integrations quickly"})]}),a("tr",{children:[t("td",{className:"px-4 py-3 align-top font-semibold",children:"Visual builder?"}),t("td",{className:"px-4 py-3 align-top",children:"Yes (simple; web-based)."}),t("td",{className:"px-4 py-3 align-top",children:"Yes; AI-assisted editor"}),t("td",{className:"px-4 py-3 align-top",children:"Yes; visual canvas."}),t("td",{className:"px-4 py-3 align-top",children:"Code-centric editor; no visual UI builder"})]}),a("tr",{children:[t("td",{className:"px-4 py-3 align-top font-semibold",children:"Self-host?"}),t("td",{className:"px-4 py-3 align-top",children:"No (cloud only)."}),t("td",{className:"px-4 py-3 align-top",children:"Cloud only."}),t("td",{className:"px-4 py-3 align-top",children:"Yes (Docker, self-host)"}),t("td",{className:"px-4 py-3 align-top",children:"Cloud only (hosted)."})]}),a("tr",{children:[t("td",{className:"px-4 py-3 align-top font-semibold",children:"Integrations & AI"}),t("td",{className:"px-4 py-3 align-top",children:"Connects almost 8 000 apps; limited AI features."}),t("td",{className:"px-4 py-3 align-top",children:"3 000+ pre-built apps; supports GenAI tools; GDPR/SOC2 and SSO"}),t("td",{className:"px-4 py-3 align-top",children:"Integrates LLMs; allows JS or Python code and library imports; chatbots with Slack/Teams"}),t("td",{className:"px-4 py-3 align-top",children:"MCP servers add 3 000+ APIs and 10 000+ tools to agents; AI agent builder prompts and deploys agents; SOC 2/ HIPAA/GDPR compliant"})]}),a("tr",{children:[t("td",{className:"px-4 py-3 align-top font-semibold",children:"Policy & UI generation"}),t("td",{className:"px-4 py-3 align-top",children:"No policy engine; does not generate user interfaces."}),t("td",{className:"px-4 py-3 align-top",children:"No policy engine; does not generate UIs beyond a workflow dashboard."}),t("td",{className:"px-4 py-3 align-top",children:"No policy engine; no UI builder"}),t("td",{className:"px-4 py-3 align-top",children:"No policy engine; does not generate UI."})]})]})]})})]}),a("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"Why ContractSpec differs"}),a("ul",{className:"space-y-2 text-muted-foreground",children:[a("li",{children:[t("strong",{children:"Full application generation"})," \u2013 ContractSpec compiles specs into back-end, events and user interfaces for both web and mobile."]}),a("li",{children:[t("strong",{children:"Policy enforcement"})," \u2013 A built-in policy engine governs PII access and mutations across the UI."]}),a("li",{children:[t("strong",{children:"Customisation via overlays"})," \u2013 Non-technical users can safely personalise layouts while respecting policies."]}),a("li",{children:[t("strong",{children:"Extensible capabilities"})," \u2013 Connect to external APIs and services via capability providers while maintaining type safety."]})]}),t("p",{className:"text-muted-foreground",children:"Automation tools simplify integrations and tasks; ContractSpec goes further by generating a complete, policy-safe application around your data and processes."})]})]})}export{c as ComparisonAutomationPlatformsPage};

package/dist/components/docs/comparison/ComparisonEnterprisePlatformsPage.js

@@ -1,2 +1,2 @@
 // @bun
-import v from"@contractspec/lib.ui-link";import{jsx as g,jsxs as q}from"react/jsx-runtime";function A(){return q("div",{className:"space-y-8",children:[q("div",{className:"space-y-4",children:[g("h1",{className:"font-bold text-4xl",children:"Enterprise orchestration platforms"}),g("p",{className:"text-muted-foreground",children:"Enterprise orchestration platforms manage mission-critical workloads and integrate deeply with ERP systems. They prioritise governance, reliability and compliance, but they do not provide spec-driven app generation or per-user customisation."})]}),q("div",{className:"space-y-4",children:[g("h2",{className:"font-bold text-2xl",children:"Redwood RunMyJobs"}),q("p",{className:"text-muted-foreground",children:[g(v,{href:"https://www.redwood.com/workload-automation/",className:"underline decoration-dotted underline-offset-4 hover:text-foreground",target:"_blank",rel:"noreferrer",children:"RunMyJobs by Redwood"})," ","is a cloud-native service orchestration and automation platform. Key attributes include:"]}),q("ul",{className:"space-y-2 text-muted-foreground",children:[q("li",{children:[g("strong",{children:"Self-service portal."})," Business users can run and customise workloads while IT ensures governance and compliance"]}),q("li",{children:[g("strong",{children:"Full-stack orchestration."})," Integrates with both SAP and non-SAP systems; Redwood is recognised as a Leader in Gartner\u2019s Magic Quadrant for service orchestration"]}),q("li",{children:[g("strong",{children:"Observability and AI insights."})," Dashboards and AI-enhanced analytics identify bottlenecks and forecast issues"]}),q("li",{children:[g("strong",{children:"Deep SAP integration."})," Supports SAP\u2019s latest technologies and orchestrates mission-critical business processes"]}),q("li",{children:[g("strong",{children:"Connectors & wizard."})," Provides pre-built connectors and a wizard to link on-prem and cloud systems"]})]})]}),q("div",{className:"space-y-4",children:[g("h3",{className:"font-semibold text-xl",children:"Comparison with ContractSpec"}),g("div",{className:"overflow-x-auto rounded-lg border border-border/50",children:q("table",{className:"w-full text-left text-sm",children:[g("thead",{className:"bg-card/50",children:q("tr",{className:"border-border/50 border-b",children:[g("th",{className:"px-4 py-3 font-semibold",children:"Aspect"}),g("th",{className:"px-4 py-3 font-semibold",children:"RunMyJobs"}),g("th",{className:"px-4 py-3 font-semibold",children:"ContractSpec"})]})}),q("tbody",{className:"divide-y divide-border/50",children:[q("tr",{children:[g("td",{className:"px-4 py-3 align-top",children:g("strong",{children:"Target user"})}),g("td",{className:"px-4 py-3 align-top",children:"Enterprise IT and operations teams automating SAP and mission-critical workflows."}),g("td",{className:"px-4 py-3 align-top",children:"Developers, product teams and SMBs wanting to generate policy-safe apps with customisable UIs."})]}),q("tr",{children:[g("td",{className:"px-4 py-3 align-top",children:g("strong",{children:"Workload focus"})}),g("td",{className:"px-4 py-3 align-top",children:"Service orchestration and job scheduling across ERP/legacy systems"}),g("td",{className:"px-4 py-3 align-top",children:"End-to-end application generation with back-end, UI and policies."})]}),q("tr",{children:[g("td",{className:"px-4 py-3 align-top",children:g("strong",{children:"User interface"})}),g("td",{className:"px-4 py-3 align-top",children:"Self-service portal to run/monitor jobs; no custom UI generation for new apps."}),g("td",{className:"px-4 py-3 align-top",children:"Generates React/React-Native UIs from specs; users can personalise layout via overlays."})]}),q("tr",{children:[g("td",{className:"px-4 py-3 align-top",children:g("strong",{children:"Open source"})}),g("td",{className:"px-4 py-3 align-top",children:"Proprietary SaaS; enterprise agreements."}),g("td",{className:"px-4 py-3 align-top",children:"Core compiler is proprietary; SDK and certain modules may be open-source; offers hosted and on-prem options."})]}),q("tr",{children:[g("td",{className:"px-4 py-3 align-top",children:g("strong",{children:"Policy & personalisation"})}),g("td",{className:"px-4 py-3 align-top",children:"IT controls governance; no per-user overlay concept."}),g("td",{className:"px-4 py-3 align-top",children:"Built-in policy engine and per-user overlays for safe personalisation."})]})]})]})}),g("p",{className:"text-muted-foreground",children:"Redwood RunMyJobs is designed for orchestrating enterprise workloads and SAP processes. ContractSpec targets a different problem: generating complete applications from typed specs and letting end users adapt them safely."})]})]})}export{A as ComparisonEnterprisePlatformsPage};
+var B=Object.defineProperty;var D=(v)=>v;function E(v,z){this[v]=D.bind(null,z)}var G=(v,z)=>{for(var A in z)B(v,A,{get:z[A],enumerable:!0,configurable:!0,set:E.bind(z,A)})};var H=(v,z)=>()=>(v&&(z=v(v=0)),z);import F from"@contractspec/lib.ui-link";import{jsx as g,jsxs as q}from"react/jsx-runtime";function N(){return q("div",{className:"space-y-8",children:[q("div",{className:"space-y-4",children:[g("h1",{className:"font-bold text-4xl",children:"Enterprise orchestration platforms"}),g("p",{className:"text-muted-foreground",children:"Enterprise orchestration platforms manage mission-critical workloads and integrate deeply with ERP systems. They prioritise governance, reliability and compliance, but they do not provide spec-driven app generation or per-user customisation."})]}),q("div",{className:"space-y-4",children:[g("h2",{className:"font-bold text-2xl",children:"Redwood RunMyJobs"}),q("p",{className:"text-muted-foreground",children:[g(F,{href:"https://www.redwood.com/workload-automation/",className:"underline decoration-dotted underline-offset-4 hover:text-foreground",target:"_blank",rel:"noreferrer",children:"RunMyJobs by Redwood"})," ","is a cloud-native service orchestration and automation platform. Key attributes include:"]}),q("ul",{className:"space-y-2 text-muted-foreground",children:[q("li",{children:[g("strong",{children:"Self-service portal."})," Business users can run and customise workloads while IT ensures governance and compliance"]}),q("li",{children:[g("strong",{children:"Full-stack orchestration."})," Integrates with both SAP and non-SAP systems; Redwood is recognised as a Leader in Gartner\u2019s Magic Quadrant for service orchestration"]}),q("li",{children:[g("strong",{children:"Observability and AI insights."})," Dashboards and AI-enhanced analytics identify bottlenecks and forecast issues"]}),q("li",{children:[g("strong",{children:"Deep SAP integration."})," Supports SAP\u2019s latest technologies and orchestrates mission-critical business processes"]}),q("li",{children:[g("strong",{children:"Connectors & wizard."})," Provides pre-built connectors and a wizard to link on-prem and cloud systems"]})]})]}),q("div",{className:"space-y-4",children:[g("h3",{className:"font-semibold text-xl",children:"Comparison with ContractSpec"}),g("div",{className:"overflow-x-auto rounded-lg border border-border/50",children:q("table",{className:"w-full text-left text-sm",children:[g("thead",{className:"bg-card/50",children:q("tr",{className:"border-border/50 border-b",children:[g("th",{className:"px-4 py-3 font-semibold",children:"Aspect"}),g("th",{className:"px-4 py-3 font-semibold",children:"RunMyJobs"}),g("th",{className:"px-4 py-3 font-semibold",children:"ContractSpec"})]})}),q("tbody",{className:"divide-y divide-border/50",children:[q("tr",{children:[g("td",{className:"px-4 py-3 align-top",children:g("strong",{children:"Target user"})}),g("td",{className:"px-4 py-3 align-top",children:"Enterprise IT and operations teams automating SAP and mission-critical workflows."}),g("td",{className:"px-4 py-3 align-top",children:"Developers, product teams and SMBs wanting to generate policy-safe apps with customisable UIs."})]}),q("tr",{children:[g("td",{className:"px-4 py-3 align-top",children:g("strong",{children:"Workload focus"})}),g("td",{className:"px-4 py-3 align-top",children:"Service orchestration and job scheduling across ERP/legacy systems"}),g("td",{className:"px-4 py-3 align-top",children:"End-to-end application generation with back-end, UI and policies."})]}),q("tr",{children:[g("td",{className:"px-4 py-3 align-top",children:g("strong",{children:"User interface"})}),g("td",{className:"px-4 py-3 align-top",children:"Self-service portal to run/monitor jobs; no custom UI generation for new apps."}),g("td",{className:"px-4 py-3 align-top",children:"Generates React/React-Native UIs from specs; users can personalise layout via overlays."})]}),q("tr",{children:[g("td",{className:"px-4 py-3 align-top",children:g("strong",{children:"Open source"})}),g("td",{className:"px-4 py-3 align-top",children:"Proprietary SaaS; enterprise agreements."}),g("td",{className:"px-4 py-3 align-top",children:"Core compiler is proprietary; SDK and certain modules may be open-source; offers hosted and on-prem options."})]}),q("tr",{children:[g("td",{className:"px-4 py-3 align-top",children:g("strong",{children:"Policy & personalisation"})}),g("td",{className:"px-4 py-3 align-top",children:"IT controls governance; no per-user overlay concept."}),g("td",{className:"px-4 py-3 align-top",children:"Built-in policy engine and per-user overlays for safe personalisation."})]})]})]})}),g("p",{className:"text-muted-foreground",children:"Redwood RunMyJobs is designed for orchestrating enterprise workloads and SAP processes. ContractSpec targets a different problem: generating complete applications from typed specs and letting end users adapt them safely."})]})]})}export{N as ComparisonEnterprisePlatformsPage};

package/dist/components/docs/comparison/ComparisonInternalToolBuildersPage.js

@@ -1,2 +1,2 @@
 // @bun
-import{jsx as e,jsxs as t}from"react/jsx-runtime";function a(){return t("div",{className:"space-y-8",children:[t("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"Internal-tool builders"}),e("p",{className:"text-muted-foreground",children:"Internal-tool builders let teams quickly assemble dashboards and admin panels. These platforms often provide drag-and-drop UIs and connectors to databases and APIs, but they rely on developers to write custom code for business logic and seldom enforce policies across surfaces."})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Feature comparison"}),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:"Feature"}),e("th",{className:"px-4 py-3 font-semibold",children:"Retool"}),e("th",{className:"px-4 py-3 font-semibold",children:"Appsmith"}),e("th",{className:"px-4 py-3 font-semibold",children:"ToolJet"}),e("th",{className:"px-4 py-3 font-semibold",children:"Budibase"})]})}),t("tbody",{className:"divide-y divide-border/50",children:[t("tr",{children:[e("td",{className:"px-4 py-3 align-top font-semibold",children:"UI builder"}),e("td",{className:"px-4 py-3 align-top",children:"Drag-and-drop canvas; shape UI components easily"}),e("td",{className:"px-4 py-3 align-top",children:"Visual builder with drag-and-drop widgets"}),e("td",{className:"px-4 py-3 align-top",children:"Drag-and-drop UI widgets (tables, charts, forms)"}),e("td",{className:"px-4 py-3 align-top",children:"Pre-built components and templates for mobile/desktop"})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top font-semibold",children:"Custom code & logic"}),e("td",{className:"px-4 py-3 align-top",children:"Full code insertion anywhere via IDE"}),e("td",{className:"px-4 py-3 align-top",children:"Logic via JavaScript or natural-language prompts in a central IDE"}),e("td",{className:"px-4 py-3 align-top",children:"Supports business logic in JavaScript or Python queries"}),e("td",{className:"px-4 py-3 align-top",children:"Custom logic via JavaScript; plugins and external embeds"})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top font-semibold",children:"Data connectors"}),e("td",{className:"px-4 py-3 align-top",children:"Wide support for databases and APIs (PostgreSQL, MongoDB, GraphQL, etc.)."}),e("td",{className:"px-4 py-3 align-top",children:"Connects to LLMs and databases"}),e("td",{className:"px-4 py-3 align-top",children:"Built-in database; connects to PostgreSQL, MongoDB, APIs, GraphQL, SaaS"}),e("td",{className:"px-4 py-3 align-top",children:"Connects to external databases, REST, CSV or built-in DB"})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top font-semibold",children:"Open source & self-host"}),e("td",{className:"px-4 py-3 align-top",children:"Proprietary; cloud or on-prem subscription."}),e("td",{className:"px-4 py-3 align-top",children:"Open source (Apache-2.0); self-host or cloud."}),e("td",{className:"px-4 py-3 align-top",children:"Open source; self-host via Docker or cloud."}),e("td",{className:"px-4 py-3 align-top",children:"Open source; self-host via Docker/Kubernetes"})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top font-semibold",children:"Policy & personalisation"}),e("td",{className:"px-4 py-3 align-top",children:"No built-in policy engine; personalisation limited to user roles."}),e("td",{className:"px-4 py-3 align-top",children:"No typed policy engine; customisation depends on user roles."}),e("td",{className:"px-4 py-3 align-top",children:"No policy engine; personalisation via user roles."}),e("td",{className:"px-4 py-3 align-top",children:"No policy engine; personalisation via RBAC & SSO"})]})]})]})})]}),t("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"ContractSpec\u2019s differences"}),t("ul",{className:"space-y-2 text-muted-foreground",children:[t("li",{children:[e("strong",{children:"Typed specifications"})," produce both the API and UI. You define capabilities, data views and workflows, and the compiler generates code, forms and screens\u2014no manual widget wiring."]}),t("li",{children:[e("strong",{children:"Policy enforcement"})," at run time ensures PII and ABAC rules across the entire app."]}),t("li",{children:[e("strong",{children:"Overlay personalisation"})," allows tenants and users to change layouts safely without code."]}),t("li",{children:[e("strong",{children:"Unified mobile/web runtime"})," means you don\u2019t need separate builders for React Native vs web."]})]}),e("p",{className:"text-muted-foreground",children:"Internal-tool builders are useful for quick dashboards. ContractSpec extends this by generating the whole stack from specs and enforcing policies throughout."})]})]})}export{a as ComparisonInternalToolBuildersPage};
+var n=Object.defineProperty;var s=(a)=>a;function i(a,o){this[a]=s.bind(null,o)}var d=(a,o)=>{for(var l in o)n(a,l,{get:o[l],enumerable:!0,configurable:!0,set:i.bind(o,l)})};var r=(a,o)=>()=>(a&&(o=a(a=0)),o);import{jsx as e,jsxs as t}from"react/jsx-runtime";function c(){return t("div",{className:"space-y-8",children:[t("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"Internal-tool builders"}),e("p",{className:"text-muted-foreground",children:"Internal-tool builders let teams quickly assemble dashboards and admin panels. These platforms often provide drag-and-drop UIs and connectors to databases and APIs, but they rely on developers to write custom code for business logic and seldom enforce policies across surfaces."})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Feature comparison"}),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:"Feature"}),e("th",{className:"px-4 py-3 font-semibold",children:"Retool"}),e("th",{className:"px-4 py-3 font-semibold",children:"Appsmith"}),e("th",{className:"px-4 py-3 font-semibold",children:"ToolJet"}),e("th",{className:"px-4 py-3 font-semibold",children:"Budibase"})]})}),t("tbody",{className:"divide-y divide-border/50",children:[t("tr",{children:[e("td",{className:"px-4 py-3 align-top font-semibold",children:"UI builder"}),e("td",{className:"px-4 py-3 align-top",children:"Drag-and-drop canvas; shape UI components easily"}),e("td",{className:"px-4 py-3 align-top",children:"Visual builder with drag-and-drop widgets"}),e("td",{className:"px-4 py-3 align-top",children:"Drag-and-drop UI widgets (tables, charts, forms)"}),e("td",{className:"px-4 py-3 align-top",children:"Pre-built components and templates for mobile/desktop"})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top font-semibold",children:"Custom code & logic"}),e("td",{className:"px-4 py-3 align-top",children:"Full code insertion anywhere via IDE"}),e("td",{className:"px-4 py-3 align-top",children:"Logic via JavaScript or natural-language prompts in a central IDE"}),e("td",{className:"px-4 py-3 align-top",children:"Supports business logic in JavaScript or Python queries"}),e("td",{className:"px-4 py-3 align-top",children:"Custom logic via JavaScript; plugins and external embeds"})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top font-semibold",children:"Data connectors"}),e("td",{className:"px-4 py-3 align-top",children:"Wide support for databases and APIs (PostgreSQL, MongoDB, GraphQL, etc.)."}),e("td",{className:"px-4 py-3 align-top",children:"Connects to LLMs and databases"}),e("td",{className:"px-4 py-3 align-top",children:"Built-in database; connects to PostgreSQL, MongoDB, APIs, GraphQL, SaaS"}),e("td",{className:"px-4 py-3 align-top",children:"Connects to external databases, REST, CSV or built-in DB"})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top font-semibold",children:"Open source & self-host"}),e("td",{className:"px-4 py-3 align-top",children:"Proprietary; cloud or on-prem subscription."}),e("td",{className:"px-4 py-3 align-top",children:"Open source (Apache-2.0); self-host or cloud."}),e("td",{className:"px-4 py-3 align-top",children:"Open source; self-host via Docker or cloud."}),e("td",{className:"px-4 py-3 align-top",children:"Open source; self-host via Docker/Kubernetes"})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top font-semibold",children:"Policy & personalisation"}),e("td",{className:"px-4 py-3 align-top",children:"No built-in policy engine; personalisation limited to user roles."}),e("td",{className:"px-4 py-3 align-top",children:"No typed policy engine; customisation depends on user roles."}),e("td",{className:"px-4 py-3 align-top",children:"No policy engine; personalisation via user roles."}),e("td",{className:"px-4 py-3 align-top",children:"No policy engine; personalisation via RBAC & SSO"})]})]})]})})]}),t("div",{className:"space-y-3",children:[e("h2",{className:"font-bold text-2xl",children:"ContractSpec\u2019s differences"}),t("ul",{className:"space-y-2 text-muted-foreground",children:[t("li",{children:[e("strong",{children:"Typed specifications"})," produce both the API and UI. You define capabilities, data views and workflows, and the compiler generates code, forms and screens\u2014no manual widget wiring."]}),t("li",{children:[e("strong",{children:"Policy enforcement"})," at run time ensures PII and ABAC rules across the entire app."]}),t("li",{children:[e("strong",{children:"Overlay personalisation"})," allows tenants and users to change layouts safely without code."]}),t("li",{children:[e("strong",{children:"Unified mobile/web runtime"})," means you don\u2019t need separate builders for React Native vs web."]})]}),e("p",{className:"text-muted-foreground",children:"Internal-tool builders are useful for quick dashboards. ContractSpec extends this by generating the whole stack from specs and enforcing policies throughout."})]})]})}export{c as ComparisonInternalToolBuildersPage};

package/dist/components/docs/comparison/ComparisonOverviewPage.js

@@ -1,2 +1,2 @@
 // @bun
-import{jsx as t,jsxs as e}from"react/jsx-runtime";function o(){return e("div",{className:"space-y-8",children:[e("div",{className:"space-y-4",children:[t("h1",{className:"font-bold text-4xl",children:"Comparison overview"}),t("p",{className:"text-muted-foreground",children:"ContractSpec sits at the intersection of several tool categories. To appreciate its unique offering\u2014typed specifications for back-end, front-end, workflows and policies with a unified web/mobile runtime\u2014this section compares it to related products."}),e("p",{className:"text-muted-foreground",children:["ContractSpec uses ",t("strong",{children:"runtime adapters"})," to serve typed"," ",t("strong",{children:"Operations"})," (Commands/Queries),"," ",t("strong",{children:"DataViews"}),", ",t("strong",{children:"Workflows"}),", and"," ",t("strong",{children:"Policies"})," as REST/GraphQL/MCP endpoints. A"," ",t("strong",{children:"policy decision point"})," governs every operation, and"," ",t("strong",{children:"OverlaySpecs"})," allow non-technical users to personalise screens safely. Few competitors offer this combination of runtime type safety, policy enforcement, and end-user customisation."]})]}),e("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Tool categories"}),t("div",{className:"overflow-x-auto rounded-lg border border-border/50",children:e("table",{className:"w-full text-left text-sm",children:[t("thead",{className:"bg-card/50",children:e("tr",{className:"border-border/50 border-b",children:[t("th",{className:"px-4 py-3 font-semibold",children:"Category"}),t("th",{className:"px-4 py-3 font-semibold",children:"Examples"}),t("th",{className:"px-4 py-3 font-semibold",children:"What they do"}),t("th",{className:"px-4 py-3 font-semibold",children:"Limitations"})]})}),e("tbody",{className:"divide-y divide-border/50",children:[e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Workflow engines"})}),t("td",{className:"px-4 py-3 align-top",children:"Prefect, Kestra, Temporal, Airflow, Dagster, Hatchet, Windmill"}),t("td",{className:"px-4 py-3 align-top",children:"Orchestrate code or data pipelines; handle retries, scheduling and observability"}),t("td",{className:"px-4 py-3 align-top",children:"Require writing code; no automatic UI generation or policy enforcement."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Internal-tool builders"})}),t("td",{className:"px-4 py-3 align-top",children:"Retool, Appsmith, ToolJet, Budibase"}),t("td",{className:"px-4 py-3 align-top",children:"Drag-and-drop dashboards and admin panels; connect to databases/APIs"}),t("td",{className:"px-4 py-3 align-top",children:"No typed back-end spec; limited enforcement of policies; custom code glues logic."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Automation platforms"})}),t("td",{className:"px-4 py-3 align-top",children:"Zapier, Make, n8n, Pipedream"}),t("td",{className:"px-4 py-3 align-top",children:"Connect apps via triggers and actions; visual or low-code interfaces"}),t("td",{className:"px-4 py-3 align-top",children:"Automate tasks but do not generate full apps or enforce per-field policies."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Enterprise orchestrators"})}),t("td",{className:"px-4 py-3 align-top",children:"Redwood RunMyJobs"}),t("td",{className:"px-4 py-3 align-top",children:"Automate mission-critical workloads with self-service portals and SAP integrations"}),t("td",{className:"px-4 py-3 align-top",children:"Focus on IT workloads; not built for custom app creation or per-user customisation."})]})]})]})}),t("p",{className:"text-muted-foreground",children:"Use the pages below to explore each group in detail and see how ContractSpec compares."})]})]})}export{o as ComparisonOverviewPage};
+var n=Object.defineProperty;var s=(o)=>o;function i(o,a){this[o]=s.bind(null,a)}var p=(o,a)=>{for(var r in a)n(o,r,{get:a[r],enumerable:!0,configurable:!0,set:i.bind(a,r)})};var l=(o,a)=>()=>(o&&(a=o(o=0)),a);import{jsx as t,jsxs as e}from"react/jsx-runtime";function c(){return e("div",{className:"space-y-8",children:[e("div",{className:"space-y-4",children:[t("h1",{className:"font-bold text-4xl",children:"Comparison overview"}),t("p",{className:"text-muted-foreground",children:"ContractSpec sits at the intersection of several tool categories. To appreciate its unique offering\u2014typed specifications for back-end, front-end, workflows and policies with a unified web/mobile runtime\u2014this section compares it to related products."}),e("p",{className:"text-muted-foreground",children:["ContractSpec uses ",t("strong",{children:"runtime adapters"})," to serve typed"," ",t("strong",{children:"Operations"})," (Commands/Queries),"," ",t("strong",{children:"DataViews"}),", ",t("strong",{children:"Workflows"}),", and"," ",t("strong",{children:"Policies"})," as REST/GraphQL/MCP endpoints. A"," ",t("strong",{children:"policy decision point"})," governs every operation, and"," ",t("strong",{children:"OverlaySpecs"})," allow non-technical users to personalise screens safely. Few competitors offer this combination of runtime type safety, policy enforcement, and end-user customisation."]})]}),e("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Tool categories"}),t("div",{className:"overflow-x-auto rounded-lg border border-border/50",children:e("table",{className:"w-full text-left text-sm",children:[t("thead",{className:"bg-card/50",children:e("tr",{className:"border-border/50 border-b",children:[t("th",{className:"px-4 py-3 font-semibold",children:"Category"}),t("th",{className:"px-4 py-3 font-semibold",children:"Examples"}),t("th",{className:"px-4 py-3 font-semibold",children:"What they do"}),t("th",{className:"px-4 py-3 font-semibold",children:"Limitations"})]})}),e("tbody",{className:"divide-y divide-border/50",children:[e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Workflow engines"})}),t("td",{className:"px-4 py-3 align-top",children:"Prefect, Kestra, Temporal, Airflow, Dagster, Hatchet, Windmill"}),t("td",{className:"px-4 py-3 align-top",children:"Orchestrate code or data pipelines; handle retries, scheduling and observability"}),t("td",{className:"px-4 py-3 align-top",children:"Require writing code; no automatic UI generation or policy enforcement."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Internal-tool builders"})}),t("td",{className:"px-4 py-3 align-top",children:"Retool, Appsmith, ToolJet, Budibase"}),t("td",{className:"px-4 py-3 align-top",children:"Drag-and-drop dashboards and admin panels; connect to databases/APIs"}),t("td",{className:"px-4 py-3 align-top",children:"No typed back-end spec; limited enforcement of policies; custom code glues logic."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Automation platforms"})}),t("td",{className:"px-4 py-3 align-top",children:"Zapier, Make, n8n, Pipedream"}),t("td",{className:"px-4 py-3 align-top",children:"Connect apps via triggers and actions; visual or low-code interfaces"}),t("td",{className:"px-4 py-3 align-top",children:"Automate tasks but do not generate full apps or enforce per-field policies."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Enterprise orchestrators"})}),t("td",{className:"px-4 py-3 align-top",children:"Redwood RunMyJobs"}),t("td",{className:"px-4 py-3 align-top",children:"Automate mission-critical workloads with self-service portals and SAP integrations"}),t("td",{className:"px-4 py-3 align-top",children:"Focus on IT workloads; not built for custom app creation or per-user customisation."})]})]})]})}),t("p",{className:"text-muted-foreground",children:"Use the pages below to explore each group in detail and see how ContractSpec compares."})]})]})}export{c as ComparisonOverviewPage};

package/dist/components/docs/comparison/ComparisonWindmillPage.js

@@ -1,2 +1,2 @@
 // @bun
-import{jsx as e,jsxs as t}from"react/jsx-runtime";function a(){return t("div",{className:"space-y-8",children:[t("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"Windmill"}),t("p",{className:"text-muted-foreground",children:["Windmill is an open-source platform that turns"," ",e("strong",{children:"scripts"})," into endpoints, workflows and UIs. It seeks to remove boilerplate by generating interfaces and workflows around existing code"]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Platform features"}),t("ul",{className:"space-y-3 text-muted-foreground",children:[t("li",{children:[e("strong",{children:"Script-driven model."})," Write scripts in TypeScript, Python, Go, PHP, Bash, C#, SQL or Rust; Windmill infers dependencies, creates lockfiles and JSON schemas, then serves minimal UIs automatically"]}),t("li",{children:[e("strong",{children:"Visual flow editor."})," Compose scripts into workflows with retries, error handling, loops, branching, suspending flows and approval steps"]}),t("li",{children:[e("strong",{children:"Low-code UI builder."})," Build dashboards and admin panels using inline scripts and trigger flows from the UI"]}),t("li",{children:[e("strong",{children:"Enterprise readiness."})," Features include RBAC permissions, secret management, OAuth handling, CLI/git sync, scheduling and webhooks"]}),t("li",{children:[e("strong",{children:"Use cases."})," Deploy scripts as webhooks or cron jobs; create \u201Capplicative workflows\u201D combining external APIs; build ETLs and interactive dashboards"]}),t("li",{children:[e("strong",{children:"Open source & self-hosting."})," Windmill emphasises an open-source codebase and self-hosting options"]})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Comparison with ContractSpec"}),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:"Feature"}),e("th",{className:"px-4 py-3 font-semibold",children:"Windmill"}),e("th",{className:"px-4 py-3 font-semibold",children:"ContractSpec"})]})}),t("tbody",{className:"divide-y divide-border/50",children:[t("tr",{children:[e("td",{className:"px-4 py-3 align-top",children:e("strong",{children:"Entry model"})}),e("td",{className:"px-4 py-3 align-top",children:"Write scripts; platform auto-generates UI and workflows"}),e("td",{className:"px-4 py-3 align-top",children:"Define typed specs (Capabilities, DataViews, Workflows, Policies); compiler outputs back-end, front-end and forms."})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top",children:e("strong",{children:"Language support"})}),e("td",{className:"px-4 py-3 align-top",children:"20+ languages via embedded runtimes"}),e("td",{className:"px-4 py-3 align-top",children:"Uses TypeScript/JavaScript for providers; supports other back-ends through capability providers."})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top",children:e("strong",{children:"UI generation"})}),e("td",{className:"px-4 py-3 align-top",children:"Minimal UI forms from script parameters; low-code app builder"}),e("td",{className:"px-4 py-3 align-top",children:"Generates full web and mobile UIs from specs; user layouts can be customised via signed overlays."})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top",children:e("strong",{children:"Policy & personalization"})}),e("td",{className:"px-4 py-3 align-top",children:"RBAC and secret management; no per-user overlay concept"}),e("td",{className:"px-4 py-3 align-top",children:"Built-in policy engine enforcing ABAC/PII on every render/mutate; overlays allow safe per-user customisation."})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top",children:e("strong",{children:"Open source"})}),e("td",{className:"px-4 py-3 align-top",children:"Fully open source and self-hostable"}),e("td",{className:"px-4 py-3 align-top",children:"Closed-source core (SDK is open); offers hosted and on-prem modes."})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top",children:e("strong",{children:"Ideal for"})}),e("td",{className:"px-4 py-3 align-top",children:"Teams wanting to expose scripts as APIs, workflows or dashboards without heavy infrastructure."}),e("td",{className:"px-4 py-3 align-top",children:"Teams needing a spec-driven platform that generates code and UI, enforces policies and lets non-technical users tailor the experience."})]})]})]})}),t("p",{className:"text-muted-foreground",children:["Windmill excels at converting scripts into workflows and admin panels. ContractSpec takes a ",e("strong",{children:"spec-first"})," approach, generating the entire stack and enforcing policies, making it suitable for long-lived applications that must evolve safely."]})]})]})}export{a as ComparisonWindmillPage};
+var r=Object.defineProperty;var s=(a)=>a;function i(a,o){this[a]=s.bind(null,o)}var l=(a,o)=>{for(var n in o)r(a,n,{get:o[n],enumerable:!0,configurable:!0,set:i.bind(o,n)})};var d=(a,o)=>()=>(a&&(o=a(a=0)),o);import{jsx as e,jsxs as t}from"react/jsx-runtime";function c(){return t("div",{className:"space-y-8",children:[t("div",{className:"space-y-4",children:[e("h1",{className:"font-bold text-4xl",children:"Windmill"}),t("p",{className:"text-muted-foreground",children:["Windmill is an open-source platform that turns"," ",e("strong",{children:"scripts"})," into endpoints, workflows and UIs. It seeks to remove boilerplate by generating interfaces and workflows around existing code"]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Platform features"}),t("ul",{className:"space-y-3 text-muted-foreground",children:[t("li",{children:[e("strong",{children:"Script-driven model."})," Write scripts in TypeScript, Python, Go, PHP, Bash, C#, SQL or Rust; Windmill infers dependencies, creates lockfiles and JSON schemas, then serves minimal UIs automatically"]}),t("li",{children:[e("strong",{children:"Visual flow editor."})," Compose scripts into workflows with retries, error handling, loops, branching, suspending flows and approval steps"]}),t("li",{children:[e("strong",{children:"Low-code UI builder."})," Build dashboards and admin panels using inline scripts and trigger flows from the UI"]}),t("li",{children:[e("strong",{children:"Enterprise readiness."})," Features include RBAC permissions, secret management, OAuth handling, CLI/git sync, scheduling and webhooks"]}),t("li",{children:[e("strong",{children:"Use cases."})," Deploy scripts as webhooks or cron jobs; create \u201Capplicative workflows\u201D combining external APIs; build ETLs and interactive dashboards"]}),t("li",{children:[e("strong",{children:"Open source & self-hosting."})," Windmill emphasises an open-source codebase and self-hosting options"]})]})]}),t("div",{className:"space-y-4",children:[e("h2",{className:"font-bold text-2xl",children:"Comparison with ContractSpec"}),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:"Feature"}),e("th",{className:"px-4 py-3 font-semibold",children:"Windmill"}),e("th",{className:"px-4 py-3 font-semibold",children:"ContractSpec"})]})}),t("tbody",{className:"divide-y divide-border/50",children:[t("tr",{children:[e("td",{className:"px-4 py-3 align-top",children:e("strong",{children:"Entry model"})}),e("td",{className:"px-4 py-3 align-top",children:"Write scripts; platform auto-generates UI and workflows"}),e("td",{className:"px-4 py-3 align-top",children:"Define typed specs (Capabilities, DataViews, Workflows, Policies); compiler outputs back-end, front-end and forms."})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top",children:e("strong",{children:"Language support"})}),e("td",{className:"px-4 py-3 align-top",children:"20+ languages via embedded runtimes"}),e("td",{className:"px-4 py-3 align-top",children:"Uses TypeScript/JavaScript for providers; supports other back-ends through capability providers."})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top",children:e("strong",{children:"UI generation"})}),e("td",{className:"px-4 py-3 align-top",children:"Minimal UI forms from script parameters; low-code app builder"}),e("td",{className:"px-4 py-3 align-top",children:"Generates full web and mobile UIs from specs; user layouts can be customised via signed overlays."})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top",children:e("strong",{children:"Policy & personalization"})}),e("td",{className:"px-4 py-3 align-top",children:"RBAC and secret management; no per-user overlay concept"}),e("td",{className:"px-4 py-3 align-top",children:"Built-in policy engine enforcing ABAC/PII on every render/mutate; overlays allow safe per-user customisation."})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top",children:e("strong",{children:"Open source"})}),e("td",{className:"px-4 py-3 align-top",children:"Fully open source and self-hostable"}),e("td",{className:"px-4 py-3 align-top",children:"Closed-source core (SDK is open); offers hosted and on-prem modes."})]}),t("tr",{children:[e("td",{className:"px-4 py-3 align-top",children:e("strong",{children:"Ideal for"})}),e("td",{className:"px-4 py-3 align-top",children:"Teams wanting to expose scripts as APIs, workflows or dashboards without heavy infrastructure."}),e("td",{className:"px-4 py-3 align-top",children:"Teams needing a spec-driven platform that generates code and UI, enforces policies and lets non-technical users tailor the experience."})]})]})]})}),t("p",{className:"text-muted-foreground",children:["Windmill excels at converting scripts into workflows and admin panels. ContractSpec takes a ",e("strong",{children:"spec-first"})," approach, generating the entire stack and enforcing policies, making it suitable for long-lived applications that must evolve safely."]})]})]})}export{c as ComparisonWindmillPage};

package/dist/components/docs/comparison/ComparisonWorkflowEnginesPage.js

@@ -1,2 +1,2 @@
 // @bun
-import{jsx as t,jsxs as e}from"react/jsx-runtime";function a(){return e("div",{className:"space-y-8",children:[e("div",{className:"space-y-4",children:[t("h1",{className:"font-bold text-4xl",children:"Workflow engines"}),t("p",{className:"text-muted-foreground",children:"Workflow engines orchestrate long-running tasks and data pipelines. They provide retries, scheduling and visibility, but most expect developers to write code and do not generate user interfaces. Here\u2019s how the major engines compare to ContractSpec."})]}),e("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Key differences summary"}),t("div",{className:"overflow-x-auto rounded-lg border border-border/50",children:e("table",{className:"w-full text-left text-sm",children:[t("thead",{className:"bg-card/50",children:e("tr",{className:"border-border/50 border-b",children:[t("th",{className:"px-4 py-3 font-semibold",children:"Engine"}),t("th",{className:"px-4 py-3 font-semibold",children:"Core strengths"}),t("th",{className:"px-4 py-3 font-semibold",children:"UI generation?"}),t("th",{className:"px-4 py-3 font-semibold",children:"Policy/PII enforcement?"}),t("th",{className:"px-4 py-3 font-semibold",children:"Self-host?"}),t("th",{className:"px-4 py-3 font-semibold",children:"Primary use"})]})}),e("tbody",{className:"divide-y divide-border/50",children:[e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Prefect"})}),t("td",{className:"px-4 py-3 align-top",children:"Python-native; dynamic DAGs adapt to change; annotate code without rewriting; strong observability and audit logs"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"Yes"}),t("td",{className:"px-4 py-3 align-top",children:"Data pipelines and dynamic workflows."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Kestra"})}),t("td",{className:"px-4 py-3 align-top",children:"Declarative YAML; event-driven triggers; mix of code and no-code; write logic in Python/R/Java/Julia/Ruby; deploy anywhere"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"Yes"}),t("td",{className:"px-4 py-3 align-top",children:"Data pipelines and hybrid orchestration."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Temporal"})}),t("td",{className:"px-4 py-3 align-top",children:"Durable execution; workflows never lose state; multi-language SDKs; automatic retries"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"Yes"}),t("td",{className:"px-4 py-3 align-top",children:"Durable microservice and business workflows."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Airflow"})}),t("td",{className:"px-4 py-3 align-top",children:"Open-source; define workflows as Python code; schedule and monitor via UI; extensible via custom operators"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"Yes"}),t("td",{className:"px-4 py-3 align-top",children:"Data ETL pipelines."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Dagster"})}),t("td",{className:"px-4 py-3 align-top",children:"Data-asset model; local testing and reusable components; built-in data quality and catalog; orchestrates AI/data pipelines across multiple tools"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"Yes"}),t("td",{className:"px-4 py-3 align-top",children:"Data/AI pipelines with strong observability."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Hatchet"})}),t("td",{className:"px-4 py-3 align-top",children:"Modern engine focused on performance and durability; tasks and workflows as code; durable functions with guardrails and retries"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"Yes"}),t("td",{className:"px-4 py-3 align-top",children:"High-throughput background jobs and microservices."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Windmill"})}),t("td",{className:"px-4 py-3 align-top",children:"Multi-language scripts; auto-generates UI; integrated flow editor"}),t("td",{className:"px-4 py-3 align-top",children:"Yes (basic)"}),t("td",{className:"px-4 py-3 align-top",children:"RBAC & secrets only"}),t("td",{className:"px-4 py-3 align-top",children:"Yes"}),t("td",{className:"px-4 py-3 align-top",children:"Scripts into workflows and dashboards."})]})]})]})})]}),e("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"Why ContractSpec differs"}),e("ul",{className:"space-y-2 text-muted-foreground",children:[e("li",{children:[t("strong",{children:"Spec-first generation"})," \u2013 Instead of writing code, you define typed specs for capabilities, data views and workflows; the compiler outputs both back-end and front-end."]}),e("li",{children:[t("strong",{children:"Policy engine"})," \u2013 Every render and mutate passes through an ABAC/PII policy decision point."]}),e("li",{children:[t("strong",{children:"Personalisation"})," \u2013 Signed OverlaySpecs allow tenant/user-specific UI changes without touching code."]}),e("li",{children:[t("strong",{children:"Unified runtime"})," \u2013 React/React-Native rendering ensures consistent experiences across web and mobile."]})]}),t("p",{className:"text-muted-foreground",children:"Workflow engines are excellent for orchestrating back-end tasks. ContractSpec builds on this by serving complete applications with runtime policy enforcement and user personalisation via TypeScript specs."})]})]})}export{a as ComparisonWorkflowEnginesPage};
+var i=Object.defineProperty;var l=(a)=>a;function p(a,o){this[a]=l.bind(null,o)}var d=(a,o)=>{for(var n in o)i(a,n,{get:o[n],enumerable:!0,configurable:!0,set:p.bind(o,n)})};var s=(a,o)=>()=>(a&&(o=a(a=0)),o);import{jsx as t,jsxs as e}from"react/jsx-runtime";function c(){return e("div",{className:"space-y-8",children:[e("div",{className:"space-y-4",children:[t("h1",{className:"font-bold text-4xl",children:"Workflow engines"}),t("p",{className:"text-muted-foreground",children:"Workflow engines orchestrate long-running tasks and data pipelines. They provide retries, scheduling and visibility, but most expect developers to write code and do not generate user interfaces. Here\u2019s how the major engines compare to ContractSpec."})]}),e("div",{className:"space-y-4",children:[t("h2",{className:"font-bold text-2xl",children:"Key differences summary"}),t("div",{className:"overflow-x-auto rounded-lg border border-border/50",children:e("table",{className:"w-full text-left text-sm",children:[t("thead",{className:"bg-card/50",children:e("tr",{className:"border-border/50 border-b",children:[t("th",{className:"px-4 py-3 font-semibold",children:"Engine"}),t("th",{className:"px-4 py-3 font-semibold",children:"Core strengths"}),t("th",{className:"px-4 py-3 font-semibold",children:"UI generation?"}),t("th",{className:"px-4 py-3 font-semibold",children:"Policy/PII enforcement?"}),t("th",{className:"px-4 py-3 font-semibold",children:"Self-host?"}),t("th",{className:"px-4 py-3 font-semibold",children:"Primary use"})]})}),e("tbody",{className:"divide-y divide-border/50",children:[e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Prefect"})}),t("td",{className:"px-4 py-3 align-top",children:"Python-native; dynamic DAGs adapt to change; annotate code without rewriting; strong observability and audit logs"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"Yes"}),t("td",{className:"px-4 py-3 align-top",children:"Data pipelines and dynamic workflows."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Kestra"})}),t("td",{className:"px-4 py-3 align-top",children:"Declarative YAML; event-driven triggers; mix of code and no-code; write logic in Python/R/Java/Julia/Ruby; deploy anywhere"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"Yes"}),t("td",{className:"px-4 py-3 align-top",children:"Data pipelines and hybrid orchestration."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Temporal"})}),t("td",{className:"px-4 py-3 align-top",children:"Durable execution; workflows never lose state; multi-language SDKs; automatic retries"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"Yes"}),t("td",{className:"px-4 py-3 align-top",children:"Durable microservice and business workflows."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Airflow"})}),t("td",{className:"px-4 py-3 align-top",children:"Open-source; define workflows as Python code; schedule and monitor via UI; extensible via custom operators"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"Yes"}),t("td",{className:"px-4 py-3 align-top",children:"Data ETL pipelines."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Dagster"})}),t("td",{className:"px-4 py-3 align-top",children:"Data-asset model; local testing and reusable components; built-in data quality and catalog; orchestrates AI/data pipelines across multiple tools"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"Yes"}),t("td",{className:"px-4 py-3 align-top",children:"Data/AI pipelines with strong observability."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Hatchet"})}),t("td",{className:"px-4 py-3 align-top",children:"Modern engine focused on performance and durability; tasks and workflows as code; durable functions with guardrails and retries"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"No"}),t("td",{className:"px-4 py-3 align-top",children:"Yes"}),t("td",{className:"px-4 py-3 align-top",children:"High-throughput background jobs and microservices."})]}),e("tr",{children:[t("td",{className:"px-4 py-3 align-top",children:t("strong",{children:"Windmill"})}),t("td",{className:"px-4 py-3 align-top",children:"Multi-language scripts; auto-generates UI; integrated flow editor"}),t("td",{className:"px-4 py-3 align-top",children:"Yes (basic)"}),t("td",{className:"px-4 py-3 align-top",children:"RBAC & secrets only"}),t("td",{className:"px-4 py-3 align-top",children:"Yes"}),t("td",{className:"px-4 py-3 align-top",children:"Scripts into workflows and dashboards."})]})]})]})})]}),e("div",{className:"space-y-3",children:[t("h2",{className:"font-bold text-2xl",children:"Why ContractSpec differs"}),e("ul",{className:"space-y-2 text-muted-foreground",children:[e("li",{children:[t("strong",{children:"Spec-first generation"})," \u2013 Instead of writing code, you define typed specs for capabilities, data views and workflows; the compiler outputs both back-end and front-end."]}),e("li",{children:[t("strong",{children:"Policy engine"})," \u2013 Every render and mutate passes through an ABAC/PII policy decision point."]}),e("li",{children:[t("strong",{children:"Personalisation"})," \u2013 Signed OverlaySpecs allow tenant/user-specific UI changes without touching code."]}),e("li",{children:[t("strong",{children:"Unified runtime"})," \u2013 React/React-Native rendering ensures consistent experiences across web and mobile."]})]}),t("p",{className:"text-muted-foreground",children:"Workflow engines are excellent for orchestrating back-end tasks. ContractSpec builds on this by serving complete applications with runtime policy enforcement and user personalisation via TypeScript specs."})]})]})}export{c as ComparisonWorkflowEnginesPage};