@contractspec/bundle.library 2.9.0 → 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/bundle.library",
-  "version": "2.9.0",
+  "version": "3.0.0",
   "type": "module",
   "scripts": {
     "clean": "rm -rf dist",
@@ -138,6 +138,12 @@
       "node": "./dist/node/components/docs/architecture/ArchitectureAppConfigPage.js",
       "default": "./dist/components/docs/architecture/ArchitectureAppConfigPage.js"
     },
+    "./components/docs/architecture/ArchitectureControlPlanePage": {
+      "types": "./dist/components/docs/architecture/ArchitectureControlPlanePage.d.ts",
+      "bun": "./dist/components/docs/architecture/ArchitectureControlPlanePage.js",
+      "node": "./dist/node/components/docs/architecture/ArchitectureControlPlanePage.js",
+      "default": "./dist/components/docs/architecture/ArchitectureControlPlanePage.js"
+    },
     "./components/docs/architecture/ArchitectureIntegrationBindingPage": {
       "types": "./dist/components/docs/architecture/ArchitectureIntegrationBindingPage.d.ts",
       "bun": "./dist/components/docs/architecture/ArchitectureIntegrationBindingPage.js",
@@ -474,6 +480,12 @@
       "node": "./dist/node/components/docs/integrations/IntegrationsElevenLabsPage.js",
       "default": "./dist/components/docs/integrations/IntegrationsElevenLabsPage.js"
     },
+    "./components/docs/integrations/IntegrationsGithubPage": {
+      "types": "./dist/components/docs/integrations/IntegrationsGithubPage.d.ts",
+      "bun": "./dist/components/docs/integrations/IntegrationsGithubPage.js",
+      "node": "./dist/node/components/docs/integrations/IntegrationsGithubPage.js",
+      "default": "./dist/components/docs/integrations/IntegrationsGithubPage.js"
+    },
     "./components/docs/integrations/IntegrationsGmailPage": {
       "types": "./dist/components/docs/integrations/IntegrationsGmailPage.d.ts",
       "bun": "./dist/components/docs/integrations/IntegrationsGmailPage.js",
@@ -486,6 +498,18 @@
       "node": "./dist/node/components/docs/integrations/IntegrationsGoogleCalendarPage.js",
       "default": "./dist/components/docs/integrations/IntegrationsGoogleCalendarPage.js"
     },
+    "./components/docs/integrations/IntegrationsHealthRoutingPage": {
+      "types": "./dist/components/docs/integrations/IntegrationsHealthRoutingPage.d.ts",
+      "bun": "./dist/components/docs/integrations/IntegrationsHealthRoutingPage.js",
+      "node": "./dist/node/components/docs/integrations/IntegrationsHealthRoutingPage.js",
+      "default": "./dist/components/docs/integrations/IntegrationsHealthRoutingPage.js"
+    },
+    "./components/docs/integrations/IntegrationsMistralPage": {
+      "types": "./dist/components/docs/integrations/IntegrationsMistralPage.d.ts",
+      "bun": "./dist/components/docs/integrations/IntegrationsMistralPage.js",
+      "node": "./dist/node/components/docs/integrations/IntegrationsMistralPage.js",
+      "default": "./dist/components/docs/integrations/IntegrationsMistralPage.js"
+    },
     "./components/docs/integrations/IntegrationsOpenAIPage": {
       "types": "./dist/components/docs/integrations/IntegrationsOpenAIPage.d.ts",
       "bun": "./dist/components/docs/integrations/IntegrationsOpenAIPage.js",
@@ -528,6 +552,12 @@
       "node": "./dist/node/components/docs/integrations/IntegrationsS3Page.js",
       "default": "./dist/components/docs/integrations/IntegrationsS3Page.js"
     },
+    "./components/docs/integrations/IntegrationsSlackPage": {
+      "types": "./dist/components/docs/integrations/IntegrationsSlackPage.d.ts",
+      "bun": "./dist/components/docs/integrations/IntegrationsSlackPage.js",
+      "node": "./dist/node/components/docs/integrations/IntegrationsSlackPage.js",
+      "default": "./dist/components/docs/integrations/IntegrationsSlackPage.js"
+    },
     "./components/docs/integrations/IntegrationsSpecModelPage": {
       "types": "./dist/components/docs/integrations/IntegrationsSpecModelPage.d.ts",
       "bun": "./dist/components/docs/integrations/IntegrationsSpecModelPage.js",
@@ -546,6 +576,18 @@
       "node": "./dist/node/components/docs/integrations/IntegrationsTwilioPage.js",
       "default": "./dist/components/docs/integrations/IntegrationsTwilioPage.js"
     },
