@contractspec/bundle.library 3.8.10 → 3.8.12

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

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

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

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