@contractspec/bundle.library 2.9.1 → 3.0.0

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

@@ -59,7 +59,10 @@ bun add -D @contractspec/lib.plugin.example-generator`
                 children: "Email: Postmark, Gmail"
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV("li", {
-                children: "Voice: ElevenLabs"
+                children: "AI: OpenAI, Mistral"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV("li", {
+                children: "Voice: ElevenLabs, Mistral"
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV("li", {
                 children: "Vector DB: Qdrant"
@@ -82,7 +85,7 @@ bun add -D @contractspec/lib.plugin.example-generator`
             href: "/docs/ecosystem/registry",
             className: "btn-primary",
             children: [
-              "Registry resolution ",
+              "Marketplace manifest ",
               /* @__PURE__ */ jsxDEV(ChevronRight, {
                 size: 16
               }, undefined, false, undefined, this)
@@ -91,7 +94,7 @@ bun add -D @contractspec/lib.plugin.example-generator`
           /* @__PURE__ */ jsxDEV(Link, {
             href: "/docs/ecosystem/templates",
             className: "btn-ghost",
-            children: "Plugin templates"
+            children: "Authoring templates"
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this)
@@ -113,11 +116,11 @@ function EcosystemPluginsPage() {
         children: [
           /* @__PURE__ */ jsxDEV2("h1", {
             className: "text-4xl font-bold",
-            children: "Plugin API"
+            children: "Cursor marketplace plugins"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV2("p", {
             className: "text-muted-foreground text-lg",
-            children: "Extend ContractSpec with generators, validators, adapters, formatters, and registry resolvers."
+            children: "ContractSpec ships a focused Cursor marketplace catalog for the product and key libraries."
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this),
@@ -126,26 +129,55 @@ function EcosystemPluginsPage() {
         children: [
           /* @__PURE__ */ jsxDEV2("h2", {
             className: "text-2xl font-bold",
-            children: "Core capabilities"
+            children: "Catalog at a glance"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV2("ul", {
             className: "text-muted-foreground space-y-2 text-sm",
             children: [
               /* @__PURE__ */ jsxDEV2("li", {
-                children: "Generators for code, docs, and schemas."
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV2("li", {
-                children: "Validators for policy checks and compliance gates."
-              }, undefined, false, undefined, this),
+                children: [
+                  /* @__PURE__ */ jsxDEV2("code", {
+                    children: "contractspec"
+                  }, undefined, false, undefined, this),
+                  " - Product-level workflow and release guardrails."
+                ]
+              }, undefined, true, undefined, this),
               /* @__PURE__ */ jsxDEV2("li", {
-                children: "Adapters for framework and runtime integration."
-              }, undefined, false, undefined, this),
+                children: [
+                  /* @__PURE__ */ jsxDEV2("code", {
+                    children: "contractspec-contracts-spec"
+                  }, undefined, false, undefined, this),
+                  " -",
+                  /* @__PURE__ */ jsxDEV2("code", {
+                    children: "@contractspec/lib.contracts-spec"
+                  }, undefined, false, undefined, this),
+                  " governance."
+                ]
+              }, undefined, true, undefined, this),
               /* @__PURE__ */ jsxDEV2("li", {
-                children: "Formatters and diff renderers for deterministic output."
-              }, undefined, false, undefined, this),
+                children: [
+                  /* @__PURE__ */ jsxDEV2("code", {
+                    children: "contractspec-contracts-integrations"
+                  }, undefined, false, undefined, this),
+                  " -",
+                  /* @__PURE__ */ jsxDEV2("code", {
+                    children: "@contractspec/lib.contracts-integrations"
+                  }, undefined, false, undefined, this),
+                  " governance."
+                ]
+              }, undefined, true, undefined, this),
               /* @__PURE__ */ jsxDEV2("li", {
-                children: "Registry resolvers for local and remote plugin discovery."
-              }, undefined, false, undefined, this)
+                children: [
+                  /* @__PURE__ */ jsxDEV2("code", {
+                    children: "contractspec-ai-agent"
+                  }, undefined, false, undefined, this),
+                  " -",
+                  /* @__PURE__ */ jsxDEV2("code", {
+                    children: "@contractspec/lib.ai-agent"
+                  }, undefined, false, undefined, this),
+                  " orchestration guardrails."
+                ]
+              }, undefined, true, undefined, this)
             ]
           }, undefined, true, undefined, this)
         ]
@@ -158,80 +190,21 @@ function EcosystemPluginsPage() {
             children: [
               /* @__PURE__ */ jsxDEV2("h2", {
                 className: "text-2xl font-bold",
-                children: "Plugin interface"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV2("p", {
-                className: "text-muted-foreground text-sm",
-                children: "Define capabilities and lifecycle hooks in a single plugin entrypoint."
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV2(CodeBlock2, {
-                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);
-  },
-};`
-              }, undefined, false, undefined, this)
-            ]
-          }, undefined, true, undefined, this),
-          /* @__PURE__ */ jsxDEV2("div", {
-            className: "space-y-3",
-            children: [
-              /* @__PURE__ */ jsxDEV2("h2", {
-                className: "text-2xl font-bold",
-                children: "Lifecycle hooks"
+                children: "Where plugin sources live"
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV2("p", {
                 className: "text-muted-foreground text-sm",
-                children: "Use lifecycle hooks to configure, validate, and dispose resources."
+                children: "Marketplace plugin sources are kept in a dedicated package so they can evolve with the monorepo safely."
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV2(CodeBlock2, {
-                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/`
               }, undefined, false, undefined, this)
             ]
           }, undefined, true, undefined, this),
@@ -240,36 +213,66 @@ export const MarkdownGeneratorPlugin: ContractSpecPlugin = {
             children: [
               /* @__PURE__ */ jsxDEV2("h2", {
                 className: "text-2xl font-bold",
-                children: "Register a plugin"
+                children: "Root marketplace manifest"
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV2("p", {
                 className: "text-muted-foreground text-sm",
                 children: [
-                  "Configure plugins in ",
+                  "Cursor submission reads ",
                   /* @__PURE__ */ jsxDEV2("code", {
-                    children: ".contractsrc.json"
+                    children: ".cursor-plugin/marketplace.json"
                   }, undefined, false, undefined, this),
-                  " to load them in the CLI and runtime."
+                  " ",
+                  "at repository root and resolves each plugin source path."
                 ]
               }, undefined, true, undefined, this),
               /* @__PURE__ */ jsxDEV2(CodeBlock2, {
                 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"
     }
   ]
 }`
               }, undefined, false, undefined, this)
             ]
+          }, undefined, true, undefined, this),
+          /* @__PURE__ */ jsxDEV2("div", {
+            className: "space-y-3",
+            children: [
+              /* @__PURE__ */ jsxDEV2("h2", {
+                className: "text-2xl font-bold",
+                children: "Validation gate"
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2("p", {
+                className: "text-muted-foreground text-sm",
+                children: "Validate all marketplace plugins before publishing."
+              }, undefined, false, undefined, this),
+              /* @__PURE__ */ jsxDEV2(CodeBlock2, {
+                language: "bash",
+                filename: "validate-marketplace",
+                code: `bun run plugin:contractspec:validate
+
+# Optional when offline
+SKIP_PLUGIN_NETWORK_CHECK=1 bun run plugin:contractspec:validate`
+              }, undefined, false, undefined, this)
+            ]
           }, undefined, true, undefined, this)
         ]
       }, undefined, true, undefined, this),
@@ -280,16 +283,16 @@ export const MarkdownGeneratorPlugin: ContractSpecPlugin = {
             href: "/docs/ecosystem/templates",
             className: "btn-primary",
             children: [
-              "Plugin templates ",
+              "Author a plugin ",
               /* @__PURE__ */ jsxDEV2(ChevronRight2, {
                 size: 16
               }, undefined, false, undefined, this)
             ]
           }, undefined, true, undefined, this),
           /* @__PURE__ */ jsxDEV2(Link2, {
-            href: "/docs/ecosystem/integrations",
+            href: "/docs/ecosystem/registry",
             className: "btn-ghost",
-            children: "Integrations"
+            children: "Manifest details"
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this)
@@ -311,11 +314,11 @@ function EcosystemRegistryPage() {
         children: [
           /* @__PURE__ */ jsxDEV3("h1", {
             className: "text-4xl font-bold",
-            children: "Registry resolution"
+            children: "Marketplace manifest"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV3("p", {
             className: "text-muted-foreground text-lg",
-            children: "Resolve plugins from local workspaces, npm packages, or remote registries."
+            children: "ContractSpec publishes a multi-plugin Cursor marketplace catalog from a single root manifest."
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this),
@@ -324,34 +327,33 @@ function EcosystemRegistryPage() {
         children: [
           /* @__PURE__ */ jsxDEV3("h2", {
             className: "text-2xl font-bold",
-            children: "Resolution order"
+            children: "Root manifest shape"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV3("p", {
             className: "text-muted-foreground text-sm",
-            children: "Control where ContractSpec loads plugins and how versions are resolved."
-          }, undefined, false, undefined, this),
+            children: [
+              "Cursor reads ",
+              /* @__PURE__ */ jsxDEV3("code", {
+                children: ".cursor-plugin/marketplace.json"
+              }, undefined, false, undefined, this),
+              " at repository root and resolves each plugin source path."
+            ]
+          }, undefined, true, undefined, this),
           /* @__PURE__ */ jsxDEV3(CodeBlock3, {
             language: "json",
-            filename: ".contractsrc.json",
+            filename: ".cursor-plugin/marketplace.json",
             code: `{
+  "name": "contractspec-marketplace",
   "plugins": [
     {
-      "id": "markdown-generator",
-      "package": "@contractspec/plugin.markdown-generator",
-      "capabilities": ["generator"],
-      "options": {
-        "outputDir": "./docs/generated",
-        "format": "table"
-      }
-    }
-  ],
-  "pluginRegistry": {
-    "resolutionOrder": ["workspace", "npm", "remote"],
-    "allowPrerelease": false,
-    "sources": {
-      "remote": "https://registry.contractspec.io"
+      "name": "contractspec",
+      "source": "packages/apps-registry/cursor-marketplace/plugins/contractspec"
+    },
+    {
+      "name": "contractspec-contracts-spec",
+      "source": "packages/apps-registry/cursor-marketplace/plugins/contractspec-contracts-spec"
     }
-  }
+  ]
 }`
           }, undefined, false, undefined, this)
         ]
@@ -361,32 +363,30 @@ function EcosystemRegistryPage() {
         children: [
           /* @__PURE__ */ jsxDEV3("h2", {
             className: "text-2xl font-bold",
-            children: "Custom registry resolvers"
+            children: "Per-plugin contract"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV3("p", {
             className: "text-muted-foreground text-sm",
-            children: "Register resolver plugins to load plugins from private registries."
+            children: "Each plugin source must include a Cursor plugin manifest and composable assets."
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV3(CodeBlock3, {
-            language: "typescript",
-            filename: "registry-resolver.ts",
-            code: `import type { RegistryResolverPlugin } from "@contractspec/lib.plugins";
+            language: "text",
+            filename: "plugin-layout",
+            code: `plugins/<plugin-name>/
+  .cursor-plugin/plugin.json
+  rules/
+  commands/
+  agents/
+  skills/
+  .mcp.json`
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV3(CodeBlock3, {
+            language: "bash",
+            filename: "validate-catalog",
+            code: `bun run plugin:contractspec:validate
 
-export const PrivateRegistryResolver: RegistryResolverPlugin = {
-  meta: {
-    id: "private-registry",
-    version: "1.0.0",
-    type: "registryResolver",
-    provides: ["private-registry"],
-  },
-  resolve: async (request) => {
-    // Fetch plugin package metadata from private registry
-    const result = await fetch(
-      "https://registry.acme.io/" + request.package
-    );
-    return result.json();
-  },
-};`
+# Optional in offline environments
+SKIP_PLUGIN_NETWORK_CHECK=1 bun run plugin:contractspec:validate`
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this),
@@ -406,7 +406,7 @@ export const PrivateRegistryResolver: RegistryResolverPlugin = {
           /* @__PURE__ */ jsxDEV3(Link3, {
             href: "/docs/ecosystem/templates",
             className: "btn-ghost",
-            children: "Plugin templates"
+            children: "Plugin authoring templates"
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this)
@@ -457,11 +457,11 @@ function EcosystemTemplatesPage() {
         children: [
           /* @__PURE__ */ jsxDEV5("h1", {
             className: "text-4xl font-bold",
-            children: "Plugin templates"
+            children: "Plugin authoring templates"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV5("p", {
             className: "text-muted-foreground text-lg",
-            children: "Scaffold new plugins with create-contractspec-plugin."
+            children: "Scaffold focused Cursor plugins for ContractSpec product and core libraries."
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this),
@@ -470,19 +470,24 @@ function EcosystemTemplatesPage() {
         children: [
           /* @__PURE__ */ jsxDEV5("h2", {
             className: "text-2xl font-bold",
-            children: "Create a new plugin"
+            children: "Create a focused plugin"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV5("p", {
             className: "text-muted-foreground text-sm",
-            children: "Generate a plugin scaffold with tests, documentation, and CI wiring."
+            children: "Start from a scoped domain and keep each plugin aligned to one product or library surface."
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV5(CodeBlock4, {
             language: "bash",
-            filename: "create-plugin",
-            code: `bunx create-contractspec-plugin create \\
-  --name markdown-generator \\
-  --description "Markdown docs generator" \\
-  --author "Your name"`
+            filename: "catalog-authoring-layout",
+            code: `packages/apps-registry/cursor-marketplace/
+  plugins/
+    <plugin-name>/
+      .cursor-plugin/plugin.json
+      rules/
+      commands/
+      agents/
+      skills/
+      .mcp.json`
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this),
@@ -497,16 +502,16 @@ function EcosystemTemplatesPage() {
             className: "text-muted-foreground space-y-2 text-sm",
             children: [
               /* @__PURE__ */ jsxDEV5("li", {
-                children: "src/generator.ts, src/types.ts, src/config.ts"
+                children: ".cursor-plugin/plugin.json with plugin metadata and paths"
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV5("li", {
-                children: "tests/ with sample fixtures"
+                children: "rules/, commands/, agents/, and skills/ content directories"
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV5("li", {
-                children: ".github/workflows/ci.yml"
+                children: ".mcp.json with all MCP server declarations used by the plugin"
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV5("li", {
-                children: "README.md with usage instructions"
+                children: "README.md describing scope and governance boundaries"
               }, undefined, false, undefined, this)
             ]
           }, undefined, true, undefined, this)
@@ -517,16 +522,16 @@ function EcosystemTemplatesPage() {
         children: [
           /* @__PURE__ */ jsxDEV5("h2", {
             className: "text-2xl font-bold",
-            children: "Publish and install"
+            children: "Validate before submission"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV5(CodeBlock4, {
             language: "bash",
-            filename: "publish-plugin",
-            code: `bun run build
-bun publish
+            filename: "validate-marketplace-catalog",
+            code: `# Validate all plugins referenced by root marketplace manifest
+bun run plugin:contractspec:validate
 
-# install in a ContractSpec workspace
-bun add @contractspec/integration.markdown-generator`
+# Optional in offline environments
+SKIP_PLUGIN_NETWORK_CHECK=1 bun run plugin:contractspec:validate`
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this),
@@ -541,7 +546,7 @@ bun add @contractspec/integration.markdown-generator`
             href: "/docs/ecosystem/plugins",
             className: "btn-primary",
             children: [
-              "Plugin API ",
+              "Marketplace plugins ",
               /* @__PURE__ */ jsxDEV5(ChevronRight4, {
                 size: 16
               }, undefined, false, undefined, this)
@@ -550,7 +555,7 @@ bun add @contractspec/integration.markdown-generator`
           /* @__PURE__ */ jsxDEV5(Link5, {
             href: "/docs/ecosystem/registry",
             className: "btn-ghost",
-            children: "Registry resolution"
+            children: "Marketplace manifest"
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this)
@@ -563,15 +568,15 @@ import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
 var ecosystemDocBlocks = [
   {
     id: "docs.ecosystem.plugins",
-    title: "Plugin API",
-    summary: "Build generators, validators, adapters, and registry resolvers.",
+    title: "Marketplace plugins",
+    summary: "Focused Cursor marketplace plugins for product and core libraries.",
     kind: "usage",
     visibility: "public",
     route: "/docs/ecosystem/plugins",
     tags: ["ecosystem", "plugins", "extensions"],
-    body: `# Plugin API
+    body: `# Marketplace plugins
 
-ContractSpec plugins extend the platform with generators, validators, adapters, formatters, and registry resolvers. Define capabilities in code, register them through configuration, and ship reusable packages.`
+ContractSpec ships a focused Cursor marketplace catalog with plugins for the product and key libraries. Plugin sources live in \`packages/apps-registry/cursor-marketplace/plugins/*\`, while the root manifest at \`.cursor-plugin/marketplace.json\` drives submission.`
   },
   {
     id: "docs.ecosystem.integrations",
@@ -587,23 +592,23 @@ Reference integrations demonstrate how to extend ContractSpec with real-world pl
   },
   {
     id: "docs.ecosystem.templates",
-    title: "Plugin templates",
-    summary: "Scaffold new plugins with create-contractspec-plugin.",
+    title: "Plugin authoring templates",
+    summary: "Author focused plugins with a consistent marketplace-ready layout.",
     kind: "usage",
     visibility: "public",
     route: "/docs/ecosystem/templates",
     tags: ["ecosystem", "templates"],
-    body: "# Plugin templates\n\nUse `create-contractspec-plugin` to scaffold a new plugin package with tests, documentation, and CI wiring."
+    body: "# Plugin authoring templates\n\nCreate each plugin under `packages/apps-registry/cursor-marketplace/plugins/<plugin-name>/` and include `.cursor-plugin/plugin.json`, `rules/`, `commands/`, `agents/`, `skills/`, and `.mcp.json`."
   },
   {
     id: "docs.ecosystem.registry",
-    title: "Registry resolution",
-    summary: "Discover plugins locally or from remote registries.",
+    title: "Marketplace manifest",
+    summary: "Manage and validate root marketplace entries for all plugins.",
     kind: "usage",
     visibility: "public",
     route: "/docs/ecosystem/registry",
     tags: ["ecosystem", "registry"],
-    body: "# Registry resolution\n\nPlugins can be resolved from local workspaces, npm packages, or remote registries. Configure resolution order in `.contractsrc.json` and use registry resolver plugins for custom sources."
+    body: "# Marketplace manifest\n\nKeep all plugin entries in `.cursor-plugin/marketplace.json` and validate them with `bun run plugin:contractspec:validate` before submission."
   }
 ];
 registerDocBlocks(ecosystemDocBlocks);