+    "./components/docs/integrations/IntegrationsWhatsappMetaPage": {
+      "types": "./dist/components/docs/integrations/IntegrationsWhatsappMetaPage.d.ts",
+      "bun": "./dist/components/docs/integrations/IntegrationsWhatsappMetaPage.js",
+      "node": "./dist/node/components/docs/integrations/IntegrationsWhatsappMetaPage.js",
+      "default": "./dist/components/docs/integrations/IntegrationsWhatsappMetaPage.js"
+    },
+    "./components/docs/integrations/IntegrationsWhatsappTwilioPage": {
+      "types": "./dist/components/docs/integrations/IntegrationsWhatsappTwilioPage.d.ts",
+      "bun": "./dist/components/docs/integrations/IntegrationsWhatsappTwilioPage.js",
+      "node": "./dist/node/components/docs/integrations/IntegrationsWhatsappTwilioPage.js",
+      "default": "./dist/components/docs/integrations/IntegrationsWhatsappTwilioPage.js"
+    },
     "./components/docs/intent": {
       "types": "./dist/components/docs/intent/index.d.ts",
       "bun": "./dist/components/docs/intent/index.js",
@@ -2053,17 +2095,17 @@
   },
   "dependencies": {
     "@apollo/client": "^4.1.6",
-    "@contractspec/lib.contracts-spec": "2.9.0",
-    "@contractspec/lib.contracts-library": "2.9.0",
-    "@contractspec/lib.contracts-runtime-server-mcp": "2.9.0",
-    "@contractspec/lib.design-system": "2.9.0",
-    "@contractspec/lib.example-shared-ui": "2.9.0",
-    "@contractspec/lib.logger": "2.9.0",
-    "@contractspec/lib.runtime-sandbox": "1.9.0",
-    "@contractspec/lib.schema": "2.9.0",
-    "@contractspec/lib.ui-kit-web": "2.9.0",
-    "@contractspec/lib.ui-link": "2.9.0",
-    "@contractspec/module.examples": "2.9.0",
+    "@contractspec/lib.contracts-spec": "3.0.0",
+    "@contractspec/lib.contracts-library": "3.0.0",
+    "@contractspec/lib.contracts-runtime-server-mcp": "3.0.0",
+    "@contractspec/lib.design-system": "3.0.0",
+    "@contractspec/lib.example-shared-ui": "3.0.0",
+    "@contractspec/lib.logger": "3.0.0",
+    "@contractspec/lib.runtime-sandbox": "2.0.0",
+    "@contractspec/lib.schema": "3.0.0",
+    "@contractspec/lib.ui-kit-web": "3.0.0",
+    "@contractspec/lib.ui-link": "3.0.0",
+    "@contractspec/module.examples": "3.0.0",
     "@dnd-kit/core": "^6.1.0",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
@@ -2073,21 +2115,21 @@
     "drizzle-orm": "^0.45.1",
     "framer-motion": "^12.34.3",
     "lucide-react": "^0.575.0",
-    "posthog-js": "^1.353.0",
-    "posthog-node": "^5.25.0",
-    "posthog-react-native": "^4.34.0",
+    "posthog-js": "^1.356.0",
+    "posthog-node": "^5.26.0",
+    "posthog-react-native": "^4.36.1",
     "react-hook-form": "^7.71.2",
     "zod": "^4.3.5",
-    "@contractspec/lib.contracts-integrations": "2.9.0",
-    "@contractspec/lib.contracts-runtime-server-rest": "2.9.0",
-    "@contractspec/lib.contracts-runtime-server-graphql": "2.9.0"
+    "@contractspec/lib.contracts-integrations": "3.0.0",
+    "@contractspec/lib.contracts-runtime-server-rest": "3.0.0",
+    "@contractspec/lib.contracts-runtime-server-graphql": "3.0.0"
   },
   "devDependencies": {
     "@types/react": "~19.2.14",
-    "@contractspec/tool.typescript": "2.9.0",
+    "@contractspec/tool.typescript": "3.0.0",
     "typescript": "^5.9.3",
     "@types/bun": "~1.3.9",
-    "@contractspec/tool.bun": "2.9.0"
+    "@contractspec/tool.bun": "3.0.0"
   },
   "publishConfig": {
     "access": "public",
@@ -2213,6 +2255,12 @@
         "node": "./dist/node/components/docs/architecture/ArchitectureAppConfigPage.js",
         "default": "./dist/components/docs/architecture/ArchitectureAppConfigPage.js"
       },
