@contractspec/bundle.library 2.9.0 → 3.0.0

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

@@ -6,70 +6,62 @@ export function EcosystemRegistryPage() {
   return (
     <div className="space-y-8">
       <div className="space-y-3">
-        <h1 className="text-4xl font-bold">Registry resolution</h1>
+        <h1 className="text-4xl font-bold">Marketplace manifest</h1>
         <p className="text-muted-foreground text-lg">
-          Resolve plugins from local workspaces, npm packages, or remote
-          registries.
+          ContractSpec publishes a multi-plugin Cursor marketplace catalog from
+          a single root manifest.
         </p>
       </div>
 
       <div className="card-subtle space-y-4 p-6">
-        <h2 className="text-2xl font-bold">Resolution order</h2>
+        <h2 className="text-2xl font-bold">Root manifest shape</h2>
         <p className="text-muted-foreground text-sm">
-          Control where ContractSpec loads plugins and how versions are
-          resolved.
+          Cursor 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-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"
     }
-  }
+  ]
 }`}
         />
       </div>
 
       <div className="card-subtle space-y-4 p-6">
-        <h2 className="text-2xl font-bold">Custom registry resolvers</h2>
+        <h2 className="text-2xl font-bold">Per-plugin contract</h2>
         <p className="text-muted-foreground text-sm">
-          Register resolver plugins to load plugins from private registries.
+          Each plugin source must include a Cursor plugin manifest and
+          composable assets.
         </p>
         <CodeBlock
-          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`}
+        />
+        <CodeBlock
+          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`}
         />
       </div>
 
@@ -78,7 +70,7 @@ export const PrivateRegistryResolver: RegistryResolverPlugin = {
           Integrations <ChevronRight size={16} />
         </Link>
         <Link href="/docs/ecosystem/templates" className="btn-ghost">
-          Plugin templates
+          Plugin authoring templates
         </Link>
       </div>
     </div>

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

@@ -7,47 +7,54 @@ export function EcosystemTemplatesPage() {
   return (
     <div className="space-y-8">
       <div className="space-y-3">
-        <h1 className="text-4xl font-bold">Plugin templates</h1>
+        <h1 className="text-4xl font-bold">Plugin authoring templates</h1>
         <p className="text-muted-foreground text-lg">
-          Scaffold new plugins with create-contractspec-plugin.
+          Scaffold focused Cursor plugins for ContractSpec product and core
+          libraries.
         </p>
       </div>
 
       <div className="card-subtle space-y-4 p-6">
-        <h2 className="text-2xl font-bold">Create a new plugin</h2>
+        <h2 className="text-2xl font-bold">Create a focused plugin</h2>
         <p className="text-muted-foreground text-sm">
-          Generate a plugin scaffold with tests, documentation, and CI wiring.
+          Start from a scoped domain and keep each plugin aligned to one product
+          or library surface.
         </p>
         <CodeBlock
           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`}
         />
       </div>
 
       <div className="card-subtle space-y-4 p-6">
         <h2 className="text-2xl font-bold">Template outputs</h2>
         <ul className="text-muted-foreground space-y-2 text-sm">
-          <li>src/generator.ts, src/types.ts, src/config.ts</li>
-          <li>tests/ with sample fixtures</li>
-          <li>.github/workflows/ci.yml</li>
-          <li>README.md with usage instructions</li>
+          <li>.cursor-plugin/plugin.json with plugin metadata and paths</li>
+          <li>rules/, commands/, agents/, and skills/ content directories</li>
+          <li>.mcp.json with all MCP server declarations used by the plugin</li>
+          <li>README.md describing scope and governance boundaries</li>
         </ul>
       </div>
 
       <div className="card-subtle space-y-4 p-6">
-        <h2 className="text-2xl font-bold">Publish and install</h2>
+        <h2 className="text-2xl font-bold">Validate before submission</h2>
         <CodeBlock
           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`}
         />
       </div>
 
@@ -58,10 +65,10 @@ bun add @contractspec/integration.markdown-generator`}
 
       <div className="flex items-center gap-4 pt-4">
         <Link href="/docs/ecosystem/plugins" className="btn-primary">
-          Plugin API <ChevronRight size={16} />
+          Marketplace plugins <ChevronRight size={16} />
         </Link>
         <Link href="/docs/ecosystem/registry" className="btn-ghost">
-          Registry resolution
+          Marketplace manifest
         </Link>
       </div>
     </div>

package/src/components/docs/ecosystem/ecosystem.docblocks.ts

