@contractspec/bundle.library 3.9.6 → 3.9.7

package/src/components/docs/generated/docs-index.platform-database.json

@@ -1,90 +1,90 @@
 [
-	{
-		"id": "platform.database/database.context",
-		"title": "database.context",
-		"summary": "Schema, migration, dictionary, and read-only query surfaces.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: context\n- **File**: `packages/libs/contracts-spec/src/database/capabilities/databaseContext.capability.ts`",
-		"route": "/docs/reference/platform.database/database.context",
-		"source": "generated",
-		"contentPath": "platform.database/database.context.md"
-	},
-	{
-		"id": "platform.database/database.dictionary.get",
-		"title": "database.dictionary.get",
-		"summary": "Retrieve a data dictionary entry for a schema field.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: dictionary\n- **File**: `packages/libs/contracts-spec/src/database/queries/databaseDictionaryGet.query.ts`",
-		"route": "/docs/reference/platform.database/database.dictionary.get",
-		"source": "generated",
-		"contentPath": "platform.database/database.dictionary.get.md"
-	},
-	{
-		"id": "platform.database/database.migrations.list",
-		"title": "database.migrations.list",
-		"summary": "List registered database migrations and statuses.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: migrations\n- **File**: `packages/libs/contracts-spec/src/database/queries/databaseMigrationsList.query.ts`",
-		"route": "/docs/reference/platform.database/database.migrations.list",
-		"source": "generated",
-		"contentPath": "platform.database/database.migrations.list.md"
-	},
-	{
-		"id": "platform.database/database.query.readonly",
-		"title": "database.query.readonly",
-		"summary": "Execute a governed read-only query via a data view.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: query, readonly\n- **File**: `packages/libs/contracts-spec/src/database/queries/databaseQueryReadonly.query.ts`",
-		"route": "/docs/reference/platform.database/database.query.readonly",
-		"source": "generated",
-		"contentPath": "platform.database/database.query.readonly.md"
-	},
-	{
-		"id": "platform.database/database.schema.describe",
-		"title": "database.schema.describe",
-		"summary": "Describe database schemas and models with PII indicators.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: describe\n- **File**: `packages/libs/contracts-spec/src/database/queries/databaseSchemaDescribe.query.ts`",
-		"route": "/docs/reference/platform.database/database.schema.describe",
-		"source": "generated",
-		"contentPath": "platform.database/database.schema.describe.md"
-	},
-	{
-		"id": "platform.database/docs.tech.database.context",
-		"title": "Database context",
-		"summary": "Database context covers schema descriptions, migrations, data dictionary entries, and governed read-only access.",
-		"route": "/docs/reference/platform.database/docs.tech.database.context",
-		"source": "generated",
-		"contentPath": "platform.database/docs.tech.database.context.md"
-	},
-	{
-		"id": "platform.database/docs.tech.database.dictionary.get",
-		"title": "database.dictionary.get",
-		"summary": "Returns semantic descriptions and PII tags for fields.",
-		"route": "/docs/reference/platform.database/docs.tech.database.dictionary.get",
-		"source": "generated",
-		"contentPath": "platform.database/docs.tech.database.dictionary.get.md"
-	},
-	{
-		"id": "platform.database/docs.tech.database.migrations.list",
-		"title": "database.migrations.list",
-		"summary": "Returns migration registry entries and statuses for auditability.",
-		"route": "/docs/reference/platform.database/docs.tech.database.migrations.list",
-		"source": "generated",
-		"contentPath": "platform.database/docs.tech.database.migrations.list.md"
-	},
-	{
-		"id": "platform.database/docs.tech.database.query.readonly",
-		"title": "database.query.readonly",
-		"summary": "Executes read-only data access using data views with policy and redaction.",
-		"route": "/docs/reference/platform.database/docs.tech.database.query.readonly",
-		"source": "generated",
-		"contentPath": "platform.database/docs.tech.database.query.readonly.md"
-	},
-	{
-		"id": "platform.database/docs.tech.database.schema.describe",
-		"title": "database.schema.describe",
-		"summary": "Returns deterministic schema summaries for agents and operators.",
-		"route": "/docs/reference/platform.database/docs.tech.database.schema.describe",
-		"source": "generated",
-		"contentPath": "platform.database/docs.tech.database.schema.describe.md"
-	},
-	{
-		"id": "platform.database/platform.database",
-		"title": "platform.database",
-		"summary": "Describe schemas, list migrations, query data dictionaries, and execute read-only queries\n- **Type**: feature\n- **Version**: 1.0.0\n- **File**: `packages/libs/contracts-spec/src/database/database.feature.ts`",
-		"route": "/docs/reference/platform.database/platform.database",
-		"source": "generated",
-		"contentPath": "platform.database/platform.database.md"
-	}
-]
+  {
+    "id": "platform.database/database.context",
+    "title": "database.context",
+    "summary": "Schema, migration, dictionary, and read-only query surfaces.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: context\n- **File**: `packages/libs/contracts-spec/src/database/capabilities/databaseContext.capability.ts`",
+    "route": "/docs/reference/platform.database/database.context",
+    "source": "generated",
+    "contentPath": "platform.database/database.context.md"
+  },
+  {
+    "id": "platform.database/database.dictionary.get",
+    "title": "database.dictionary.get",
+    "summary": "Retrieve a data dictionary entry for a schema field.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: dictionary\n- **File**: `packages/libs/contracts-spec/src/database/queries/databaseDictionaryGet.query.ts`",
+    "route": "/docs/reference/platform.database/database.dictionary.get",
+    "source": "generated",
+    "contentPath": "platform.database/database.dictionary.get.md"
+  },
+  {
+    "id": "platform.database/database.migrations.list",
+    "title": "database.migrations.list",
+    "summary": "List registered database migrations and statuses.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: migrations\n- **File**: `packages/libs/contracts-spec/src/database/queries/databaseMigrationsList.query.ts`",
+    "route": "/docs/reference/platform.database/database.migrations.list",
+    "source": "generated",
+    "contentPath": "platform.database/database.migrations.list.md"
+  },
+  {
+    "id": "platform.database/database.query.readonly",
+    "title": "database.query.readonly",
+    "summary": "Execute a governed read-only query via a data view.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: query, readonly\n- **File**: `packages/libs/contracts-spec/src/database/queries/databaseQueryReadonly.query.ts`",
+    "route": "/docs/reference/platform.database/database.query.readonly",
+    "source": "generated",
+    "contentPath": "platform.database/database.query.readonly.md"
+  },
+  {
+    "id": "platform.database/database.schema.describe",
+    "title": "database.schema.describe",
+    "summary": "Describe database schemas and models with PII indicators.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: describe\n- **File**: `packages/libs/contracts-spec/src/database/queries/databaseSchemaDescribe.query.ts`",
+    "route": "/docs/reference/platform.database/database.schema.describe",
+    "source": "generated",
+    "contentPath": "platform.database/database.schema.describe.md"
+  },
+  {
+    "id": "platform.database/docs.tech.database.context",
+    "title": "Database context",
+    "summary": "Database context covers schema descriptions, migrations, data dictionary entries, and governed read-only access.",
+    "route": "/docs/reference/platform.database/docs.tech.database.context",
+    "source": "generated",
+    "contentPath": "platform.database/docs.tech.database.context.md"
+  },
+  {
+    "id": "platform.database/docs.tech.database.dictionary.get",
+    "title": "database.dictionary.get",
+    "summary": "Returns semantic descriptions and PII tags for fields.",
+    "route": "/docs/reference/platform.database/docs.tech.database.dictionary.get",
+    "source": "generated",
+    "contentPath": "platform.database/docs.tech.database.dictionary.get.md"
+  },
+  {
+    "id": "platform.database/docs.tech.database.migrations.list",
+    "title": "database.migrations.list",
+    "summary": "Returns migration registry entries and statuses for auditability.",
+    "route": "/docs/reference/platform.database/docs.tech.database.migrations.list",
+    "source": "generated",
+    "contentPath": "platform.database/docs.tech.database.migrations.list.md"
+  },
+  {
+    "id": "platform.database/docs.tech.database.query.readonly",
+    "title": "database.query.readonly",
+    "summary": "Executes read-only data access using data views with policy and redaction.",
+    "route": "/docs/reference/platform.database/docs.tech.database.query.readonly",
+    "source": "generated",
+    "contentPath": "platform.database/docs.tech.database.query.readonly.md"
+  },
+  {
+    "id": "platform.database/docs.tech.database.schema.describe",
+    "title": "database.schema.describe",
+    "summary": "Returns deterministic schema summaries for agents and operators.",
+    "route": "/docs/reference/platform.database/docs.tech.database.schema.describe",
+    "source": "generated",
+    "contentPath": "platform.database/docs.tech.database.schema.describe.md"
+  },
+  {
+    "id": "platform.database/platform.database",
+    "title": "platform.database",
+    "summary": "Describe schemas, list migrations, query data dictionaries, and execute read-only queries\n- **Type**: feature\n- **Version**: 1.0.0\n- **File**: `packages/libs/contracts-spec/src/database/database.feature.ts`",
+    "route": "/docs/reference/platform.database/platform.database",
+    "source": "generated",
+    "contentPath": "platform.database/platform.database.md"
+  }
+]

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