+      "./components/docs/architecture/ArchitectureControlPlanePage": {
+        "types": "./dist/components/docs/architecture/ArchitectureControlPlanePage.d.ts",
+        "bun": "./dist/components/docs/architecture/ArchitectureControlPlanePage.js",
+        "node": "./dist/node/components/docs/architecture/ArchitectureControlPlanePage.js",
+        "default": "./dist/components/docs/architecture/ArchitectureControlPlanePage.js"
+      },
       "./components/docs/architecture/ArchitectureIntegrationBindingPage": {
         "types": "./dist/components/docs/architecture/ArchitectureIntegrationBindingPage.d.ts",
         "bun": "./dist/components/docs/architecture/ArchitectureIntegrationBindingPage.js",
@@ -2549,6 +2597,12 @@
         "node": "./dist/node/components/docs/integrations/IntegrationsElevenLabsPage.js",
         "default": "./dist/components/docs/integrations/IntegrationsElevenLabsPage.js"
       },
+      "./components/docs/integrations/IntegrationsGithubPage": {
+        "types": "./dist/components/docs/integrations/IntegrationsGithubPage.d.ts",
+        "bun": "./dist/components/docs/integrations/IntegrationsGithubPage.js",
+        "node": "./dist/node/components/docs/integrations/IntegrationsGithubPage.js",
+        "default": "./dist/components/docs/integrations/IntegrationsGithubPage.js"
+      },
       "./components/docs/integrations/IntegrationsGmailPage": {
         "types": "./dist/components/docs/integrations/IntegrationsGmailPage.d.ts",
         "bun": "./dist/components/docs/integrations/IntegrationsGmailPage.js",
@@ -2561,6 +2615,18 @@
         "node": "./dist/node/components/docs/integrations/IntegrationsGoogleCalendarPage.js",
         "default": "./dist/components/docs/integrations/IntegrationsGoogleCalendarPage.js"
       },
+      "./components/docs/integrations/IntegrationsHealthRoutingPage": {
+        "types": "./dist/components/docs/integrations/IntegrationsHealthRoutingPage.d.ts",
+        "bun": "./dist/components/docs/integrations/IntegrationsHealthRoutingPage.js",
+        "node": "./dist/node/components/docs/integrations/IntegrationsHealthRoutingPage.js",
+        "default": "./dist/components/docs/integrations/IntegrationsHealthRoutingPage.js"
+      },
+      "./components/docs/integrations/IntegrationsMistralPage": {
+        "types": "./dist/components/docs/integrations/IntegrationsMistralPage.d.ts",
+        "bun": "./dist/components/docs/integrations/IntegrationsMistralPage.js",
+        "node": "./dist/node/components/docs/integrations/IntegrationsMistralPage.js",
+        "default": "./dist/components/docs/integrations/IntegrationsMistralPage.js"
+      },
       "./components/docs/integrations/IntegrationsOpenAIPage": {
         "types": "./dist/components/docs/integrations/IntegrationsOpenAIPage.d.ts",
         "bun": "./dist/components/docs/integrations/IntegrationsOpenAIPage.js",
@@ -2603,6 +2669,12 @@
         "node": "./dist/node/components/docs/integrations/IntegrationsS3Page.js",
         "default": "./dist/components/docs/integrations/IntegrationsS3Page.js"
       },
+      "./components/docs/integrations/IntegrationsSlackPage": {
+        "types": "./dist/components/docs/integrations/IntegrationsSlackPage.d.ts",
+        "bun": "./dist/components/docs/integrations/IntegrationsSlackPage.js",
+        "node": "./dist/node/components/docs/integrations/IntegrationsSlackPage.js",
+        "default": "./dist/components/docs/integrations/IntegrationsSlackPage.js"
+      },
       "./components/docs/integrations/IntegrationsSpecModelPage": {
         "types": "./dist/components/docs/integrations/IntegrationsSpecModelPage.d.ts",
         "bun": "./dist/components/docs/integrations/IntegrationsSpecModelPage.js",
@@ -2621,6 +2693,18 @@
         "node": "./dist/node/components/docs/integrations/IntegrationsTwilioPage.js",
         "default": "./dist/components/docs/integrations/IntegrationsTwilioPage.js"
       },
