@contractspec/bundle.library 2.9.1 → 3.0.0

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @contractspec/bundle.library
 
+## 3.0.0
+
+### Major Changes
+
+- b781ce6: feat: improve ai readiness
+
+### Patch Changes
+
+- 0c438ac: Add architecture docs for the control-plane runtime and link the new page from the architecture overview and docs navigation.
+- 95c27e4: Align ecosystem docs with the Cursor marketplace catalog model by documenting the root `.cursor-plugin/marketplace.json`, package-scoped plugin sources in `packages/apps-registry/cursor-marketplace`, and catalog-wide validation via `bun run plugin:contractspec:validate`.
+
+  Rename ecosystem navigation and docblocks from generic Plugin API and Registry wording to Marketplace Plugins, Authoring Templates, and Marketplace Manifest for consistent docs discoverability.
+
+- 3aa6269: Expand the integrations docs with Mistral, Slack, GitHub, WhatsApp Meta, WhatsApp Twilio, and health transport routing pages.
+
+  Refresh the integrations overview/spec model and docs sidebar links so the new messaging and runtime guidance is discoverable from web-landing.
+
+- Updated dependencies [7cbdb7f]
+- Updated dependencies [c608804]
+- Updated dependencies [e3bc858]
+- Updated dependencies [b19ae0a]
+- Updated dependencies [aa4a9c9]
+- Updated dependencies [b781ce6]
+  - @contractspec/lib.contracts-spec@3.0.0
+  - @contractspec/lib.contracts-integrations@3.0.0
+  - @contractspec/lib.contracts-runtime-server-graphql@3.0.0
+  - @contractspec/lib.contracts-runtime-server-rest@3.0.0
+  - @contractspec/lib.contracts-runtime-server-mcp@3.0.0
+  - @contractspec/lib.contracts-library@3.0.0
+  - @contractspec/lib.example-shared-ui@3.0.0
+  - @contractspec/lib.runtime-sandbox@2.0.0
+  - @contractspec/lib.design-system@3.0.0
+  - @contractspec/module.examples@3.0.0
+  - @contractspec/lib.ui-kit-web@3.0.0
+  - @contractspec/lib.ui-link@3.0.0
+  - @contractspec/lib.logger@3.0.0
+  - @contractspec/lib.schema@3.0.0
+
 ## 2.9.1
 
 ### Patch Changes

package/dist/components/docs/DocsIndexPage.js

@@ -208,7 +208,7 @@ bun contractspec build src/contracts/mySpec.ts`
               },
               {
                 title: "Ecosystem",
-                description: "Plugin API, templates, and integrations",
+                description: "Cursor marketplace plugins, templates, manifest, and integrations",
                 href: "/docs/ecosystem/plugins"
               },
               {

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

@@ -0,0 +1 @@
+export declare function ArchitectureControlPlanePage(): import("react/jsx-runtime").JSX.Element;

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';