@@ -1,162 +1,162 @@
 [
-	{
-		"id": "platform.docs/AddNumbersSpec",
-		"title": "AddNumbersSpec",
-		"summary": "- **Type**: operation (command)\n- **Version**: 1.0.0\n- **File**: `packages/libs/contracts-spec/src/docs/docblocks.manifest.generated.ts`\n```typescript\nexport const AddNumbersSpec = defineCommand({\\n  meta: { name: 'math.add', version: '1.0.0', /* … */ },\\n  io: {\\n    input: AddNumbersInput,\\n    output: AddNumbersOutput,\\n  },\\n  policy: { auth: 'user' },\\n});",
-		"route": "/docs/reference/platform.docs/AddNumbersSpec",
-		"source": "generated",
-		"contentPath": "platform.docs/AddNumbersSpec.md"
-	},
-	{
-		"id": "platform.docs/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-spec/src/docs/queries/docsIndex.query.ts`",
-		"route": "/docs/reference/platform.docs/docs_search",
-		"source": "generated",
-		"contentPath": "platform.docs/docs_search.md"
-	},
-	{
-		"id": "platform.docs/docs_search.form",
-		"title": "docs_search.form",
-		"summary": "Search form for documentation discovery.\n- **Type**: form (form)\n- **Version**: 1.0.0\n- **Tags**: search\n- **File**: `packages/libs/contracts-spec/src/docs/forms/docsSearch.form.ts`\n```typescript\nimport { ScalarTypeEnum, SchemaModel } from '@contractspec/lib.schema';",
-		"route": "/docs/reference/platform.docs/docs_search.form",
-		"source": "generated",
-		"contentPath": "platform.docs/docs_search.form.md"
-	},
-	{
-		"id": "platform.docs/docs.accessibility_wcag_compliance_specs",
-		"title": "Accessibility & WCAG Compliance — **specs.md**",
-		"summary": "> **Goal:** Ship interfaces that are usable by everyone, by default. This spec sets non‑negotiable rules, checklists, and CI gates to meet **WCAG 2.2 AA** (aim for AAA where low‑cost), align with **EN 301 549** (EU), and keep parity on **web (Next.js)** and **mobile (Expo/React Native)**.",
-		"route": "/docs/reference/platform.docs/docs.accessibility_wcag_compliance_specs",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.accessibility_wcag_compliance_specs.md"
-	},
-	{
-		"id": "platform.docs/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-spec/src/docs/queries/contractReference.query.ts`",
-		"route": "/docs/reference/platform.docs/docs.contract.reference",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.contract.reference.md"
-	},
-	{
-		"id": "platform.docs/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-spec/src/docs/commands/docsGenerate.command.ts`",
-		"route": "/docs/reference/platform.docs/docs.generate",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.generate.md"
-	},
-	{
-		"id": "platform.docs/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-spec/src/docs/events/docsGenerated.event.ts`\n```typescript",
-		"route": "/docs/reference/platform.docs/docs.generated",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.generated.md"
-	},
-	{
-		"id": "platform.docs/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-spec/src/docs/presentations/docsLayout.presentation.ts`",
-		"route": "/docs/reference/platform.docs/docs.layout",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.layout.md"
-	},
-	{
-		"id": "platform.docs/docs.meta.docblocks-process",
-		"title": "platform.docs/docs.meta.docblocks-process",
-		"summary": "- Colocate docs beside implementation; avoid barrel /docs folders.\n- Split intent:\n- **goal**: why this exists (before implementation).\n- **how**: operational/runbook steps.\n- **usage**: quick checklist for consumers.",
-		"route": "/docs/reference/platform.docs/docs.meta.docblocks-process",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.meta.docblocks-process.md"
-	},
-	{
-		"id": "platform.docs/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-spec/src/docs/commands/docsPublish.command.ts`\nDeploy docs to the public docs surface with consistent versioning.",
-		"route": "/docs/reference/platform.docs/docs.publish",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.publish.md"
-	},
-	{
-		"id": "platform.docs/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-spec/src/docs/events/docsPublished.event.ts`\n```typescript\nimport { ScalarTypeEnum, SchemaModel } from '@contractspec/lib.schema';",
-		"route": "/docs/reference/platform.docs/docs.published",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.published.md"
-	},
-	{
-		"id": "platform.docs/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-spec/src/docs/presentations/docsReferencePage.presentation.ts`",
-		"route": "/docs/reference/platform.docs/docs.reference.page",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.reference.page.md"
-	},
-	{
-		"id": "platform.docs/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-spec/src/docs/queries/docsIndex.query.ts`",
-		"route": "/docs/reference/platform.docs/docs.search",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.search.md"
-	},
-	{
-		"id": "platform.docs/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-spec/src/docs/capabilities/documentationSystem.capability.ts`",
-		"route": "/docs/reference/platform.docs/docs.system",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.system.md"
-	},
-	{
-		"id": "platform.docs/docs.tech.docs-generator",
-		"title": "Docs generator",
-		"summary": "The generator produces documentation artifacts, search metadata, and reference pages from ContractSpecs and DocBlocks.",
-		"route": "/docs/reference/platform.docs/docs.tech.docs-generator",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.tech.docs-generator.md"
-	},
-	{
-		"id": "platform.docs/docs.tech.docs-publish",
-		"title": "Docs publish",
-		"summary": "Publishing moves generated artifacts to a hosting target with versioning and release metadata.",
-		"route": "/docs/reference/platform.docs/docs.tech.docs-publish",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.tech.docs-publish.md"
-	},
-	{
-		"id": "platform.docs/docs.tech.docs-reference",
-		"title": "Contract reference",
-		"summary": "Contract reference pages are generated from spec metadata plus schema details and exposed as a docs-ready payload.",
-		"route": "/docs/reference/platform.docs/docs.tech.docs-reference",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.tech.docs-reference.md"
-	},
-	{
-		"id": "platform.docs/docs.tech.docs-search",
-		"title": "Docs index and search",
-		"summary": "The docs index is the canonical list of DocBlocks exposed to UI, CLI, and MCP surfaces for filtering and retrieval.",
-		"route": "/docs/reference/platform.docs/docs.tech.docs-search",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.tech.docs-search.md"
-	},
-	{
-		"id": "platform.docs/docs.tech.docs-system",
-		"title": "Docs system overview",
-		"summary": "ContractSpec treats documentation as a first-class output of your specs. The docs system combines contracts, DocBlocks, manifests, and presentations into a consistent docs surface.",
-		"route": "/docs/reference/platform.docs/docs.tech.docs-system",
-		"source": "generated",
-		"contentPath": "platform.docs/docs.tech.docs-system.md"
-	},
-	{
-		"id": "platform.docs/platform.docs",
-		"title": "platform.docs",
-		"summary": "Generate, publish, search, and reference contract documentation and DocBlocks\n- **Type**: feature\n- **Version**: 1.0.0\n- **File**: `packages/libs/contracts-spec/src/docs/docs.feature.ts`\n- `docs.generate` (v1.0.0)",
-		"route": "/docs/reference/platform.docs/platform.docs",
-		"source": "generated",
-		"contentPath": "platform.docs/platform.docs.md"
-	}
-]
+  {
+    "id": "platform.docs/AddNumbersSpec",
+    "title": "AddNumbersSpec",
+    "summary": "- **Type**: operation (command)\n- **Version**: 1.0.0\n- **File**: `packages/libs/contracts-spec/src/docs/docblocks.manifest.generated.ts`\n```typescript\nexport const AddNumbersSpec = defineCommand({\\n  meta: { name: 'math.add', version: '1.0.0', /* … */ },\\n  io: {\\n    input: AddNumbersInput,\\n    output: AddNumbersOutput,\\n  },\\n  policy: { auth: 'user' },\\n});",
+    "route": "/docs/reference/platform.docs/AddNumbersSpec",
+    "source": "generated",
+    "contentPath": "platform.docs/AddNumbersSpec.md"
+  },
+  {
+    "id": "platform.docs/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-spec/src/docs/queries/docsIndex.query.ts`",
+    "route": "/docs/reference/platform.docs/docs_search",
+    "source": "generated",
+    "contentPath": "platform.docs/docs_search.md"
+  },
+  {
+    "id": "platform.docs/docs_search.form",
+    "title": "docs_search.form",
+    "summary": "Search form for documentation discovery.\n- **Type**: form (form)\n- **Version**: 1.0.0\n- **Tags**: search\n- **File**: `packages/libs/contracts-spec/src/docs/forms/docsSearch.form.ts`\n```typescript\nimport { ScalarTypeEnum, SchemaModel } from '@contractspec/lib.schema';",
+    "route": "/docs/reference/platform.docs/docs_search.form",
+    "source": "generated",
+    "contentPath": "platform.docs/docs_search.form.md"
+  },
+  {
+    "id": "platform.docs/docs.accessibility_wcag_compliance_specs",
+    "title": "Accessibility & WCAG Compliance — **specs.md**",
+    "summary": "> **Goal:** Ship interfaces that are usable by everyone, by default. This spec sets non‑negotiable rules, checklists, and CI gates to meet **WCAG 2.2 AA** (aim for AAA where low‑cost), align with **EN 301 549** (EU), and keep parity on **web (Next.js)** and **mobile (Expo/React Native)**.",
+    "route": "/docs/reference/platform.docs/docs.accessibility_wcag_compliance_specs",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.accessibility_wcag_compliance_specs.md"
+  },
+  {
+    "id": "platform.docs/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-spec/src/docs/queries/contractReference.query.ts`",
+    "route": "/docs/reference/platform.docs/docs.contract.reference",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.contract.reference.md"
+  },
+  {
+    "id": "platform.docs/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-spec/src/docs/commands/docsGenerate.command.ts`",
+    "route": "/docs/reference/platform.docs/docs.generate",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.generate.md"
+  },
+  {
+    "id": "platform.docs/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-spec/src/docs/events/docsGenerated.event.ts`\n```typescript",
+    "route": "/docs/reference/platform.docs/docs.generated",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.generated.md"
+  },
+  {
+    "id": "platform.docs/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-spec/src/docs/presentations/docsLayout.presentation.ts`",
+    "route": "/docs/reference/platform.docs/docs.layout",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.layout.md"
+  },
+  {
+    "id": "platform.docs/docs.meta.docblocks-process",
+    "title": "platform.docs/docs.meta.docblocks-process",
+    "summary": "- Colocate docs beside implementation; avoid barrel /docs folders.\n- Split intent:\n- **goal**: why this exists (before implementation).\n- **how**: operational/runbook steps.\n- **usage**: quick checklist for consumers.",
+    "route": "/docs/reference/platform.docs/docs.meta.docblocks-process",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.meta.docblocks-process.md"
+  },
+  {
+    "id": "platform.docs/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-spec/src/docs/commands/docsPublish.command.ts`\nDeploy docs to the public docs surface with consistent versioning.",
+    "route": "/docs/reference/platform.docs/docs.publish",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.publish.md"
+  },
+  {
+    "id": "platform.docs/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-spec/src/docs/events/docsPublished.event.ts`\n```typescript\nimport { ScalarTypeEnum, SchemaModel } from '@contractspec/lib.schema';",
+    "route": "/docs/reference/platform.docs/docs.published",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.published.md"
+  },
+  {
+    "id": "platform.docs/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-spec/src/docs/presentations/docsReferencePage.presentation.ts`",
+    "route": "/docs/reference/platform.docs/docs.reference.page",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.reference.page.md"
+  },
+  {
+    "id": "platform.docs/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-spec/src/docs/queries/docsIndex.query.ts`",
+    "route": "/docs/reference/platform.docs/docs.search",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.search.md"
+  },
+  {
+    "id": "platform.docs/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-spec/src/docs/capabilities/documentationSystem.capability.ts`",
+    "route": "/docs/reference/platform.docs/docs.system",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.system.md"
+  },
+  {
+    "id": "platform.docs/docs.tech.docs-generator",
+    "title": "Docs generator",
+    "summary": "The generator produces documentation artifacts, search metadata, and reference pages from ContractSpecs and DocBlocks.",
+    "route": "/docs/reference/platform.docs/docs.tech.docs-generator",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.tech.docs-generator.md"
+  },
+  {
+    "id": "platform.docs/docs.tech.docs-publish",
+    "title": "Docs publish",
+    "summary": "Publishing moves generated artifacts to a hosting target with versioning and release metadata.",
+    "route": "/docs/reference/platform.docs/docs.tech.docs-publish",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.tech.docs-publish.md"
+  },
+  {
+    "id": "platform.docs/docs.tech.docs-reference",
+    "title": "Contract reference",
+    "summary": "Contract reference pages are generated from spec metadata plus schema details and exposed as a docs-ready payload.",
+    "route": "/docs/reference/platform.docs/docs.tech.docs-reference",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.tech.docs-reference.md"
+  },
+  {
+    "id": "platform.docs/docs.tech.docs-search",
+    "title": "Docs index and search",
+    "summary": "The docs index is the canonical list of DocBlocks exposed to UI, CLI, and MCP surfaces for filtering and retrieval.",
+    "route": "/docs/reference/platform.docs/docs.tech.docs-search",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.tech.docs-search.md"
+  },
+  {
+    "id": "platform.docs/docs.tech.docs-system",
+    "title": "Docs system overview",
+    "summary": "ContractSpec treats documentation as a first-class output of your specs. The docs system combines contracts, DocBlocks, manifests, and presentations into a consistent docs surface.",
+    "route": "/docs/reference/platform.docs/docs.tech.docs-system",
+    "source": "generated",
+    "contentPath": "platform.docs/docs.tech.docs-system.md"
+  },
+  {
+    "id": "platform.docs/platform.docs",
+    "title": "platform.docs",
+    "summary": "Generate, publish, search, and reference contract documentation and DocBlocks\n- **Type**: feature\n- **Version**: 1.0.0\n- **File**: `packages/libs/contracts-spec/src/docs/docs.feature.ts`\n- `docs.generate` (v1.0.0)",
+    "route": "/docs/reference/platform.docs/platform.docs",
+    "source": "generated",
+    "contentPath": "platform.docs/platform.docs.md"
+  }
+]