+      "./components/docs/integrations/IntegrationsWhatsappMetaPage": {
+        "types": "./dist/components/docs/integrations/IntegrationsWhatsappMetaPage.d.ts",
+        "bun": "./dist/components/docs/integrations/IntegrationsWhatsappMetaPage.js",
+        "node": "./dist/node/components/docs/integrations/IntegrationsWhatsappMetaPage.js",
+        "default": "./dist/components/docs/integrations/IntegrationsWhatsappMetaPage.js"
+      },
+      "./components/docs/integrations/IntegrationsWhatsappTwilioPage": {
+        "types": "./dist/components/docs/integrations/IntegrationsWhatsappTwilioPage.d.ts",
+        "bun": "./dist/components/docs/integrations/IntegrationsWhatsappTwilioPage.js",
+        "node": "./dist/node/components/docs/integrations/IntegrationsWhatsappTwilioPage.js",
+        "default": "./dist/components/docs/integrations/IntegrationsWhatsappTwilioPage.js"
+      },
       "./components/docs/intent": {
         "types": "./dist/components/docs/intent/index.d.ts",
         "bun": "./dist/components/docs/intent/index.js",

package/src/components/docs/DocsIndexPage.tsx

@@ -195,7 +195,8 @@ 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/src/components/docs/architecture/ArchitectureControlPlanePage.tsx

@@ -0,0 +1,136 @@
+import { CodeBlock } from '@contractspec/lib.design-system';
+import Link from '@contractspec/lib.ui-link';
+import { ChevronRight } from 'lucide-react';
+
+export function ArchitectureControlPlanePage() {
+  return (
+    <div className="space-y-8">
+      <div className="space-y-4">
+        <h1 className="text-4xl font-bold">Control Plane Runtime</h1>
+        <p className="text-muted-foreground">
+          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>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Canonical execution loop</h2>
+        <ol className="text-muted-foreground list-inside list-decimal space-y-2">
+          <li>Accept intent and create execution identity + trace context.</li>
+          <li>Compile intent into a typed, deterministic plan DAG.</li>
+          <li>Verify plan against policy and risk rules.</li>
+          <li>Route into autonomous or assist mode based on verdict.</li>
+          <li>Execute steps with idempotent keys and explicit stage events.</li>
+          <li>Persist outcomes for replay, audits, and operator visibility.</li>
+        </ol>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Contract surfaces (v1 baseline)</h2>
+        <p className="text-muted-foreground">
+          The runtime is contract-first. Commands, queries, events, and
+          capabilities are explicit and versioned under
+          <code> @contractspec/lib.contracts-spec</code>.
+        </p>
+        <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`}
+        />
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Policy and safety posture</h2>
+        <ul className="text-muted-foreground list-inside list-disc space-y-2">
+          <li>
+            No side-effect action executes unless it comes from a compiled plan.
+          </li>
+          <li>High-risk actions are blocked from autonomous mode in v1.</li>
+          <li>
+            Approval commands provide explicit human-in-the-loop transitions.
+          </li>
+          <li>
+            Skill installation is modeled as governance-controlled operations.
+          </li>
+          <li>
+            Trace queries expose policy rationale and step outcomes for replay.
+          </li>
+        </ul>
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">Implementation map</h2>
+        <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`}
+        />
+      </div>
+
+      <div className="space-y-4">
+        <h2 className="text-2xl font-bold">What comes next</h2>
+        <p className="text-muted-foreground">
+          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>
+
+      <div className="flex items-center gap-4 pt-4">
+        <Link
+          href="/docs/architecture/integration-binding"
+          className="btn-ghost"
+        >
+          Previous: Integration Binding
+        </Link>
+        <Link href="/docs/safety/auditing" className="btn-primary">
+          Audit Logs <ChevronRight size={16} />
+        </Link>
+      </div>
+    </div>
+  );
+}

package/src/components/docs/architecture/ArchitectureOverviewPage.tsx

