@contractspec/bundle.library 2.9.1 → 3.1.1

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

@@ -0,0 +1,204 @@
+// @bun
+// 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 { jsxDEV } from "react/jsx-dev-runtime";
+function ArchitectureControlPlanePage() {
+  return /* @__PURE__ */ jsxDEV("div", {
+    className: "space-y-8",
+    children: [
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h1", {
+            className: "text-4xl font-bold",
+            children: "Control Plane Runtime"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("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."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Canonical execution loop"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("ol", {
+            className: "text-muted-foreground list-inside list-decimal space-y-2",
+            children: [
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Accept intent and create execution identity + trace context."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Compile intent into a typed, deterministic plan DAG."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Verify plan against policy and risk rules."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Route into autonomous or assist mode based on verdict."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Execute steps with idempotent keys and explicit stage events."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Persist outcomes for replay, audits, and operator visibility."
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Contract surfaces (v1 baseline)"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("p", {
+            className: "text-muted-foreground",
+            children: [
+              "The runtime is contract-first. Commands, queries, events, and capabilities are explicit and versioned under",
+              /* @__PURE__ */ jsxDEV("code", {
+                children: " @contractspec/lib.contracts-spec"
+              }, undefined, false, undefined, this),
+              "."
+            ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "text",
+            code: `Commands
+- controlPlane.intent.submit
+- controlPlane.plan.compile
+- controlPlane.plan.verify
+- controlPlane.execution.start
+- controlPlane.execution.approve
+- controlPlane.execution.reject
+- controlPlane.execution.cancel
+- controlPlane.skill.install
+- controlPlane.skill.disable
+
+Queries
+- controlPlane.execution.get
+- controlPlane.execution.list
+- controlPlane.trace.get
+- controlPlane.policy.explain
+- controlPlane.skill.list
+- controlPlane.skill.verify
+
+Events
+- controlPlane.intent.received
+- controlPlane.plan.compiled
+- controlPlane.plan.rejected
+- controlPlane.execution.step.started
+- controlPlane.execution.step.blocked
+- controlPlane.execution.step.completed
+- controlPlane.execution.completed
+- controlPlane.execution.failed
+- controlPlane.skill.installed
+- controlPlane.skill.rejected
+
+Capabilities
+- control-plane.core
+- control-plane.approval
+- control-plane.audit
+- control-plane.skill-registry
+- control-plane.channel-runtime`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Policy and safety posture"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("ul", {
+            className: "text-muted-foreground list-inside list-disc space-y-2",
+            children: [
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "No side-effect action executes unless it comes from a compiled plan."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "High-risk actions are blocked from autonomous mode in v1."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Approval commands provide explicit human-in-the-loop transitions."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Skill installation is modeled as governance-controlled operations."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Trace queries expose policy rationale and step outcomes for replay."
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "Implementation map"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(CodeBlock, {
+            language: "text",
+            code: `packages/libs/contracts-spec/src/control-plane/
+  commands/
+  queries/
+  events/
+  capabilities/
+  contracts.ts
+  contracts.test.ts
+
+packages/apps/web-landing/src/app/docs/architecture/control-plane/page.tsx
+implementation_plan_controle_plane.md`
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "space-y-4",
+        children: [
+          /* @__PURE__ */ jsxDEV("h2", {
+            className: "text-2xl font-bold",
+            children: "What comes next"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV("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."
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV("div", {
+        className: "flex items-center gap-4 pt-4",
+        children: [
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/architecture/integration-binding",
+            className: "btn-ghost",
+            children: "Previous: Integration Binding"
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/safety/auditing",
+            className: "btn-primary",
+            children: [
+              "Audit Logs ",
+              /* @__PURE__ */ jsxDEV(ChevronRight, {
+                size: 16
+              }, undefined, false, undefined, this)
+            ]
+          }, undefined, true, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  ArchitectureControlPlanePage
+};

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

@@ -16,7 +16,7 @@ function ArchitectureOverviewPage() {
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV("p", {
             className: "text-muted-foreground",
-            children: "ContractSpec's architecture is built on a foundation of typed specifications served by runtime adapters. This section covers the core architectural concepts: app configuration, integration binding, and knowledge management."
+            children: "ContractSpec's architecture is built on a foundation of typed specifications served by runtime adapters. This section covers the core architectural concepts: app configuration, integration binding, control-plane governance, and knowledge management."
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this),
@@ -206,6 +206,17 @@ function ArchitectureOverviewPage() {
                           " - Enforces policies on every operation"
                         ]
                       }, undefined, true, undefined, this),
+                      /* @__PURE__ */ jsxDEV("li", {
+                        children: [
+                          /* @__PURE__ */ jsxDEV(Link, {
+                            href: "/docs/architecture/control-plane",
+                            className: "text-violet-400 hover:text-violet-300",
+                            children: "Control Plane Runtime"
+                          }, undefined, false, undefined, this),
+                          " ",
+                          "- Deterministic intent to plan to policy to execution loop"
+                        ]
+                      }, undefined, true, undefined, this),
                       /* @__PURE__ */ jsxDEV("li", {
                         children: [
                           /* @__PURE__ */ jsxDEV("strong", {
@@ -429,6 +440,11 @@ function ArchitectureOverviewPage() {
               }, undefined, false, undefined, this)
             ]
           }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV(Link, {
+            href: "/docs/architecture/control-plane",
+            className: "btn-ghost",
+            children: "Control Plane Runtime"
+          }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV(Link, {
             href: "/docs/integrations",
             className: "btn-ghost",

package/dist/components/docs/architecture/index.d.ts

@@ -3,3 +3,4 @@ export { ArchitectureAppConfigPage } from './ArchitectureAppConfigPage';
 export { ArchitectureMultiTenancyPage } from './ArchitectureMultiTenancyPage';
 export { ArchitectureIntegrationBindingPage } from './ArchitectureIntegrationBindingPage';
 export { ArchitectureKnowledgeBindingPage } from './ArchitectureKnowledgeBindingPage';
+export { ArchitectureControlPlanePage } from './ArchitectureControlPlanePage';