@contractspec/bundle.library 1.17.0 → 2.0.0

package/src/components/docs/advanced/AdvancedWorkflowMonitoringPage.tsx

@@ -16,7 +16,7 @@ export function AdvancedWorkflowMonitoringPage() {
           steps exceed their budgeted duration.
         </p>
         <pre className="bg-muted rounded-lg border p-4 text-sm">
-          {`import { SLAMonitor } from '@contractspec/lib.contracts/workflow/sla-monitor';
+          {`import { SLAMonitor } from '@contractspec/lib.contracts-spec/workflow/sla-monitor';
 
 const monitor = new SLAMonitor((event, payload) => {
   if (event === 'workflow.sla_breach') {

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

@@ -1,5 +1,5 @@
-import type { DocBlock } from '@contractspec/lib.contracts/docs';
-import { registerDocBlocks } from '@contractspec/lib.contracts/docs';
+import type { DocBlock } from '@contractspec/lib.contracts-spec/docs';
+import { registerDocBlocks } from '@contractspec/lib.contracts-spec/docs';
 
 const ecosystemDocBlocks: DocBlock[] = [
   {

package/src/components/docs/examples/DocsExamplesPage.tsx

@@ -8,7 +8,7 @@ import {
 } from '@contractspec/lib.design-system';
 import { VStack, HStack } from '@contractspec/lib.ui-kit-web/ui/stack';
 import { H1, Muted } from '@contractspec/lib.ui-kit-web/ui/typography';
-import { ExampleCatalogDataView } from '@contractspec/lib.contracts/docs';
+import { ExampleCatalogDataView } from '@contractspec/lib.contracts-spec/docs';
 
 interface ExampleItem extends Record<string, unknown> {
   id: string;

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

@@ -1,8 +1,32 @@
 [
+  {
+    "id": "_common/contractspec.docs",
+    "title": "contractspec.docs",
+    "summary": "Comprehensive documentation system for ContractSpec\n- **Type**: feature\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @platform.docs\n- **Tags**: documentation, guides, api-reference\n- **File**: `/Users/tboutron/Documents/clients/lssm/monorepo-lssm/packages/contractspec/packages/bundles/library/src/features/docs.feature.ts`",
+    "route": "/docs/reference/_common/contractspec.docs",
+    "source": "generated",
+    "contentPath": "_common/contractspec.docs.md"
+  },
+  {
+    "id": "_common/contractspec.mcp",
+    "title": "contractspec.mcp",
+    "summary": "Model Context Protocol server for AI agent integration\n- **Type**: feature\n- **Version**: 1.0.0\n- **Stability**: beta\n- **Owners**: @platform.mcp\n- **Tags**: mcp, ai-agents, tooling\n- **File**: `/Users/tboutron/Documents/clients/lssm/monorepo-lssm/packages/contractspec/packages/bundles/library/src/features/mcp.feature.ts`",
+    "route": "/docs/reference/_common/contractspec.mcp",
+    "source": "generated",
+    "contentPath": "_common/contractspec.mcp.md"
+  },
+  {
+    "id": "_common/contractspec.presentations",
+    "title": "contractspec.presentations",
+    "summary": "Cross-platform rendering of contract-driven UI\n- **Type**: feature\n- **Version**: 1.0.0\n- **Stability**: beta\n- **Owners**: @platform.presentations\n- **Tags**: presentations, ui, rendering, cross-platform\n- **File**: `/Users/tboutron/Documents/clients/lssm/monorepo-lssm/packages/contractspec/packages/bundles/library/src/features/presentations.feature.ts`",
+    "route": "/docs/reference/_common/contractspec.presentations",
+    "source": "generated",
+    "contentPath": "_common/contractspec.presentations.md"
+  },
   {
     "id": "_common/docs.contract.reference",
     "title": "docs.contract.reference",
-    "summary": "Resolve a contract into a documentation-ready reference.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: reference\n- **File**: `packages/libs/contracts/src/docs/queries/contractReference.query.ts`",
+    "summary": "Resolve a contract into a documentation-ready reference.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: reference\n- **File**: `packages/libs/contracts-spec/src/docs/queries/contractReference.query.ts`",
     "route": "/docs/reference/_common/docs.contract.reference",
     "source": "generated",
     "contentPath": "_common/docs.contract.reference.md"
@@ -10,7 +34,7 @@
   {
     "id": "_common/docs.generate",
     "title": "docs.generate",
-    "summary": "Generate documentation artifacts from ContractSpecs.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: generation\n- **File**: `packages/libs/contracts/src/docs/commands/docsGenerate.command.ts`",
+    "summary": "Generate documentation artifacts from ContractSpecs.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: generation\n- **File**: `packages/libs/contracts-spec/src/docs/commands/docsGenerate.command.ts`",
     "route": "/docs/reference/_common/docs.generate",
     "source": "generated",
     "contentPath": "_common/docs.generate.md"
@@ -18,7 +42,7 @@
   {
     "id": "_common/docs.generated",
     "title": "docs.generated",
-    "summary": "Emitted when documentation artifacts are generated.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: generation\n- **File**: `packages/libs/contracts/src/docs/events/docsGenerated.event.ts`\n```typescript",
+    "summary": "Emitted when documentation artifacts are generated.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: generation\n- **File**: `packages/libs/contracts-spec/src/docs/events/docsGenerated.event.ts`\n```typescript",
     "route": "/docs/reference/_common/docs.generated",
     "source": "generated",
     "contentPath": "_common/docs.generated.md"
@@ -26,7 +50,7 @@
   {
     "id": "_common/docs.layout",
     "title": "docs.layout",
-    "summary": "Shared layout shell for documentation pages.\n- **Type**: presentation (presentation)\n- **Version**: 1.0.0\n- **Tags**: layout\n- **File**: `packages/libs/contracts/src/docs/presentations/docsLayout.presentation.ts`",
+    "summary": "Shared layout shell for documentation pages.\n- **Type**: presentation (presentation)\n- **Version**: 1.0.0\n- **Tags**: layout\n- **File**: `packages/libs/contracts-spec/src/docs/presentations/docsLayout.presentation.ts`",
     "route": "/docs/reference/_common/docs.layout",
     "source": "generated",
     "contentPath": "_common/docs.layout.md"
@@ -34,7 +58,7 @@
   {
     "id": "_common/docs.publish",
     "title": "docs.publish",
-    "summary": "Publish generated documentation artifacts.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: publish\n- **File**: `packages/libs/contracts/src/docs/commands/docsPublish.command.ts`\nDeploy docs to the public docs surface with consistent versioning.",
+    "summary": "Publish generated documentation artifacts.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: publish\n- **File**: `packages/libs/contracts-spec/src/docs/commands/docsPublish.command.ts`\nDeploy docs to the public docs surface with consistent versioning.",
     "route": "/docs/reference/_common/docs.publish",
     "source": "generated",
     "contentPath": "_common/docs.publish.md"
@@ -42,7 +66,7 @@
   {
     "id": "_common/docs.published",
     "title": "docs.published",
-    "summary": "Emitted when documentation is published.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: publish\n- **File**: `packages/libs/contracts/src/docs/events/docsPublished.event.ts`\n```typescript\nexport const DocsPublishedEvent = defineEvent({",
+    "summary": "Emitted when documentation is published.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: publish\n- **File**: `packages/libs/contracts-spec/src/docs/events/docsPublished.event.ts`\n```typescript\nexport const DocsPublishedEvent = defineEvent({",
     "route": "/docs/reference/_common/docs.published",
     "source": "generated",
     "contentPath": "_common/docs.published.md"
@@ -50,7 +74,7 @@
   {
     "id": "_common/docs.reference.page",
     "title": "docs.reference.page",
-    "summary": "Reference page layout for contract documentation.\n- **Type**: presentation (presentation)\n- **Version**: 1.0.0\n- **Tags**: reference\n- **File**: `packages/libs/contracts/src/docs/presentations/docsReferencePage.presentation.ts`",
+    "summary": "Reference page layout for contract documentation.\n- **Type**: presentation (presentation)\n- **Version**: 1.0.0\n- **Tags**: reference\n- **File**: `packages/libs/contracts-spec/src/docs/presentations/docsReferencePage.presentation.ts`",
     "route": "/docs/reference/_common/docs.reference.page",
     "source": "generated",
     "contentPath": "_common/docs.reference.page.md"
@@ -58,7 +82,7 @@
   {
     "id": "_common/docs.search",
     "title": "docs.search",
-    "summary": "Search and filter DocBlocks by query, tag, or visibility.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: search, index\n- **File**: `packages/libs/contracts/src/docs/queries/docsIndex.query.ts`",
+    "summary": "Search and filter DocBlocks by query, tag, or visibility.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: search, index\n- **File**: `packages/libs/contracts-spec/src/docs/queries/docsIndex.query.ts`",
     "route": "/docs/reference/_common/docs.search",
     "source": "generated",
     "contentPath": "_common/docs.search.md"
@@ -66,7 +90,7 @@
   {
     "id": "_common/docs.system",
     "title": "docs.system",
-    "summary": "End-to-end docs generation, indexing, and presentation.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: system\n- **File**: `packages/libs/contracts/src/docs/capabilities/documentationSystem.capability.ts`",
+    "summary": "End-to-end docs generation, indexing, and presentation.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: system\n- **File**: `packages/libs/contracts-spec/src/docs/capabilities/documentationSystem.capability.ts`",
     "route": "/docs/reference/_common/docs.system",
     "source": "generated",
     "contentPath": "_common/docs.system.md"
@@ -90,7 +114,7 @@
   {
     "id": "_common/report.getContractVerificationStatus",
     "title": "report.getContractVerificationStatus",
-    "summary": "Retrieves per-contract verification status for the impact report.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **File**: `packages/libs/contracts/src/operations/report/getContractVerificationStatus.ts`",
+    "summary": "Retrieves per-contract verification status for the impact report.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **File**: `packages/libs/contracts-spec/src/operations/report/getContractVerificationStatus.ts`",
     "route": "/docs/reference/_common/report.getContractVerificationStatus",
     "source": "generated",
     "contentPath": "_common/report.getContractVerificationStatus.md"
@@ -150,7 +174,9 @@
     "route": "/docs/accessibility_wcag_compliance_specs",
     "source": "docblock",
     "contentPath": "docblocks/docs/accessibility_wcag_compliance_specs.md",
-    "tags": ["accessibility_wcag_compliance_specs"],
+    "tags": [
+      "accessibility_wcag_compliance_specs"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -161,7 +187,10 @@
     "route": "/docs/meta/docblocks-process",
     "source": "docblock",
     "contentPath": "docblocks/docs/meta/docblocks-process.md",
-    "tags": ["docs", "process"],
+    "tags": [
+      "docs",
+      "process"
+    ],
     "kind": "reference",
     "visibility": "mixed"
   },
@@ -172,7 +201,14 @@
     "route": "/docs/tech/auth/better-auth-nextjs",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/auth/better-auth-nextjs.md",
-    "tags": ["auth", "better-auth", "nextjs", "cookies", "proxy", "hmr"],
+    "tags": [
+      "auth",
+      "better-auth",
+      "nextjs",
+      "cookies",
+      "proxy",
+      "hmr"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -183,10 +219,16 @@
     "route": "/docs/tech/cli/contractspec",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/cli/contractspec.md",
-    "tags": ["cli", "tooling", "reference"],
+    "tags": [
+      "cli",
+      "tooling",
+      "reference"
+    ],
     "kind": "reference",
     "visibility": "public",
-    "owners": ["@contractspec/app.cli-contractspec"]
+    "owners": [
+      "@contractspec/app.cli-contractspec"
+    ]
   },
   {
     "id": "docs.tech.contracts.openapi-export",
@@ -195,7 +237,11 @@
     "route": "/docs/tech/contracts/openapi-export",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/contracts/openapi-export.md",
-    "tags": ["contracts", "openapi", "rest"],
+    "tags": [
+      "contracts",
+      "openapi",
+      "rest"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -206,7 +252,12 @@
     "route": "/docs/tech/contracts/openapi-import",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/contracts/openapi-import.md",
-    "tags": ["contracts", "openapi", "import", "codegen"],
+    "tags": [
+      "contracts",
+      "openapi",
+      "import",
+      "codegen"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -217,7 +268,11 @@
     "route": "/docs/tech/contracts/presentations",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/contracts/presentations.md",
-    "tags": ["presentations", "docs", "mcp"],
+    "tags": [
+      "presentations",
+      "docs",
+      "mcp"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -228,7 +283,11 @@
     "route": "/docs/tech/contracts/README",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/contracts/README.md",
-    "tags": ["tech", "contracts", "README"],
+    "tags": [
+      "tech",
+      "contracts",
+      "README"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -239,7 +298,11 @@
     "route": "/docs/tech/contracts/workspace-config",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/contracts/workspace-config.md",
-    "tags": ["tech", "contracts", "config"],
+    "tags": [
+      "tech",
+      "contracts",
+      "config"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -250,7 +313,10 @@
     "route": "/docs/tech/docs/examples",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/docs-examples.md",
-    "tags": ["docs", "examples"],
+    "tags": [
+      "docs",
+      "examples"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -261,7 +327,11 @@
     "route": "/docs/tech/docs/generator",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/docs-generator.md",
-    "tags": ["docs", "generator", "cli"],
+    "tags": [
+      "docs",
+      "generator",
+      "cli"
+    ],
     "kind": "how",
     "visibility": "public"
   },
@@ -272,7 +342,10 @@
     "route": "/docs/tech/docs/publish",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/docs-publish.md",
-    "tags": ["docs", "publish"],
+    "tags": [
+      "docs",
+      "publish"
+    ],
     "kind": "how",
     "visibility": "public"
   },
@@ -283,7 +356,10 @@
     "route": "/docs/tech/docs/reference",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/docs-reference.md",
-    "tags": ["docs", "reference"],
+    "tags": [
+      "docs",
+      "reference"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -294,7 +370,10 @@
     "route": "/docs/tech/docs/search",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/docs-search.md",
-    "tags": ["docs", "search"],
+    "tags": [
+      "docs",
+      "search"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -305,7 +384,11 @@
     "route": "/docs/tech/docs/system",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/docs-system.md",
-    "tags": ["docs", "system", "contracts"],
+    "tags": [
+      "docs",
+      "system",
+      "contracts"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -316,7 +399,10 @@
     "route": "/docs/tech/lifecycle-stage-system",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/lifecycle-stage-system.md",
-    "tags": ["tech", "lifecycle-stage-system"],
+    "tags": [
+      "tech",
+      "lifecycle-stage-system"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -327,7 +413,13 @@
     "route": "/docs/tech/llm/agent-adapters",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/llm/agent-adapters.md",
-    "tags": ["llm", "agents", "claude", "cursor", "mcp"],
+    "tags": [
+      "llm",
+      "agents",
+      "claude",
+      "cursor",
+      "mcp"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -338,7 +430,11 @@
     "route": "/docs/tech/llm/export-formats",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/llm/export-formats.md",
-    "tags": ["llm", "export", "markdown"],
+    "tags": [
+      "llm",
+      "export",
+      "markdown"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -349,7 +445,13 @@
     "route": "/docs/tech/llm/overview",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/llm/overview.md",
-    "tags": ["llm", "ai", "export", "guide", "verify"],
+    "tags": [
+      "llm",
+      "ai",
+      "export",
+      "guide",
+      "verify"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -360,7 +462,12 @@
     "route": "/docs/tech/llm/verification",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/llm/verification.md",
-    "tags": ["llm", "verify", "validation", "testing"],
+    "tags": [
+      "llm",
+      "verify",
+      "validation",
+      "testing"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -371,7 +478,12 @@
     "route": "/docs/tech/mcp/endpoints",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/mcp/endpoints.md",
-    "tags": ["mcp", "docs", "cli", "internal"],
+    "tags": [
+      "mcp",
+      "docs",
+      "cli",
+      "internal"
+    ],
     "kind": "reference",
     "visibility": "mixed"
   },
@@ -382,7 +494,10 @@
     "route": "/docs/tech/presentation-runtime",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/presentation-runtime.md",
-    "tags": ["tech", "presentation-runtime"],
+    "tags": [
+      "tech",
+      "presentation-runtime"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -393,10 +508,17 @@
     "route": "/docs/tech/report/verification-table",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/report-verification-table.md",
-    "tags": ["report", "drift", "verification", "impact"],
+    "tags": [
+      "report",
+      "drift",
+      "verification",
+      "impact"
+    ],
     "kind": "how",
     "visibility": "public",
-    "owners": ["platform.core"]
+    "owners": [
+      "platform.core"
+    ]
   },
   {
     "id": "docs.tech.schema.README",
@@ -405,7 +527,11 @@
     "route": "/docs/tech/schema/README",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/schema/README.md",
-    "tags": ["tech", "schema", "README"],
+    "tags": [
+      "tech",
+      "schema",
+      "README"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -416,7 +542,13 @@
     "route": "/docs/tech/studio/learning-events",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/studio/learning-events.md",
-    "tags": ["studio", "learning", "events", "analytics", "sandbox"],
+    "tags": [
+      "studio",
+      "learning",
+      "events",
+      "analytics",
+      "sandbox"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -445,7 +577,13 @@
     "route": "/docs/tech/studio/platform-admin-panel",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/studio/platform-admin-panel.md",
-    "tags": ["studio", "admin", "multi-tenancy", "integrations", "better-auth"],
+    "tags": [
+      "studio",
+      "admin",
+      "multi-tenancy",
+      "integrations",
+      "better-auth"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -456,7 +594,13 @@
     "route": "/docs/tech/studio/project-access-teams",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/studio/project-access-teams.md",
-    "tags": ["studio", "projects", "teams", "rbac", "access-control"],
+    "tags": [
+      "studio",
+      "projects",
+      "teams",
+      "rbac",
+      "access-control"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -467,7 +611,13 @@
     "route": "/docs/tech/studio/project-routing",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/studio/project-routing.md",
-    "tags": ["studio", "routing", "projects", "slug", "redirects"],
+    "tags": [
+      "studio",
+      "routing",
+      "projects",
+      "slug",
+      "redirects"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -478,7 +628,12 @@
     "route": "/docs/tech/studio/sandbox-unlogged",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/studio/sandbox/unlogged.md",
-    "tags": ["studio", "sandbox", "privacy", "analytics"],
+    "tags": [
+      "studio",
+      "sandbox",
+      "privacy",
+      "analytics"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -489,7 +644,13 @@
     "route": "/docs/tech/studio/team-invitations",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/studio/team-invitations.md",
-    "tags": ["studio", "teams", "invitations", "access-control", "onboarding"],
+    "tags": [
+      "studio",
+      "teams",
+      "invitations",
+      "access-control",
+      "onboarding"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -500,7 +661,13 @@
     "route": "/docs/tech/studio/workspace-ops",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/studio/workspace_ops.md",
-    "tags": ["studio", "repo", "workspace", "validate", "diff"],
+    "tags": [
+      "studio",
+      "repo",
+      "workspace",
+      "validate",
+      "diff"
+    ],
     "kind": "reference",
     "visibility": "mixed"
   },
@@ -511,7 +678,13 @@
     "route": "/docs/tech/studio/workspaces",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/studio/workspaces.md",
-    "tags": ["studio", "projects", "teams", "rbac", "environments"],
+    "tags": [
+      "studio",
+      "projects",
+      "teams",
+      "rbac",
+      "environments"
+    ],
     "kind": "reference",
     "visibility": "mixed"
   },
@@ -522,7 +695,11 @@
     "route": "/docs/tech/telemetry/hybrid",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/telemetry/hybrid.md",
-    "tags": ["telemetry", "architecture", "posthog"],
+    "tags": [
+      "telemetry",
+      "architecture",
+      "posthog"
+    ],
     "kind": "usage",
     "visibility": "internal"
   },
@@ -533,7 +710,12 @@
     "route": "/docs/tech/telemetry/ingest",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/telemetry/ingest.md",
-    "tags": ["telemetry", "api", "posthog", "analytics"],
+    "tags": [
+      "telemetry",
+      "api",
+      "posthog",
+      "analytics"
+    ],
     "kind": "reference",
     "visibility": "internal"
   },
@@ -544,7 +726,12 @@
     "route": "/docs/tech/vscode/extension",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/vscode/extension.md",
-    "tags": ["vscode", "extension", "tooling", "dx"],
+    "tags": [
+      "vscode",
+      "extension",
+      "tooling",
+      "dx"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
@@ -555,19 +742,27 @@
     "route": "/docs/tech/vscode/snippets",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/vscode/snippets.md",
-    "tags": ["vscode", "snippets", "dx"],
+    "tags": [
+      "vscode",
+      "snippets",
+      "dx"
+    ],
     "kind": "reference",
     "visibility": "public"
   },
   {
     "id": "docs.tech.workflows.overview",
     "title": "WorkflowSpec Overview",
-    "summary": "WorkflowSpec provides a declarative, versioned format for long-running flows that mix automation and human review. Specs stay inside `@contractspec/lib.contracts` (`src/workflow/spec.ts`) so the same definition powers runtime execution, documentation, and future generation.",
+    "summary": "WorkflowSpec provides a declarative, versioned format for long-running flows that mix automation and human review. Specs stay inside `@contractspec/lib.contracts-spec` (`src/workflow/spec.ts`) so the same definition powers runtime execution, documentation, and future generation.",
     "route": "/docs/tech/workflows/overview",
     "source": "docblock",
     "contentPath": "docblocks/docs/tech/workflows/overview.md",
-    "tags": ["tech", "workflows", "overview"],
+    "tags": [
+      "tech",
+      "workflows",
+      "overview"
+    ],
     "kind": "reference",
     "visibility": "public"
   }
-]
+]

package/src/components/docs/generated/docs-index.agent-console.json

@@ -375,4 +375,4 @@
     "source": "generated",
     "contentPath": "agent-console/test.agent.tool.list.md"
   }
-]
+]

package/src/components/docs/generated/docs-index.ai-chat.json

@@ -2,7 +2,7 @@
   {
     "id": "ai-chat/ai-chat",
     "title": "ai-chat",
-    "summary": "AI-powered chat interface\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Owners**: @platform.core\n- **Tags**: ai, chat, ui\n- **File**: `packages/modules/ai-chat/src/ai-chat.capability.ts`\n```typescript",
+    "summary": "AI-powered conversational coding assistant with full workspace context\n- **Type**: feature\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @platform.ai\n- **Tags**: ai, chat, llm, vibe-coding, assistant",
     "route": "/docs/reference/ai-chat/ai-chat",
     "source": "generated",
     "contentPath": "ai-chat/ai-chat.md"
@@ -103,4 +103,4 @@
     "source": "generated",
     "contentPath": "ai-chat/ai-chat.stream.md"
   }
-]
+]