@@ -16,7 +16,7 @@ export function ArchitectureOverviewPage() {
           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.
+          control-plane governance, and knowledge management.
         </p>
       </div>
 
@@ -146,6 +146,15 @@ export function ArchitectureOverviewPage() {
                 <strong>Policy Decision Point (PDP)</strong> - Enforces policies
                 on every operation
               </li>
+              <li>
+                <Link
+                  href="/docs/architecture/control-plane"
+                  className="text-violet-400 hover:text-violet-300"
+                >
+                  Control Plane Runtime
+                </Link>{' '}
+                - Deterministic intent to plan to policy to execution loop
+              </li>
               <li>
                 <strong>Presentation Runtime</strong> - React and React Native
                 renderers
@@ -256,6 +265,9 @@ export function ArchitectureOverviewPage() {
         <Link href="/docs/architecture/app-config" className="btn-primary">
           App Configuration <ChevronRight size={16} />
         </Link>
+        <Link href="/docs/architecture/control-plane" className="btn-ghost">
+          Control Plane Runtime
+        </Link>
         <Link href="/docs/integrations" className="btn-ghost">
           Integrations
         </Link>

package/src/components/docs/architecture/index.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';

package/src/components/docs/ecosystem/IntegrationsPage.tsx

@@ -34,7 +34,8 @@ bun add -D @contractspec/lib.plugin.example-generator`}
         <ul className="text-muted-foreground space-y-2 text-sm">
           <li>Payments: Stripe</li>
           <li>Email: Postmark, Gmail</li>
-          <li>Voice: ElevenLabs</li>
+          <li>AI: OpenAI, Mistral</li>
+          <li>Voice: ElevenLabs, Mistral</li>
           <li>Vector DB: Qdrant</li>
           <li>Storage: GCS</li>
         </ul>
@@ -45,10 +46,10 @@ bun add -D @contractspec/lib.plugin.example-generator`}
 
       <div className="flex items-center gap-4 pt-4">
         <Link href="/docs/ecosystem/registry" className="btn-primary">
-          Registry resolution <ChevronRight size={16} />
+          Marketplace manifest <ChevronRight size={16} />
         </Link>
         <Link href="/docs/ecosystem/templates" className="btn-ghost">
-          Plugin templates
+          Authoring templates
         </Link>
       </div>
     </div>

package/src/components/docs/ecosystem/PluginsPage.tsx

@@ -6,128 +6,109 @@ export function EcosystemPluginsPage() {
   return (
     <div className="space-y-8">
       <div className="space-y-3">
-        <h1 className="text-4xl font-bold">Plugin API</h1>
+        <h1 className="text-4xl font-bold">Cursor marketplace plugins</h1>
         <p className="text-muted-foreground text-lg">
-          Extend ContractSpec with generators, validators, adapters, formatters,
-          and registry resolvers.
+          ContractSpec ships a focused Cursor marketplace catalog for the
+          product and key libraries.
         </p>
       </div>
 
       <div className="card-subtle space-y-4 p-6">
-        <h2 className="text-2xl font-bold">Core capabilities</h2>
+        <h2 className="text-2xl font-bold">Catalog at a glance</h2>
         <ul className="text-muted-foreground space-y-2 text-sm">
-          <li>Generators for code, docs, and schemas.</li>
-          <li>Validators for policy checks and compliance gates.</li>
-          <li>Adapters for framework and runtime integration.</li>
-          <li>Formatters and diff renderers for deterministic output.</li>
-          <li>Registry resolvers for local and remote plugin discovery.</li>
+          <li>
+            <code>contractspec</code> - Product-level workflow and release
+            guardrails.
+          </li>
+          <li>
+            <code>contractspec-contracts-spec</code> -
+            <code>@contractspec/lib.contracts-spec</code> governance.
+          </li>
+          <li>
+            <code>contractspec-contracts-integrations</code> -
+            <code>@contractspec/lib.contracts-integrations</code> governance.
+          </li>
+          <li>
+            <code>contractspec-ai-agent</code> -
+            <code>@contractspec/lib.ai-agent</code> orchestration guardrails.
+          </li>
         </ul>
       </div>
 
       <div className="space-y-6">
         <div className="space-y-3">
-          <h2 className="text-2xl font-bold">Plugin interface</h2>
+          <h2 className="text-2xl font-bold">Where plugin sources live</h2>
           <p className="text-muted-foreground text-sm">
-            Define capabilities and lifecycle hooks in a single plugin
-            entrypoint.
+            Marketplace plugin sources are kept in a dedicated package so they
+            can evolve with the monorepo safely.
           </p>
           <CodeBlock
-            language="typescript"
-            filename="plugin.ts"
-            code={`import type {
-  ContractSpecPlugin,
-  PluginContext,
-  GeneratorCapability,
-} from "@contractspec/lib.plugins";
-
-export const MarkdownGeneratorPlugin: ContractSpecPlugin = {
-  meta: {
-    id: "markdown-generator",
-    version: "1.0.0",
-    type: "generator",
-    provides: ["docs"],
-  },
-  register(context: PluginContext) {
-    const generator: GeneratorCapability = {
-      id: "markdown",
-      description: "Generate Markdown docs",
-      generate: async (specs) => {
-        // Implementation...
-      },
-    };
-
-    context.generators.register(generator);
-  },
-};`}
-          />
-        </div>
-
-        <div className="space-y-3">
-          <h2 className="text-2xl font-bold">Lifecycle hooks</h2>
-          <p className="text-muted-foreground text-sm">
-            Use lifecycle hooks to configure, validate, and dispose resources.
-          </p>
-          <CodeBlock
-            language="typescript"
-            filename="lifecycle.ts"
-            code={`export const MarkdownGeneratorPlugin: ContractSpecPlugin = {
-  meta: {
-    id: "markdown-generator",
-    version: "1.0.0",
-    type: "generator",
-    provides: ["docs"],
-  },
-  register(context) {
-    // Register capabilities
-  },
-  configure(options, context) {
-    // Optional: apply workspace configuration
-  },
-  validate(specs, context) {
-    // Optional: add validation checks
-  },
-  generate(specs, context) {
-    // Required: emit outputs
-  },
-  dispose() {
-    // Optional: cleanup
-  },
-};`}
+            language="text"
+            filename="catalog-layout"
+            code={`packages/apps-registry/cursor-marketplace/
+  plugins/
+    contractspec/
+    contractspec-contracts-spec/
+    contractspec-contracts-integrations/
+    contractspec-ai-agent/`}
           />
         </div>
 
         <div className="space-y-3">
-          <h2 className="text-2xl font-bold">Register a plugin</h2>
+          <h2 className="text-2xl font-bold">Root marketplace manifest</h2>
           <p className="text-muted-foreground text-sm">
-            Configure plugins in <code>.contractsrc.json</code> to load them in
-            the CLI and runtime.
+            Cursor submission reads <code>.cursor-plugin/marketplace.json</code>{' '}
+            at repository root and resolves each plugin source path.
           </p>
           <CodeBlock
             language="json"
-            filename=".contractsrc.json"
+            filename=".cursor-plugin/marketplace.json"
             code={`{
+  "name": "contractspec-marketplace",
   "plugins": [
     {
-      "id": "markdown-generator",
-      "package": "@contractspec/plugin.markdown",
-      "capabilities": ["generator"],
-      "options": {
-        "outputDir": "./docs/generated",
-        "format": "table"
-      }
+      "name": "contractspec",
+      "source": "packages/apps-registry/cursor-marketplace/plugins/contractspec"
+    },
+    {
+      "name": "contractspec-contracts-spec",
+      "source": "packages/apps-registry/cursor-marketplace/plugins/contractspec-contracts-spec"
+    },
+    {
+      "name": "contractspec-contracts-integrations",
+      "source": "packages/apps-registry/cursor-marketplace/plugins/contractspec-contracts-integrations"
+    },
+    {
+      "name": "contractspec-ai-agent",
+      "source": "packages/apps-registry/cursor-marketplace/plugins/contractspec-ai-agent"
     }
   ]
 }`}
           />
         </div>
+
+        <div className="space-y-3">
+          <h2 className="text-2xl font-bold">Validation gate</h2>
+          <p className="text-muted-foreground text-sm">
+            Validate all marketplace plugins before publishing.
+          </p>
+          <CodeBlock
+            language="bash"
+            filename="validate-marketplace"
+            code={`bun run plugin:contractspec:validate
+
+# Optional when offline
+SKIP_PLUGIN_NETWORK_CHECK=1 bun run plugin:contractspec:validate`}
+          />
+        </div>
       </div>
 
       <div className="flex items-center gap-4 pt-4">
         <Link href="/docs/ecosystem/templates" className="btn-primary">
-          Plugin templates <ChevronRight size={16} />
+          Author a plugin <ChevronRight size={16} />
         </Link>
-        <Link href="/docs/ecosystem/integrations" className="btn-ghost">
-          Integrations
+        <Link href="/docs/ecosystem/registry" className="btn-ghost">
+          Manifest details
         </Link>
       </div>
     </div>