@@ -4,15 +4,16 @@ import { registerDocBlocks } from '@contractspec/lib.contracts-spec/docs';
 const ecosystemDocBlocks: DocBlock[] = [
   {
     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',
@@ -28,24 +29,25 @@ 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.',
   },
 ];
 

package/src/components/docs/generated/docs-index._common.json

@@ -23,6 +23,246 @@
     "source": "generated",
     "contentPath": "_common/contractspec.presentations.md"
   },
+  {
+    "id": "_common/control-plane.approval",
+    "title": "control-plane.approval",
+    "summary": "Human approval and rejection gates for execution steps.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: approval\n- **File**: `packages/libs/contracts-spec/src/control-plane/capabilities/controlPlaneApproval.capability.ts`",
+    "route": "/docs/reference/_common/control-plane.approval",
+    "source": "generated",
+    "contentPath": "_common/control-plane.approval.md"
+  },
+  {
+    "id": "_common/control-plane.audit",
+    "title": "control-plane.audit",
+    "summary": "Trace, policy explanation, and replay-grade observability.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: audit\n- **File**: `packages/libs/contracts-spec/src/control-plane/capabilities/controlPlaneAudit.capability.ts`",
+    "route": "/docs/reference/_common/control-plane.audit",
+    "source": "generated",
+    "contentPath": "_common/control-plane.audit.md"
+  },
+  {
+    "id": "_common/control-plane.channel-runtime",
+    "title": "control-plane.channel-runtime",
+    "summary": "Channel-facing runtime surfaces for controlled execution.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: channels\n- **File**: `packages/libs/contracts-spec/src/control-plane/capabilities/controlPlaneChannelRuntime.capability.ts`",
+    "route": "/docs/reference/_common/control-plane.channel-runtime",
+    "source": "generated",
+    "contentPath": "_common/control-plane.channel-runtime.md"
+  },
+  {
+    "id": "_common/control-plane.core",
+    "title": "control-plane.core",
+    "summary": "Core intent, planning, and execution surfaces.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: core\n- **File**: `packages/libs/contracts-spec/src/control-plane/capabilities/controlPlaneCore.capability.ts`",
+    "route": "/docs/reference/_common/control-plane.core",
+    "source": "generated",
+    "contentPath": "_common/control-plane.core.md"
+  },
+  {
+    "id": "_common/control-plane.skill-registry",
+    "title": "control-plane.skill-registry",
+    "summary": "Signed skill lifecycle and compatibility governance.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: skills\n- **File**: `packages/libs/contracts-spec/src/control-plane/capabilities/controlPlaneSkillRegistry.capability.ts`",
+    "route": "/docs/reference/_common/control-plane.skill-registry",
+    "source": "generated",
+    "contentPath": "_common/control-plane.skill-registry.md"
+  },
+  {
+    "id": "_common/controlPlane.execution.approve",
+    "title": "controlPlane.execution.approve",
+    "summary": "Approve a pending execution step for continuation.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: approval\n- **File**: `packages/libs/contracts-spec/src/control-plane/commands/controlPlaneExecutionApprove.command.ts`",
+    "route": "/docs/reference/_common/controlPlane.execution.approve",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.execution.approve.md"
+  },
+  {
+    "id": "_common/controlPlane.execution.cancel",
+    "title": "controlPlane.execution.cancel",
+    "summary": "Cancel an execution run and transition to terminal state.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: execution, approval\n- **File**: `packages/libs/contracts-spec/src/control-plane/commands/controlPlaneExecutionCancel.command.ts`",
+    "route": "/docs/reference/_common/controlPlane.execution.cancel",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.execution.cancel.md"
+  },
+  {
+    "id": "_common/controlPlane.execution.completed",
+    "title": "controlPlane.execution.completed",
+    "summary": "Emitted when an execution run finishes successfully.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: execution\n- **File**: `packages/libs/contracts-spec/src/control-plane/events/controlPlaneExecutionCompleted.event.ts`",
+    "route": "/docs/reference/_common/controlPlane.execution.completed",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.execution.completed.md"
+  },
+  {
+    "id": "_common/controlPlane.execution.failed",
+    "title": "controlPlane.execution.failed",
+    "summary": "Emitted when an execution run fails.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: execution, failure\n- **File**: `packages/libs/contracts-spec/src/control-plane/events/controlPlaneExecutionFailed.event.ts`",
+    "route": "/docs/reference/_common/controlPlane.execution.failed",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.execution.failed.md"
+  },
+  {
+    "id": "_common/controlPlane.execution.get",
+    "title": "controlPlane.execution.get",
+    "summary": "Fetch the latest state for one execution.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: execution\n- **File**: `packages/libs/contracts-spec/src/control-plane/queries/controlPlaneExecutionGet.query.ts`",
+    "route": "/docs/reference/_common/controlPlane.execution.get",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.execution.get.md"
+  },
+  {
+    "id": "_common/controlPlane.execution.list",
+    "title": "controlPlane.execution.list",
+    "summary": "List execution runs with filtering and pagination.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: execution\n- **File**: `packages/libs/contracts-spec/src/control-plane/queries/controlPlaneExecutionList.query.ts`",
+    "route": "/docs/reference/_common/controlPlane.execution.list",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.execution.list.md"
+  },
+  {
+    "id": "_common/controlPlane.execution.reject",
+    "title": "controlPlane.execution.reject",
+    "summary": "Reject a pending execution step.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: approval\n- **File**: `packages/libs/contracts-spec/src/control-plane/commands/controlPlaneExecutionReject.command.ts`",
+    "route": "/docs/reference/_common/controlPlane.execution.reject",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.execution.reject.md"
+  },
+  {
+    "id": "_common/controlPlane.execution.start",
+    "title": "controlPlane.execution.start",
+    "summary": "Start executing an approved compiled plan.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: execution\n- **File**: `packages/libs/contracts-spec/src/control-plane/commands/controlPlaneExecutionStart.command.ts`",
+    "route": "/docs/reference/_common/controlPlane.execution.start",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.execution.start.md"
+  },
+  {
+    "id": "_common/controlPlane.execution.step.blocked",
+    "title": "controlPlane.execution.step.blocked",
+    "summary": "Emitted when policy blocks an execution step.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: execution, blocked\n- **File**: `packages/libs/contracts-spec/src/control-plane/events/controlPlaneExecutionStepBlocked.event.ts`",
+    "route": "/docs/reference/_common/controlPlane.execution.step.blocked",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.execution.step.blocked.md"
+  },
+  {
+    "id": "_common/controlPlane.execution.step.completed",
+    "title": "controlPlane.execution.step.completed",
+    "summary": "Emitted when an execution step completes.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: execution\n- **File**: `packages/libs/contracts-spec/src/control-plane/events/controlPlaneExecutionStepCompleted.event.ts`",
+    "route": "/docs/reference/_common/controlPlane.execution.step.completed",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.execution.step.completed.md"
+  },
+  {
+    "id": "_common/controlPlane.execution.step.started",
+    "title": "controlPlane.execution.step.started",
+    "summary": "Emitted when an execution step starts.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: execution\n- **File**: `packages/libs/contracts-spec/src/control-plane/events/controlPlaneExecutionStepStarted.event.ts`",
+    "route": "/docs/reference/_common/controlPlane.execution.step.started",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.execution.step.started.md"
+  },
+  {
+    "id": "_common/controlPlane.intent.received",
+    "title": "controlPlane.intent.received",
+    "summary": "Emitted when a new control plane intent is accepted.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: intent\n- **File**: `packages/libs/contracts-spec/src/control-plane/events/controlPlaneIntentReceived.event.ts`",
+    "route": "/docs/reference/_common/controlPlane.intent.received",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.intent.received.md"
+  },
+  {
+    "id": "_common/controlPlane.intent.submit",
+    "title": "controlPlane.intent.submit",
+    "summary": "Submit a natural-language intent to the control plane.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: intent\n- **File**: `packages/libs/contracts-spec/src/control-plane/commands/controlPlaneIntentSubmit.command.ts`",
+    "route": "/docs/reference/_common/controlPlane.intent.submit",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.intent.submit.md"
+  },
+  {
+    "id": "_common/controlPlane.plan.compile",
+    "title": "controlPlane.plan.compile",
+    "summary": "Compile an intent into a deterministic plan DAG.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: plan\n- **File**: `packages/libs/contracts-spec/src/control-plane/commands/controlPlanePlanCompile.command.ts`",
+    "route": "/docs/reference/_common/controlPlane.plan.compile",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.plan.compile.md"
+  },
+  {
+    "id": "_common/controlPlane.plan.compiled",
+    "title": "controlPlane.plan.compiled",
+    "summary": "Emitted when an intent is compiled into an executable plan.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: plan\n- **File**: `packages/libs/contracts-spec/src/control-plane/events/controlPlanePlanCompiled.event.ts`",
+    "route": "/docs/reference/_common/controlPlane.plan.compiled",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.plan.compiled.md"
+  },
+  {
+    "id": "_common/controlPlane.plan.rejected",
+    "title": "controlPlane.plan.rejected",
+    "summary": "Emitted when a plan fails verification or governance checks.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: plan, governance\n- **File**: `packages/libs/contracts-spec/src/control-plane/events/controlPlanePlanRejected.event.ts`",
+    "route": "/docs/reference/_common/controlPlane.plan.rejected",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.plan.rejected.md"
+  },
+  {
+    "id": "_common/controlPlane.plan.verify",
+    "title": "controlPlane.plan.verify",
+    "summary": "Run policy and risk validation against a compiled plan.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: plan, governance\n- **File**: `packages/libs/contracts-spec/src/control-plane/commands/controlPlanePlanVerify.command.ts`",
+    "route": "/docs/reference/_common/controlPlane.plan.verify",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.plan.verify.md"
+  },
+  {
+    "id": "_common/controlPlane.policy.explain",
+    "title": "controlPlane.policy.explain",
+    "summary": "Explain policy outcomes for an execution or step.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: policy, audit\n- **File**: `packages/libs/contracts-spec/src/control-plane/queries/controlPlanePolicyExplain.query.ts`",
+    "route": "/docs/reference/_common/controlPlane.policy.explain",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.policy.explain.md"
+  },
+  {
+    "id": "_common/controlPlane.skill.disable",
+    "title": "controlPlane.skill.disable",
+    "summary": "Disable an installed skill in the control plane registry.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: skills, governance\n- **File**: `packages/libs/contracts-spec/src/control-plane/commands/controlPlaneSkillDisable.command.ts`",
+    "route": "/docs/reference/_common/controlPlane.skill.disable",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.skill.disable.md"
+  },
+  {
+    "id": "_common/controlPlane.skill.install",
+    "title": "controlPlane.skill.install",
+    "summary": "Install a signed skill artifact after verification checks.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: skills\n- **File**: `packages/libs/contracts-spec/src/control-plane/commands/controlPlaneSkillInstall.command.ts`",
+    "route": "/docs/reference/_common/controlPlane.skill.install",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.skill.install.md"
+  },
+  {
+    "id": "_common/controlPlane.skill.installed",
+    "title": "controlPlane.skill.installed",
+    "summary": "Emitted when a skill artifact is verified and installed.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: skills\n- **File**: `packages/libs/contracts-spec/src/control-plane/events/controlPlaneSkillInstalled.event.ts`",
+    "route": "/docs/reference/_common/controlPlane.skill.installed",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.skill.installed.md"
+  },
+  {
+    "id": "_common/controlPlane.skill.list",
+    "title": "controlPlane.skill.list",
+    "summary": "List installed and available skill artifacts.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: skills\n- **File**: `packages/libs/contracts-spec/src/control-plane/queries/controlPlaneSkillList.query.ts`",
+    "route": "/docs/reference/_common/controlPlane.skill.list",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.skill.list.md"
+  },
+  {
+    "id": "_common/controlPlane.skill.rejected",
+    "title": "controlPlane.skill.rejected",
+    "summary": "Emitted when a skill install attempt is rejected.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: skills, governance\n- **File**: `packages/libs/contracts-spec/src/control-plane/events/controlPlaneSkillRejected.event.ts`",
+    "route": "/docs/reference/_common/controlPlane.skill.rejected",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.skill.rejected.md"
+  },
+  {
+    "id": "_common/controlPlane.skill.verify",
+    "title": "controlPlane.skill.verify",
+    "summary": "Verify skill signature and compatibility constraints.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: skills, governance\n- **File**: `packages/libs/contracts-spec/src/control-plane/queries/controlPlaneSkillVerify.query.ts`",
+    "route": "/docs/reference/_common/controlPlane.skill.verify",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.skill.verify.md"
+  },
+  {
+    "id": "_common/controlPlane.trace.get",
+    "title": "controlPlane.trace.get",
+    "summary": "Return the replayable trace timeline for one execution.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: trace, audit\n- **File**: `packages/libs/contracts-spec/src/control-plane/queries/controlPlaneTraceGet.query.ts`",
+    "route": "/docs/reference/_common/controlPlane.trace.get",
+    "source": "generated",
+    "contentPath": "_common/controlPlane.trace.get.md"
+  },
   {
     "id": "_common/docs.contract.reference",
     "title": "docs.contract.reference",

package/src/components/docs/generated/docs-index.health.json

@@ -0,0 +1,98 @@
+[
+  {
+    "id": "health/health",
+    "title": "health",
+    "summary": "Unified health and wearable data sync for activities, workouts, sleep, biometrics, nutrition, and webhooks.\n- **Type**: feature\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations",
+    "route": "/docs/reference/health/health",
+    "source": "generated",
+    "contentPath": "health/health.md"
+  },
+  {
+    "id": "health/health.activities.list",
+    "title": "health.activities.list",
+    "summary": "List normalized activity entries synced from health integrations.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations\n- **Tags**: health, activities, wearables",
+    "route": "/docs/reference/health/health.activities.list",
+    "source": "generated",
+    "contentPath": "health/health.activities.list.md"
+  },
+  {
+    "id": "health/health.activities.sync",
+    "title": "health.activities.sync",
+    "summary": "Synchronize activity entries from the configured health provider.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations\n- **Tags**: health, activities, wearables",
+    "route": "/docs/reference/health/health.activities.sync",
+    "source": "generated",
+    "contentPath": "health/health.activities.sync.md"
+  },
+  {
+    "id": "health/health.biometrics.list",
+    "title": "health.biometrics.list",
+    "summary": "List normalized biometrics synced from connected health providers.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations\n- **Tags**: health, biometrics, wearables",
+    "route": "/docs/reference/health/health.biometrics.list",
+    "source": "generated",
+    "contentPath": "health/health.biometrics.list.md"
+  },
+  {
+    "id": "health/health.biometrics.sync",
+    "title": "health.biometrics.sync",
+    "summary": "Synchronize biometric datapoints from provider sources.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations\n- **Tags**: health, biometrics, wearables",
+    "route": "/docs/reference/health/health.biometrics.sync",
+    "source": "generated",
+    "contentPath": "health/health.biometrics.sync.md"
+  },
+  {
+    "id": "health/health.nutrition.list",
+    "title": "health.nutrition.list",
+    "summary": "List normalized nutrition and hydration records from connected providers.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations\n- **Tags**: health, nutrition, wearables",
+    "route": "/docs/reference/health/health.nutrition.list",
+    "source": "generated",
+    "contentPath": "health/health.nutrition.list.md"
+  },
+  {
+    "id": "health/health.nutrition.sync",
+    "title": "health.nutrition.sync",
+    "summary": "Synchronize nutrition records from provider sources.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations\n- **Tags**: health, nutrition, wearables",
+    "route": "/docs/reference/health/health.nutrition.sync",
+    "source": "generated",
+    "contentPath": "health/health.nutrition.sync.md"
+  },
+  {
+    "id": "health/health.sleep.list",
+    "title": "health.sleep.list",
+    "summary": "List normalized sleep intervals synced from health providers.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations\n- **Tags**: health, sleep, wearables",
+    "route": "/docs/reference/health/health.sleep.list",
+    "source": "generated",
+    "contentPath": "health/health.sleep.list.md"
+  },
+  {
+    "id": "health/health.sleep.sync",
+    "title": "health.sleep.sync",
+    "summary": "Synchronize sleep intervals from connected providers.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations\n- **Tags**: health, sleep, wearables",
+    "route": "/docs/reference/health/health.sleep.sync",
+    "source": "generated",
+    "contentPath": "health/health.sleep.sync.md"
+  },
+  {
+    "id": "health/health.webhooks.ingest",
+    "title": "health.webhooks.ingest",
+    "summary": "Ingest and normalize health provider webhook payloads.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations\n- **Tags**: health, webhooks, integrations",
+    "route": "/docs/reference/health/health.webhooks.ingest",
+    "source": "generated",
+    "contentPath": "health/health.webhooks.ingest.md"
+  },
+  {
+    "id": "health/health.workouts.list",
+    "title": "health.workouts.list",
+    "summary": "List normalized workout entries synced from health integrations.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations\n- **Tags**: health, workouts, wearables",
+    "route": "/docs/reference/health/health.workouts.list",
+    "source": "generated",
+    "contentPath": "health/health.workouts.list.md"
+  },
+  {
+    "id": "health/health.workouts.sync",
+    "title": "health.workouts.sync",
+    "summary": "Synchronize workouts from configured health providers.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.integrations\n- **Tags**: health, workouts, wearables",
+    "route": "/docs/reference/health/health.workouts.sync",
+    "source": "generated",
+    "contentPath": "health/health.workouts.sync.md"
+  }
+]