@contractspec/bundle.library 3.9.6 → 3.9.8

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

@@ -1,1700 +1,2009 @@
 [
-	{
-		"id": "_common/acp.fs.access",
-		"title": "acp.fs.access",
-		"summary": "Perform file system access within an ACP session.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: filesystem\n- **File**: `packages/libs/contracts-spec/src/acp/commands/acpFsAccess.command.ts`",
-		"route": "/docs/reference/_common/acp.fs.access",
-		"source": "generated",
-		"contentPath": "_common/acp.fs.access.md"
-	},
-	{
-		"id": "_common/acp.prompt.turn",
-		"title": "acp.prompt.turn",
-		"summary": "Execute a prompt turn within an ACP session.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: prompt\n- **File**: `packages/libs/contracts-spec/src/acp/commands/acpPromptTurn.command.ts`\nRun ACP prompt turns with tool calls and structured outputs.",
-		"route": "/docs/reference/_common/acp.prompt.turn",
-		"source": "generated",
-		"contentPath": "_common/acp.prompt.turn.md"
-	},
-	{
-		"id": "_common/acp.session.init",
-		"title": "acp.session.init",
-		"summary": "Initialize a new ACP session.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: session\n- **File**: `packages/libs/contracts-spec/src/acp/commands/acpSessionInit.command.ts`\nStart a governed ACP session with configured tools and policies.",
-		"route": "/docs/reference/_common/acp.session.init",
-		"source": "generated",
-		"contentPath": "_common/acp.session.init.md"
-	},
-	{
-		"id": "_common/acp.session.resume",
-		"title": "acp.session.resume",
-		"summary": "Resume an existing ACP session.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: session\n- **File**: `packages/libs/contracts-spec/src/acp/commands/acpSessionResume.command.ts`\nContinue a previously initialized ACP session with full context.",
-		"route": "/docs/reference/_common/acp.session.resume",
-		"source": "generated",
-		"contentPath": "_common/acp.session.resume.md"
-	},
-	{
-		"id": "_common/acp.session.stop",
-		"title": "acp.session.stop",
-		"summary": "Stop an active ACP session.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: session\n- **File**: `packages/libs/contracts-spec/src/acp/commands/acpSessionStop.command.ts`\nTerminate ACP sessions cleanly with audit trails.",
-		"route": "/docs/reference/_common/acp.session.stop",
-		"source": "generated",
-		"contentPath": "_common/acp.session.stop.md"
-	},
-	{
-		"id": "_common/acp.terminal.exec",
-		"title": "acp.terminal.exec",
-		"summary": "Execute a terminal command within an ACP session.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: terminal\n- **File**: `packages/libs/contracts-spec/src/acp/commands/acpTerminalExec.command.ts`",
-		"route": "/docs/reference/_common/acp.terminal.exec",
-		"source": "generated",
-		"contentPath": "_common/acp.terminal.exec.md"
-	},
-	{
-		"id": "_common/acp.tool.calls",
-		"title": "acp.tool.calls",
-		"summary": "Execute tool calls within an ACP session.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: tools\n- **File**: `packages/libs/contracts-spec/src/acp/commands/acpToolCalls.command.ts`\nRun tool calls with safe governance and telemetry.",
-		"route": "/docs/reference/_common/acp.tool.calls",
-		"source": "generated",
-		"contentPath": "_common/acp.tool.calls.md"
-	},
-	{
-		"id": "_common/acp.transport",
-		"title": "acp.transport",
-		"summary": "Agent Client Protocol transport surfaces.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: transport\n- **File**: `packages/libs/contracts-spec/src/acp/capabilities/acpTransport.capability.ts`",
-		"route": "/docs/reference/_common/acp.transport",
-		"source": "generated",
-		"contentPath": "_common/acp.transport.md"
-	},
-	{
-		"id": "_common/AddNumbersSpec",
-		"title": "AddNumbersSpec",
-		"summary": "- **Type**: operation (command)\n- **Version**: 1.0.0\n- **File**: `packages/libs/contracts-spec/src/tests/spec.ts`\n```typescript\nimport { compareVersions } from 'compare-versions';\nimport type { DocBlock } from '../docs/types';",
-		"route": "/docs/reference/_common/AddNumbersSpec",
-		"source": "generated",
-		"contentPath": "_common/AddNumbersSpec.md"
-	},
-	{
-		"id": "_common/agent.approval.requested",
-		"title": "agent.approval.requested",
-		"summary": "Emitted when an approval is required for an agent action.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: approval\n- **File**: `packages/libs/contracts-spec/src/agent/events/agentApprovalRequested.event.ts`",
-		"route": "/docs/reference/_common/agent.approval.requested",
-		"source": "generated",
-		"contentPath": "_common/agent.approval.requested.md"
-	},
-	{
-		"id": "_common/agent.approvals",
-		"title": "agent.approvals",
-		"summary": "Approve or reject an agent step or run.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: approval\n- **File**: `packages/libs/contracts-spec/src/agent/commands/agentApprovals.command.ts`\nProvide governed human-in-the-loop control for risky steps.",
-		"route": "/docs/reference/_common/agent.approvals",
-		"source": "generated",
-		"contentPath": "_common/agent.approvals.md"
-	},
-	{
-		"id": "_common/agent.artifacts",
-		"title": "agent.artifacts",
-		"summary": "List artifacts produced by an agent run.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: artifacts\n- **File**: `packages/libs/contracts-spec/src/agent/queries/agentArtifacts.query.ts`\nProvide traceable outputs for audits and UI surfaces.",
-		"route": "/docs/reference/_common/agent.artifacts",
-		"source": "generated",
-		"contentPath": "_common/agent.artifacts.md"
-	},
-	{
-		"id": "_common/agent.cancel",
-		"title": "agent.cancel",
-		"summary": "Cancel an in-flight agent run.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: run, cancel\n- **File**: `packages/libs/contracts-spec/src/agent/commands/agentCancel.command.ts`\nProvide safe operator control to stop background agents.",
-		"route": "/docs/reference/_common/agent.cancel",
-		"source": "generated",
-		"contentPath": "_common/agent.cancel.md"
-	},
-	{
-		"id": "_common/agent.execution",
-		"title": "agent.execution",
-		"summary": "Background agent execution, approvals, and artifacts.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: execution\n- **File**: `packages/libs/contracts-spec/src/agent/capabilities/agentExecution.capability.ts`",
-		"route": "/docs/reference/_common/agent.execution",
-		"source": "generated",
-		"contentPath": "_common/agent.execution.md"
-	},
-	{
-		"id": "_common/agent.run",
-		"title": "agent.run",
-		"summary": "Submit a background agent run with a context snapshot.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: run\n- **File**: `packages/libs/contracts-spec/src/agent/commands/agentRun.command.ts`",
-		"route": "/docs/reference/_common/agent.run",
-		"source": "generated",
-		"contentPath": "_common/agent.run.md"
-	},
-	{
-		"id": "_common/agent.run.audit",
-		"title": "agent.run.audit",
-		"summary": "Audit layout for agent runs and artifacts.\n- **Type**: presentation (presentation)\n- **Version**: 1.0.0\n- **Tags**: audit\n- **File**: `packages/libs/contracts-spec/src/agent/presentations/agentRunAudit.presentation.ts`",
-		"route": "/docs/reference/_common/agent.run.audit",
-		"source": "generated",
-		"contentPath": "_common/agent.run.audit.md"
-	},
-	{
-		"id": "_common/agent.run.completed",
-		"title": "agent.run.completed",
-		"summary": "Emitted when an agent run completes successfully.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: run\n- **File**: `packages/libs/contracts-spec/src/agent/events/agentRunCompleted.event.ts`\n```typescript",
-		"route": "/docs/reference/_common/agent.run.completed",
-		"source": "generated",
-		"contentPath": "_common/agent.run.completed.md"
-	},
-	{
-		"id": "_common/agent.run.failed",
-		"title": "agent.run.failed",
-		"summary": "Emitted when an agent run fails.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: run\n- **File**: `packages/libs/contracts-spec/src/agent/events/agentRunFailed.event.ts`\n```typescript\nexport const AgentRunFailedEvent = defineEvent({",
-		"route": "/docs/reference/_common/agent.run.failed",
-		"source": "generated",
-		"contentPath": "_common/agent.run.failed.md"
-	},
-	{
-		"id": "_common/agent.run.started",
-		"title": "agent.run.started",
-		"summary": "Emitted when an agent run starts executing.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: run\n- **File**: `packages/libs/contracts-spec/src/agent/events/agentRunStarted.event.ts`\n```typescript\nexport const AgentRunStartedEvent = defineEvent({",
-		"route": "/docs/reference/_common/agent.run.started",
-		"source": "generated",
-		"contentPath": "_common/agent.run.started.md"
-	},
-	{
-		"id": "_common/agent.status",
-		"title": "agent.status",
-		"summary": "Get status for agent runs.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: status\n- **File**: `packages/libs/contracts-spec/src/agent/queries/agentStatus.query.ts`\nProvide status and progress visibility for background agents.",
-		"route": "/docs/reference/_common/agent.status",
-		"source": "generated",
-		"contentPath": "_common/agent.status.md"
-	},
-	{
-		"id": "_common/context.pack.describe",
-		"title": "context.pack.describe",
-		"summary": "Describe a context pack and its sources.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: pack, describe\n- **File**: `packages/libs/contracts-spec/src/context/queries/contextPackDescribe.query.ts`",
-		"route": "/docs/reference/_common/context.pack.describe",
-		"source": "generated",
-		"contentPath": "_common/context.pack.describe.md"
-	},
-	{
-		"id": "_common/context.pack.search",
-		"title": "context.pack.search",
-		"summary": "Search and filter context packs and snapshots.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: pack, search\n- **File**: `packages/libs/contracts-spec/src/context/queries/contextPackSearch.query.ts`",
-		"route": "/docs/reference/_common/context.pack.search",
-		"source": "generated",
-		"contentPath": "_common/context.pack.search.md"
-	},
-	{
-		"id": "_common/context.pack.snapshot",
-		"title": "context.pack.snapshot",
-		"summary": "Create an immutable snapshot from a context pack.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: snapshot, create\n- **File**: `packages/libs/contracts-spec/src/context/commands/contextPackSnapshot.command.ts`",
-		"route": "/docs/reference/_common/context.pack.snapshot",
-		"source": "generated",
-		"contentPath": "_common/context.pack.snapshot.md"
-	},
-	{
-		"id": "_common/context.snapshot.created",
-		"title": "context.snapshot.created",
-		"summary": "Emitted when a context snapshot is created.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: snapshot\n- **File**: `packages/libs/contracts-spec/src/context/events/contextSnapshotCreated.event.ts`",
-		"route": "/docs/reference/_common/context.snapshot.created",
-		"source": "generated",
-		"contentPath": "_common/context.snapshot.created.md"
-	},
-	{
-		"id": "_common/context.snapshot.summary",
-		"title": "context.snapshot.summary",
-		"summary": "Summary layout for context snapshots.\n- **Type**: presentation (presentation)\n- **Version**: 1.0.0\n- **Tags**: snapshot, summary\n- **File**: `packages/libs/contracts-spec/src/context/presentations/contextSnapshot.presentation.ts`",
-		"route": "/docs/reference/_common/context.snapshot.summary",
-		"source": "generated",
-		"contentPath": "_common/context.snapshot.summary.md"
-	},
-	{
-		"id": "_common/context.system",
-		"title": "context.system",
-		"summary": "Context packs, snapshots, and discovery surfaces.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: system\n- **File**: `packages/libs/contracts-spec/src/context/capabilities/contextSystem.capability.ts`",
-		"route": "/docs/reference/_common/context.system",
-		"source": "generated",
-		"contentPath": "_common/context.system.md"
-	},
-	{
-		"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/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/createUser",
-		"title": "createUser",
-		"summary": "- **Type**: operation (command)\n- **Version**: 1.0.0\n- **File**: `packages/libs/video-gen/src/docs/rendering.docblock.ts`\n```typescript\nexport const createUser = defineCommand({...})\n```",
-		"route": "/docs/reference/_common/createUser",
-		"source": "generated",
-		"contentPath": "_common/createUser.md"
-	},
-	{
-		"id": "_common/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/_common/database.context",
-		"source": "generated",
-		"contentPath": "_common/database.context.md"
-	},
-	{
-		"id": "_common/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/_common/database.dictionary.get",
-		"source": "generated",
-		"contentPath": "_common/database.dictionary.get.md"
-	},
-	{
-		"id": "_common/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/_common/database.migrations.list",
-		"source": "generated",
-		"contentPath": "_common/database.migrations.list.md"
-	},
-	{
-		"id": "_common/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/_common/database.query.readonly",
-		"source": "generated",
-		"contentPath": "_common/database.query.readonly.md"
-	},
-	{
-		"id": "_common/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/_common/database.schema.describe",
-		"source": "generated",
-		"contentPath": "_common/database.schema.describe.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-spec/src/docs/queries/contractReference.query.ts`",
-		"route": "/docs/reference/_common/docs.contract.reference",
-		"source": "generated",
-		"contentPath": "_common/docs.contract.reference.md"
-	},
-	{
-		"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-spec/src/docs/commands/docsGenerate.command.ts`",
-		"route": "/docs/reference/_common/docs.generate",
-		"source": "generated",
-		"contentPath": "_common/docs.generate.md"
-	},
-	{
-		"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-spec/src/docs/events/docsGenerated.event.ts`\n```typescript",
-		"route": "/docs/reference/_common/docs.generated",
-		"source": "generated",
-		"contentPath": "_common/docs.generated.md"
-	},
-	{
-		"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-spec/src/docs/presentations/docsLayout.presentation.ts`",
-		"route": "/docs/reference/_common/docs.layout",
-		"source": "generated",
-		"contentPath": "_common/docs.layout.md"
-	},
-	{
-		"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-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"
-	},
-	{
-		"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-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"
-	},
-	{
-		"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-spec/src/docs/presentations/docsReferencePage.presentation.ts`",
-		"route": "/docs/reference/_common/docs.reference.page",
-		"source": "generated",
-		"contentPath": "_common/docs.reference.page.md"
-	},
-	{
-		"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-spec/src/docs/queries/docsIndex.query.ts`",
-		"route": "/docs/reference/_common/docs.search",
-		"source": "generated",
-		"contentPath": "_common/docs.search.md"
-	},
-	{
-		"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-spec/src/docs/capabilities/documentationSystem.capability.ts`",
-		"route": "/docs/reference/_common/docs.system",
-		"source": "generated",
-		"contentPath": "_common/docs.system.md"
-	},
-	{
-		"id": "_common/docs.tech.contracts.capabilities",
-		"title": "CapabilitySpec Overview",
-		"summary": "Capabilities are **module interfaces** that define:\n1. What operations, events, and presentations a module exposes (`provides`)\n2. What other capabilities it depends on (`requires`)\n3. Inheritance hierarchies via `extends`",
-		"route": "/docs/reference/_common/docs.tech.contracts.capabilities",
-		"source": "generated",
-		"contentPath": "_common/docs.tech.contracts.capabilities.md"
-	},
-	{
-		"id": "_common/docs.tech.contracts.tests",
-		"title": "_common/docs.tech.contracts.tests",
-		"summary": "Use `TestSpec` to describe end-to-end scenarios for contracts and workflows. Specs live alongside your contracts and exercise the same OperationSpecRegistry handlers the app uses.\n- Types & registry: `packages/libs/contracts/src/tests/spec.ts`",
-		"route": "/docs/reference/_common/docs.tech.contracts.tests",
-		"source": "generated",
-		"contentPath": "_common/docs.tech.contracts.tests.md"
-	},
-	{
-		"id": "_common/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-spec` (`src/workflow/spec.ts`) so the same definition powers runtime execution, documentation, and future generation.",
-		"route": "/docs/reference/_common/docs.tech.workflows.overview",
-		"source": "generated",
-		"contentPath": "_common/docs.tech.workflows.overview.md"
-	},
-	{
-		"id": "_common/forms.rich-fields-showcase",
-		"title": "forms.rich-fields-showcase",
-		"summary": "Canonical showcase for readonly, autocomplete, address, phone, temporal, and repeated grouped fields.\n- **Type**: form (form)\n- **Version**: 1.0.0\n- **Tags**: forms, showcase\n- **File**: `packages/libs/contracts-spec/src/forms/richFieldsShowcase.form.ts`",
-		"route": "/docs/reference/_common/forms.rich-fields-showcase",
-		"source": "generated",
-		"contentPath": "_common/forms.rich-fields-showcase.md"
-	},
-	{
-		"id": "_common/init",
-		"title": "init",
-		"summary": "Sets up ContractSpec in a project (config, VSCode settings, etc.)\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @lssm/core\n- **Tags**: cli, setup\n- **File**: `packages/bundles/workspace/src/contracts/operations/init.operation.ts`",
-		"route": "/docs/reference/_common/init",
-		"source": "generated",
-		"contentPath": "_common/init.md"
-	},
-	{
-		"id": "_common/opencode.example.echo",
-		"title": "opencode.example.echo",
-		"summary": "Echo a prompt for the OpenCode CLI example.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @contractspec/examples\n- **Tags**: opencode, example, echo\n- **File**: `packages/examples/opencode-cli/src/contracts/opencode.contracts.ts`",
-		"route": "/docs/reference/_common/opencode.example.echo",
-		"source": "generated",
-		"contentPath": "_common/opencode.example.echo.md"
-	},
-	{
-		"id": "_common/provider-ranking.benchmark.custom.completed",
-		"title": "provider-ranking.benchmark.custom.completed",
-		"summary": "Emitted when a custom benchmark run finishes.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: custom, eval\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/events/benchmarkCustomCompleted.event.ts`",
-		"route": "/docs/reference/_common/provider-ranking.benchmark.custom.completed",
-		"source": "generated",
-		"contentPath": "_common/provider-ranking.benchmark.custom.completed.md"
-	},
-	{
-		"id": "_common/provider-ranking.benchmark.ingest",
-		"title": "provider-ranking.benchmark.ingest",
-		"summary": "Trigger ingestion of external benchmark data from a public source.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: ingest\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/commands/benchmarkIngest.command.ts`",
-		"route": "/docs/reference/_common/provider-ranking.benchmark.ingest",
-		"source": "generated",
-		"contentPath": "_common/provider-ranking.benchmark.ingest.md"
-	},
-	{
-		"id": "_common/provider-ranking.benchmark.ingested",
-		"title": "provider-ranking.benchmark.ingested",
-		"summary": "Emitted after external benchmark data is ingested.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: ingest\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/events/benchmarkIngested.event.ts`",
-		"route": "/docs/reference/_common/provider-ranking.benchmark.ingested",
-		"source": "generated",
-		"contentPath": "_common/provider-ranking.benchmark.ingested.md"
-	},
-	{
-		"id": "_common/provider-ranking.benchmark.results.list",
-		"title": "provider-ranking.benchmark.results.list",
-		"summary": "List raw benchmark results with pagination, filterable by source, model, and dimension.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: results\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/queries/benchmarkResultsList.query.ts`",
-		"route": "/docs/reference/_common/provider-ranking.benchmark.results.list",
-		"source": "generated",
-		"contentPath": "_common/provider-ranking.benchmark.results.list.md"
-	},
-	{
-		"id": "_common/provider-ranking.benchmark.run-custom",
-		"title": "provider-ranking.benchmark.run-custom",
-		"summary": "Launch a custom benchmark evaluation against a specific model.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: custom, eval\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/commands/benchmarkRunCustom.command.ts`",
-		"route": "/docs/reference/_common/provider-ranking.benchmark.run-custom",
-		"source": "generated",
-		"contentPath": "_common/provider-ranking.benchmark.run-custom.md"
-	},
-	{
-		"id": "_common/provider-ranking.model.comparison",
-		"title": "provider-ranking.model.comparison",
-		"summary": "Side-by-side comparison of AI model scores and capabilities.\n- **Type**: presentation (presentation)\n- **Version**: 1.0.0\n- **Tags**: comparison\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/presentations/modelComparison.presentation.ts`",
-		"route": "/docs/reference/_common/provider-ranking.model.comparison",
-		"source": "generated",
-		"contentPath": "_common/provider-ranking.model.comparison.md"
-	},
-	{
-		"id": "_common/provider-ranking.model.profile.get",
-		"title": "provider-ranking.model.profile.get",
-		"summary": "Get detailed profile for a single model including all scores, metadata, cost, and capabilities.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: model, profile\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/queries/modelProfileGet.query.ts`",
-		"route": "/docs/reference/_common/provider-ranking.model.profile.get",
-		"source": "generated",
-		"contentPath": "_common/provider-ranking.model.profile.get.md"
-	},
-	{
-		"id": "_common/provider-ranking.ranking.get",
-		"title": "provider-ranking.ranking.get",
-		"summary": "Get ranked list of providers/models with composite scores, filterable by dimension.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: leaderboard\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/queries/providerRankingGet.query.ts`",
-		"route": "/docs/reference/_common/provider-ranking.ranking.get",
-		"source": "generated",
-		"contentPath": "_common/provider-ranking.ranking.get.md"
-	},
-	{
-		"id": "_common/provider-ranking.ranking.refresh",
-		"title": "provider-ranking.ranking.refresh",
-		"summary": "Recompute composite rankings from latest benchmark data.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: refresh\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/commands/rankingRefresh.command.ts`",
-		"route": "/docs/reference/_common/provider-ranking.ranking.refresh",
-		"source": "generated",
-		"contentPath": "_common/provider-ranking.ranking.refresh.md"
-	},
-	{
-		"id": "_common/provider-ranking.ranking.updated",
-		"title": "provider-ranking.ranking.updated",
-		"summary": "Emitted when composite rankings are recomputed.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: refresh\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/events/rankingUpdated.event.ts`",
-		"route": "/docs/reference/_common/provider-ranking.ranking.updated",
-		"source": "generated",
-		"contentPath": "_common/provider-ranking.ranking.updated.md"
-	},
-	{
-		"id": "_common/provider-ranking.system",
-		"title": "provider-ranking.system",
-		"summary": "Benchmark ingestion, scoring, and ranking for AI providers and models.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: system\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/capabilities/providerRanking.capability.ts`",
-		"route": "/docs/reference/_common/provider-ranking.system",
-		"source": "generated",
-		"contentPath": "_common/provider-ranking.system.md"
-	},
-	{
-		"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-spec/src/operations/report/getContractVerificationStatus.ts`",
-		"route": "/docs/reference/_common/report.getContractVerificationStatus",
-		"source": "generated",
-		"contentPath": "_common/report.getContractVerificationStatus.md"
-	},
-	{
-		"id": "_common/template.messaging.core",
-		"title": "template.messaging.core",
-		"summary": "Real-time messaging primitives for template applications, including conversations, participants, and delivery events.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Owners**: platform.contractspec-studio",
-		"route": "/docs/reference/_common/template.messaging.core",
-		"source": "generated",
-		"contentPath": "_common/template.messaging.core.md"
-	},
-	{
-		"id": "_common/template.recipes.browse",
-		"title": "template.recipes.browse",
-		"summary": "Internationalized recipe browsing, search, and detail operations for template applications.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Owners**: platform.contractspec-studio\n- **Tags**: templates, recipes, i18n, content",
-		"route": "/docs/reference/_common/template.recipes.browse",
-		"source": "generated",
-		"contentPath": "_common/template.recipes.browse.md"
-	},
-	{
-		"id": "_common/template.todos.crud",
-		"title": "template.todos.crud",
-		"summary": "Create, read, update, delete, and toggle template tasks with categories and priorities.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Owners**: platform.contractspec-studio\n- **Tags**: templates, todos, productivity",
-		"route": "/docs/reference/_common/template.todos.crud",
-		"source": "generated",
-		"contentPath": "_common/template.todos.crud.md"
-	},
-	{
-		"id": "_common/test",
-		"title": "test",
-		"summary": "Run tests defined in contract specs\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @lssm/core\n- **Tags**: cli, test\n- **File**: `packages/bundles/workspace/src/contracts/operations/test.operation.ts`",
-		"route": "/docs/reference/_common/test",
-		"source": "generated",
-		"contentPath": "_common/test.md"
-	},
-	{
-		"id": "_common/user.create",
-		"title": "user.create",
-		"summary": "Create a new user account with the provided email\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @team\n- **Tags**: user\n- **File**: `packages/examples/minimal/src/contracts/user.ts`",
-		"route": "/docs/reference/_common/user.create",
-		"source": "generated",
-		"contentPath": "_common/user.create.md"
-	},
-	{
-		"id": "_common/validate",
-		"title": "validate",
-		"summary": "Validate a contract spec file structure and optionally its implementation\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @lssm/core\n- **Tags**: cli, validation\n- **File**: `packages/bundles/workspace/src/contracts/operations/validate.operation.ts`",
-		"route": "/docs/reference/_common/validate",
-		"source": "generated",
-		"contentPath": "_common/validate.md"
-	},
-	{
-		"id": "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/accessibility_wcag_compliance_specs",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/accessibility_wcag_compliance_specs.md",
-		"tags": ["accessibility_wcag_compliance_specs"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.meta.docblocks-process",
-		"title": "DocBlocks process",
-		"summary": "How to author goal/how/usage DocBlocks close to code.",
-		"route": "/docs/meta/docblocks-process",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/meta/docblocks-process.md",
-		"tags": ["docs", "process"],
-		"kind": "reference",
-		"visibility": "mixed"
-	},
-	{
-		"id": "docs.tech.acp.fs.access",
-		"title": "ACP file system access",
-		"summary": "Access file system through ACP.",
-		"route": "/docs/tech/acp/fs/access",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/acp/fs/access.md",
-		"tags": ["acp", "filesystem"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.acp.prompt.turn",
-		"title": "ACP prompt turn",
-		"summary": "Execute a prompt turn within a session.",
-		"route": "/docs/tech/acp/prompt/turn",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/acp/prompt/turn.md",
-		"tags": ["acp", "prompt"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.acp.session.init",
-		"title": "ACP session init",
-		"summary": "Initialize a new ACP session.",
-		"route": "/docs/tech/acp/session/init",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/acp/session/init.md",
-		"tags": ["acp", "session"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.acp.session.resume",
-		"title": "ACP session resume",
-		"summary": "Resume an existing ACP session.",
-		"route": "/docs/tech/acp/session/resume",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/acp/session/resume.md",
-		"tags": ["acp", "session"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.acp.session.stop",
-		"title": "ACP session stop",
-		"summary": "Stop an ACP session.",
-		"route": "/docs/tech/acp/session/stop",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/acp/session/stop.md",
-		"tags": ["acp", "session"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.acp.terminal.exec",
-		"title": "ACP terminal exec",
-		"summary": "Execute terminal commands via ACP.",
-		"route": "/docs/tech/acp/terminal/exec",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/acp/terminal/exec.md",
-		"tags": ["acp", "terminal"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.acp.tool.calls",
-		"title": "ACP tool calls",
-		"summary": "Execute ACP tool calls.",
-		"route": "/docs/tech/acp/tool/calls",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/acp/tool/calls.md",
-		"tags": ["acp", "tools"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.acp.transport",
-		"title": "ACP transport",
-		"summary": "Agent Client Protocol transport surfaces.",
-		"route": "/docs/tech/acp/transport",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/acp/transport.md",
-		"tags": ["acp", "transport"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.approval.requested",
-		"title": "Agent approval requested event",
-		"summary": "Emitted when approval is required.",
-		"route": "/docs/tech/agent/approval/requested",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/approval/requested.md",
-		"tags": ["agent", "event", "approval"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.approvals",
-		"title": "Agent approvals",
-		"summary": "Resolve an agent approval request.",
-		"route": "/docs/tech/agent/approvals",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/approvals.md",
-		"tags": ["agent", "approval"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.artifacts",
-		"title": "Agent artifacts",
-		"summary": "List artifacts produced by an agent run.",
-		"route": "/docs/tech/agent/artifacts",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/artifacts.md",
-		"tags": ["agent", "artifacts"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.cancel",
-		"title": "Cancel agent run",
-		"summary": "Cancel an in-flight agent run.",
-		"route": "/docs/tech/agent/cancel",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/cancel.md",
-		"tags": ["agent", "cancel"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.execution",
-		"title": "Agent execution",
-		"summary": "Background agent execution, approvals, and artifacts.",
-		"route": "/docs/tech/agent/execution",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/execution.md",
-		"tags": ["agent", "execution"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.memory-tools",
-		"title": "Memory tools",
-		"summary": "Model-accessible CRUD for agent memory and ephemeral knowledge.",
-		"route": "/docs/tech/agent/memory-tools",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/memory-tools.md",
-		"tags": ["agent", "memory", "tools"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.operations-as-tools",
-		"title": "Operations as tools",
-		"summary": "Reference ContractSpec operations as agent tools. One contract to many surfaces.",
-		"route": "/docs/tech/agent/operations-as-tools",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/operations-as-tools.md",
-		"tags": ["agent", "tools", "operations"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.run",
-		"title": "Run agent",
-		"summary": "Submit a background agent run.",
-		"route": "/docs/tech/agent/run",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/run.md",
-		"tags": ["agent", "run"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.run.audit",
-		"title": "Agent run audit presentation",
-		"summary": "Presentation spec for agent run audit views.",
-		"route": "/docs/tech/agent/run/audit",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/run/audit.md",
-		"tags": ["agent", "presentation", "audit"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.run.completed",
-		"title": "Agent run completed event",
-		"summary": "Emitted when an agent run completes.",
-		"route": "/docs/tech/agent/run/completed",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/run/completed.md",
-		"tags": ["agent", "event"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.run.failed",
-		"title": "Agent run failed event",
-		"summary": "Emitted when an agent run fails.",
-		"route": "/docs/tech/agent/run/failed",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/run/failed.md",
-		"tags": ["agent", "event"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.run.form",
-		"title": "Agent run form",
-		"summary": "Form specification for launching an agent run.",
-		"route": "/docs/tech/agent/run/form",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/run/form.md",
-		"tags": ["agent", "form"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.run.index",
-		"title": "Agent run index view",
-		"summary": "Data view for listing agent runs.",
-		"route": "/docs/tech/agent/run/index",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/run/index.md",
-		"tags": ["agent", "data-view"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.run.started",
-		"title": "Agent run started event",
-		"summary": "Emitted when an agent run starts.",
-		"route": "/docs/tech/agent/run/started",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/run/started.md",
-		"tags": ["agent", "event"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.status",
-		"title": "Agent status",
-		"summary": "Query agent run status.",
-		"route": "/docs/tech/agent/status",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/status.md",
-		"tags": ["agent", "status"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.subagents",
-		"title": "Subagents",
-		"summary": "Delegate tasks to subagents with streaming and isolated context.",
-		"route": "/docs/tech/agent/subagents",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/subagents.md",
-		"tags": ["agent", "subagents", "delegation"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.agent.workflow-integration",
-		"title": "Workflow-agent integration",
-		"summary": "Patterns for orchestrator-worker, workflow steps, and evaluator loops.",
-		"route": "/docs/tech/agent/workflow-integration",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/agent/workflow-integration.md",
-		"tags": ["agent", "workflow", "orchestrator"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.context.pack.describe",
-		"title": "Describe context pack",
-		"summary": "Describe a context pack and its sources.",
-		"route": "/docs/tech/context/pack/describe",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/context/pack/describe.md",
-		"tags": ["context", "pack", "describe"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.context.pack.search",
-		"title": "Search context packs",
-		"summary": "Search and filter context packs and snapshots.",
-		"route": "/docs/tech/context/pack/search",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/context/pack/search.md",
-		"tags": ["context", "pack", "search"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.context.pack.search.form",
-		"title": "Context pack search form",
-		"summary": "Form used to search context packs in UI surfaces.",
-		"route": "/docs/tech/context/pack/search-form",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/context/pack/search/form.md",
-		"tags": ["context", "form", "search"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.context.pack.snapshot",
-		"title": "Create context snapshot",
-		"summary": "Create an immutable context snapshot from a pack.",
-		"route": "/docs/tech/context/pack/snapshot",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/context/pack/snapshot.md",
-		"tags": ["context", "snapshot", "create"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.context.snapshot.created",
-		"title": "Context snapshot created event",
-		"summary": "Emitted when a context snapshot is created.",
-		"route": "/docs/tech/context/snapshot/created",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/context/snapshot/created.md",
-		"tags": ["context", "snapshot", "event"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.context.snapshot.index",
-		"title": "Context snapshot index view",
-		"summary": "Data view for listing context snapshots.",
-		"route": "/docs/tech/context/snapshot/index",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/context/snapshot/index.md",
-		"tags": ["context", "snapshot", "data-view"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.context.snapshot.presentation",
-		"title": "Context snapshot presentation",
-		"summary": "Presentation spec for snapshot summaries.",
-		"route": "/docs/tech/context/snapshot/presentation",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/context/snapshot/presentation.md",
-		"tags": ["context", "presentation", "snapshot"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.context.system",
-		"title": "Context system",
-		"summary": "Context packs, snapshots, and discovery surfaces.",
-		"route": "/docs/tech/context/system",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/context/system.md",
-		"tags": ["context", "system", "snapshot"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.app-config",
-		"title": "App Configuration Layers",
-		"summary": "App orchestration is split into three explicit layers:",
-		"route": "/docs/tech/contracts/app-config",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/app-config.md",
-		"tags": ["tech", "contracts", "app-config"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.capabilities",
-		"title": "CapabilitySpec Overview",
-		"summary": "Capability specs define what a module provides (operations, events, presentations) and requires (dependencies). They enable bidirectional linking, inheritance, runtime enforcement, and automated validation.",
-		"route": "/docs/tech/contracts/capabilities",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/capabilities.md",
-		"tags": ["tech", "contracts", "capabilities"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.data-views",
-		"title": "DataViewSpec Overview",
-		"summary": "`DataViewSpec` is the declarative contract for projecting entities into list/detail/table/grid experiences. Each spec ties to contract operations (`source.primary`, `source.item`) and describes how the UI should present, sort, filter, paginate, and pin records. Host applications use the spec to render UI with shared components (`DataViewRenderer`, `DataViewList`, `DataViewTable`, `DataViewDetail`) while keeping presentation logic in a single source of truth.",
-		"route": "/docs/tech/contracts/data-views",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/data-views.md",
-		"tags": ["tech", "contracts", "data-views"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.examples",
-		"title": "Example Specifications",
-		"summary": "ExampleSpec defines complete, demonstrable ContractSpec applications.",
-		"route": "/docs/tech/contracts/examples",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/examples.md",
-		"tags": ["tech", "contracts", "examples", "templates"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.experiments",
-		"title": "ExperimentSpec & ExperimentEvaluator",
-		"summary": "Use experiments to test alternative workflows, data views, or themes with controlled allocations and measurable outcomes.",
-		"route": "/docs/tech/contracts/experiments",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/experiments.md",
-		"tags": ["tech", "contracts", "experiments"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.forms",
-		"title": "Contracts: FormSpec",
-		"summary": "This document defines the canonical contracts for declarative forms.",
-		"route": "/docs/tech/contracts/forms",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/forms.md",
-		"tags": ["tech", "contracts", "forms"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.knowledge",
-		"title": "Knowledge Layer",
-		"summary": "The knowledge layer turns unstructured inputs (uploads, email threads,",
-		"route": "/docs/tech/contracts/knowledge",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/knowledge.md",
-		"tags": ["tech", "contracts", "knowledge"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.migrations",
-		"title": "MigrationSpec Overview",
-		"summary": "`MigrationSpec` provides a declarative plan for schema/data/validation steps so migrations can be generated, reviewed, and executed safely by tooling. Each spec captures ownership metadata, ordered up/down steps, and optional dependency information. Runtime tooling can consume the spec to run SQL/data scripts with pre/post checks and produce audit logs.",
-		"route": "/docs/tech/contracts/migrations",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/migrations.md",
-		"tags": ["tech", "contracts", "migrations"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.openapi-export",
-		"title": "OpenAPI export (OpenAPI 3.1) from OperationSpecRegistry",
-		"summary": "Generate a deterministic OpenAPI document from a OperationSpecRegistry using jsonSchemaForSpec + REST transport metadata.",
-		"route": "/docs/tech/contracts/openapi-export",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/openapi-export.md",
-		"tags": ["contracts", "openapi", "rest"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.ops-to-presentation-linking",
-		"title": "Ops ↔ Presentation linking (V2)",
-		"summary": "This document explains how operations (OperationSpec) are linked to Presentations (PresentationSpec) via Feature modules.",
-		"route": "/docs/tech/contracts/ops-to-presentation-linking",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/ops-to-presentation-linking.md",
-		"tags": ["tech", "contracts", "ops-to-presentation-linking"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.policy",
-		"title": "PolicySpec & PolicyEngine",
-		"summary": "`PolicySpec` gives a declarative, typed home for access-control logic covering:",
-		"route": "/docs/tech/contracts/policy",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/policy.md",
-		"tags": ["tech", "contracts", "policy"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.presentations",
-		"title": "Presentations — Unified Descriptor & Transform Engine",
-		"summary": "How PresentationSpec and TransformEngine keep docs/renderers consistent.",
-		"route": "/docs/tech/contracts/presentations",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/presentations.md",
-		"tags": ["presentations", "docs", "mcp"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.presentations-conventions",
-		"title": "Presentations Conventions (A11y & i18n)",
-		"summary": "- Always provide `meta.description` (≥ 3 chars) — used by a11y/docs/agents.",
-		"route": "/docs/tech/contracts/presentations-conventions",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/presentations-conventions.md",
-		"tags": ["tech", "contracts", "presentations-conventions"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.README",
-		"title": "Contracts: Specs, Registry, Handlers, Adapters",
-		"summary": "- `packages/lssm/libs/contracts` defines the contracts core (OperationSpecRegistry, OperationSpec, PresentationSpec, install helpers, REST/MCP adapters, ...).",
-		"route": "/docs/tech/contracts/README",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/README.md",
-		"tags": ["tech", "contracts", "README"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.regenerator",
-		"title": "Regenerator Service",
-		"summary": "The Regenerator daemon observes telemetry, error, and behavior streams, then suggests spec-level changes (not code patches) that can be reviewed and applied through the App Studio.",
-		"route": "/docs/tech/contracts/regenerator",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/regenerator.md",
-		"tags": ["tech", "contracts", "regenerator"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.telemetry",
-		"title": "TelemetrySpec",
-		"summary": "Telemetry specs describe product analytics in a durable, type-safe way. They reference existing `EventSpec`s (same name/version) but layer on privacy classification, retention, sampling, and anomaly detection so instrumentation stays compliant and observable.",
-		"route": "/docs/tech/contracts/telemetry",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/telemetry.md",
-		"tags": ["tech", "contracts", "telemetry"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.tests",
-		"title": "TestSpec & TestRunner",
-		"summary": "Use `TestSpec` to describe end-to-end scenarios for contracts and workflows. Specs live alongside your contracts and exercise the same OperationSpecRegistry handlers the app uses.",
-		"route": "/docs/tech/contracts/tests",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/tests.md",
-		"tags": ["tech", "contracts", "tests"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.themes",
-		"title": "ThemeSpec Overview",
-		"summary": "`ThemeSpec` defines a structured, versioned source of truth for design tokens, component variants, and scoped overrides. Use it to describe how tenants or individual users should experience the design system without hand-maintaining ad-hoc theme files. Specs live in `@contractspec/lib.contracts-spec`, making them accessible to generators, docs, and runtime tooling.",
-		"route": "/docs/tech/contracts/themes",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/themes.md",
-		"tags": ["tech", "contracts", "themes"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.contracts.workspace-config",
-		"title": "Workspace Configuration (.contractsrc)",
-		"summary": "Configuration-as-code conventions for ContractSpec workspaces (`.contractsrc.json`).",
-		"route": "/docs/tech/contracts/workspace-config",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/contracts/workspace-config.md",
-		"tags": ["tech", "contracts", "config"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.database.context",
-		"title": "Database context",
-		"summary": "Schema, migrations, dictionary, and read-only query surfaces.",
-		"route": "/docs/tech/database/context",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/database/context.md",
-		"tags": ["database", "context"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.database.dictionary.get",
-		"title": "Get data dictionary entry",
-		"summary": "Retrieve a dictionary entry for a schema field.",
-		"route": "/docs/tech/database/dictionary/get",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/database/dictionary/get.md",
-		"tags": ["database", "dictionary"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.database.migrations.list",
-		"title": "List database migrations",
-		"summary": "List migration history for a database.",
-		"route": "/docs/tech/database/migrations/list",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/database/migrations/list.md",
-		"tags": ["database", "migrations"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.database.query.readonly",
-		"title": "Read-only data query",
-		"summary": "Perform a governed read-only query via data views.",
-		"route": "/docs/tech/database/query/readonly",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/database/query/readonly.md",
-		"tags": ["database", "query", "readonly"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.database.schema.describe",
-		"title": "Describe database schema",
-		"summary": "Describe schemas and models with PII signals.",
-		"route": "/docs/tech/database/schema/describe",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/database/schema/describe.md",
-		"tags": ["database", "schema"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.database.schema.index",
-		"title": "Database schema index view",
-		"summary": "Data view for listing schemas and model counts.",
-		"route": "/docs/tech/database/schema/index",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/database/schema/index.md",
-		"tags": ["database", "data-view"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.docs-examples",
-		"title": "Examples catalog",
-		"summary": "Document and surface example projects with sandbox support.",
-		"route": "/docs/tech/docs/examples",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/docs-examples.md",
-		"tags": ["docs", "examples"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.docs-generator",
-		"title": "Docs generator",
-		"summary": "Generate reference docs and metadata from ContractSpecs.",
-		"route": "/docs/tech/docs/generator",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/docs-generator.md",
-		"tags": ["docs", "generator", "cli"],
-		"kind": "how",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.docs-publish",
-		"title": "Docs publish",
-		"summary": "Publish generated artifacts to the docs host.",
-		"route": "/docs/tech/docs/publish",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/docs-publish.md",
-		"tags": ["docs", "publish"],
-		"kind": "how",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.docs-reference",
-		"title": "Contract reference pages",
-		"summary": "Resolve any spec into a docs-ready reference payload.",
-		"route": "/docs/tech/docs/reference",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/docs-reference.md",
-		"tags": ["docs", "reference"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.docs-search",
-		"title": "Docs index and search",
-		"summary": "Search DocBlocks by query, tag, kind, or visibility.",
-		"route": "/docs/tech/docs/search",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/docs-search.md",
-		"tags": ["docs", "search"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.docs-system",
-		"title": "Docs system overview",
-		"summary": "How ContractSpec generates, indexes, and presents documentation.",
-		"route": "/docs/tech/docs/system",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/docs-system.md",
-		"tags": ["docs", "system", "contracts"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.provider-ranking.benchmark.custom.completed",
-		"title": "Custom benchmark completed event",
-		"summary": "Emitted when a custom benchmark run finishes.",
-		"route": "/docs/tech/provider-ranking/benchmark/custom/completed",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/provider-ranking/benchmark/custom/completed.md",
-		"tags": ["ai", "ranking", "event", "custom"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.provider-ranking.benchmark.ingest",
-		"title": "Ingest benchmark data",
-		"summary": "Trigger ingestion of external benchmark data.",
-		"route": "/docs/tech/provider-ranking/benchmark/ingest",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/provider-ranking/benchmark/ingest.md",
-		"tags": ["ai", "ranking", "ingest"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.provider-ranking.benchmark.ingest.form",
-		"title": "Benchmark ingest form",
-		"summary": "Form specification for triggering benchmark ingestion.",
-		"route": "/docs/tech/provider-ranking/benchmark/ingest/form",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/provider-ranking/benchmark/ingest/form.md",
-		"tags": ["ai", "ranking", "form"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.provider-ranking.benchmark.ingested",
-		"title": "Benchmark ingested event",
-		"summary": "Emitted after external benchmark data is ingested.",
-		"route": "/docs/tech/provider-ranking/benchmark/ingested",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/provider-ranking/benchmark/ingested.md",
-		"tags": ["ai", "ranking", "event"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.provider-ranking.benchmark.results.index",
-		"title": "Benchmark results view",
-		"summary": "Data view for raw benchmark results.",
-		"route": "/docs/tech/provider-ranking/benchmark/results/index",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/provider-ranking/benchmark/results/index.md",
-		"tags": ["ai", "ranking", "data-view"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.provider-ranking.benchmark.results.list",
-		"title": "List benchmark results",
-		"summary": "List raw benchmark results.",
-		"route": "/docs/tech/provider-ranking/benchmark/results/list",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/provider-ranking/benchmark/results/list.md",
-		"tags": ["ai", "ranking", "results"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.provider-ranking.benchmark.run-custom",
-		"title": "Run custom benchmark",
-		"summary": "Launch a custom benchmark evaluation against a model.",
-		"route": "/docs/tech/provider-ranking/benchmark/run-custom",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/provider-ranking/benchmark/run-custom.md",
-		"tags": ["ai", "ranking", "custom", "eval"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.provider-ranking.benchmark.run-custom.form",
-		"title": "Custom benchmark form",
-		"summary": "Form specification for launching custom benchmarks.",
-		"route": "/docs/tech/provider-ranking/benchmark/run-custom/form",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/provider-ranking/benchmark/run-custom/form.md",
-		"tags": ["ai", "ranking", "form"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.provider-ranking.model.comparison",
-		"title": "Model comparison presentation",
-		"summary": "Presentation spec for side-by-side model comparison.",
-		"route": "/docs/tech/provider-ranking/model/comparison",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/provider-ranking/model/comparison.md",
-		"tags": ["ai", "ranking", "presentation", "comparison"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.provider-ranking.model.profile.get",
-		"title": "Get model profile",
-		"summary": "Get detailed profile for a single model.",
-		"route": "/docs/tech/provider-ranking/model/profile/get",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/provider-ranking/model/profile/get.md",
-		"tags": ["ai", "ranking", "model", "profile"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.provider-ranking.ranking.get",
-		"title": "Get provider rankings",
-		"summary": "Get ranked list of providers and models.",
-		"route": "/docs/tech/provider-ranking/ranking/get",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/provider-ranking/ranking/get.md",
-		"tags": ["ai", "ranking", "leaderboard"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.provider-ranking.ranking.index",
-		"title": "Provider rankings view",
-		"summary": "Data view for the model leaderboard.",
-		"route": "/docs/tech/provider-ranking/ranking/index",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/provider-ranking/ranking/index.md",
-		"tags": ["ai", "ranking", "data-view"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.provider-ranking.ranking.refresh",
-		"title": "Refresh rankings",
-		"summary": "Recompute composite rankings from latest benchmark data.",
-		"route": "/docs/tech/provider-ranking/ranking/refresh",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/provider-ranking/ranking/refresh.md",
-		"tags": ["ai", "ranking", "refresh"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.provider-ranking.ranking.updated",
-		"title": "Ranking updated event",
-		"summary": "Emitted when composite rankings are recomputed.",
-		"route": "/docs/tech/provider-ranking/ranking/updated",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/provider-ranking/ranking/updated.md",
-		"tags": ["ai", "ranking", "event"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.provider-ranking.system",
-		"title": "AI Provider Ranking",
-		"summary": "Benchmark ingestion, scoring, and ranking for AI providers and models.",
-		"route": "/docs/tech/provider-ranking/system",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/provider-ranking/system.md",
-		"tags": ["ai", "ranking", "benchmark"],
-		"kind": "reference",
-		"visibility": "public"
-	},
-	{
-		"id": "docs.tech.report-verification-table",
-		"title": "Contract Verification Table",
-		"summary": "How the impact report renders per-contract verification status.",
-		"route": "/docs/tech/report/verification-table",
-		"source": "docblock",
-		"contentPath": "docblocks/docs/tech/report-verification-table.md",
-		"tags": ["report", "drift", "verification", "impact"],
-		"kind": "how",
-		"visibility": "public",
-		"owners": ["platform.core"]
-	},
-	{
-		"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, including runtime adapter capabilities/ports for checkpointing, suspend-resume orchestration, and explicit waiting/retry states. 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"],
-		"kind": "reference",
-		"visibility": "public"
-	}
-]
+  {
+    "id": "_common/acp.fs.access",
+    "title": "acp.fs.access",
+    "summary": "Perform file system access within an ACP session.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: filesystem\n- **File**: `packages/libs/contracts-spec/src/acp/commands/acpFsAccess.command.ts`",
+    "route": "/docs/reference/_common/acp.fs.access",
+    "source": "generated",
+    "contentPath": "_common/acp.fs.access.md"
+  },
+  {
+    "id": "_common/acp.prompt.turn",
+    "title": "acp.prompt.turn",
+    "summary": "Execute a prompt turn within an ACP session.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: prompt\n- **File**: `packages/libs/contracts-spec/src/acp/commands/acpPromptTurn.command.ts`\nRun ACP prompt turns with tool calls and structured outputs.",
+    "route": "/docs/reference/_common/acp.prompt.turn",
+    "source": "generated",
+    "contentPath": "_common/acp.prompt.turn.md"
+  },
+  {
+    "id": "_common/acp.session.init",
+    "title": "acp.session.init",
+    "summary": "Initialize a new ACP session.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: session\n- **File**: `packages/libs/contracts-spec/src/acp/commands/acpSessionInit.command.ts`\nStart a governed ACP session with configured tools and policies.",
+    "route": "/docs/reference/_common/acp.session.init",
+    "source": "generated",
+    "contentPath": "_common/acp.session.init.md"
+  },
+  {
+    "id": "_common/acp.session.resume",
+    "title": "acp.session.resume",
+    "summary": "Resume an existing ACP session.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: session\n- **File**: `packages/libs/contracts-spec/src/acp/commands/acpSessionResume.command.ts`\nContinue a previously initialized ACP session with full context.",
+    "route": "/docs/reference/_common/acp.session.resume",
+    "source": "generated",
+    "contentPath": "_common/acp.session.resume.md"
+  },
+  {
+    "id": "_common/acp.session.stop",
+    "title": "acp.session.stop",
+    "summary": "Stop an active ACP session.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: session\n- **File**: `packages/libs/contracts-spec/src/acp/commands/acpSessionStop.command.ts`\nTerminate ACP sessions cleanly with audit trails.",
+    "route": "/docs/reference/_common/acp.session.stop",
+    "source": "generated",
+    "contentPath": "_common/acp.session.stop.md"
+  },
+  {
+    "id": "_common/acp.terminal.exec",
+    "title": "acp.terminal.exec",
+    "summary": "Execute a terminal command within an ACP session.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: terminal\n- **File**: `packages/libs/contracts-spec/src/acp/commands/acpTerminalExec.command.ts`",
+    "route": "/docs/reference/_common/acp.terminal.exec",
+    "source": "generated",
+    "contentPath": "_common/acp.terminal.exec.md"
+  },
+  {
+    "id": "_common/acp.tool.calls",
+    "title": "acp.tool.calls",
+    "summary": "Execute tool calls within an ACP session.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: tools\n- **File**: `packages/libs/contracts-spec/src/acp/commands/acpToolCalls.command.ts`\nRun tool calls with safe governance and telemetry.",
+    "route": "/docs/reference/_common/acp.tool.calls",
+    "source": "generated",
+    "contentPath": "_common/acp.tool.calls.md"
+  },
+  {
+    "id": "_common/acp.transport",
+    "title": "acp.transport",
+    "summary": "Agent Client Protocol transport surfaces.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: transport\n- **File**: `packages/libs/contracts-spec/src/acp/capabilities/acpTransport.capability.ts`",
+    "route": "/docs/reference/_common/acp.transport",
+    "source": "generated",
+    "contentPath": "_common/acp.transport.md"
+  },
+  {
+    "id": "_common/AddNumbersSpec",
+    "title": "AddNumbersSpec",
+    "summary": "- **Type**: operation (command)\n- **Version**: 1.0.0\n- **File**: `packages/libs/contracts-spec/src/tests/spec.ts`\n```typescript\nimport { compareVersions } from 'compare-versions';\nimport type { DocBlock } from '../docs/types';",
+    "route": "/docs/reference/_common/AddNumbersSpec",
+    "source": "generated",
+    "contentPath": "_common/AddNumbersSpec.md"
+  },
+  {
+    "id": "_common/agent.approval.requested",
+    "title": "agent.approval.requested",
+    "summary": "Emitted when an approval is required for an agent action.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: approval\n- **File**: `packages/libs/contracts-spec/src/agent/events/agentApprovalRequested.event.ts`",
+    "route": "/docs/reference/_common/agent.approval.requested",
+    "source": "generated",
+    "contentPath": "_common/agent.approval.requested.md"
+  },
+  {
+    "id": "_common/agent.approvals",
+    "title": "agent.approvals",
+    "summary": "Approve or reject an agent step or run.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: approval\n- **File**: `packages/libs/contracts-spec/src/agent/commands/agentApprovals.command.ts`\nProvide governed human-in-the-loop control for risky steps.",
+    "route": "/docs/reference/_common/agent.approvals",
+    "source": "generated",
+    "contentPath": "_common/agent.approvals.md"
+  },
+  {
+    "id": "_common/agent.artifacts",
+    "title": "agent.artifacts",
+    "summary": "List artifacts produced by an agent run.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: artifacts\n- **File**: `packages/libs/contracts-spec/src/agent/queries/agentArtifacts.query.ts`\nProvide traceable outputs for audits and UI surfaces.",
+    "route": "/docs/reference/_common/agent.artifacts",
+    "source": "generated",
+    "contentPath": "_common/agent.artifacts.md"
+  },
+  {
+    "id": "_common/agent.cancel",
+    "title": "agent.cancel",
+    "summary": "Cancel an in-flight agent run.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: run, cancel\n- **File**: `packages/libs/contracts-spec/src/agent/commands/agentCancel.command.ts`\nProvide safe operator control to stop background agents.",
+    "route": "/docs/reference/_common/agent.cancel",
+    "source": "generated",
+    "contentPath": "_common/agent.cancel.md"
+  },
+  {
+    "id": "_common/agent.execution",
+    "title": "agent.execution",
+    "summary": "Background agent execution, approvals, and artifacts.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: execution\n- **File**: `packages/libs/contracts-spec/src/agent/capabilities/agentExecution.capability.ts`",
+    "route": "/docs/reference/_common/agent.execution",
+    "source": "generated",
+    "contentPath": "_common/agent.execution.md"
+  },
+  {
+    "id": "_common/agent.run",
+    "title": "agent.run",
+    "summary": "Submit a background agent run with a context snapshot.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: run\n- **File**: `packages/libs/contracts-spec/src/agent/commands/agentRun.command.ts`",
+    "route": "/docs/reference/_common/agent.run",
+    "source": "generated",
+    "contentPath": "_common/agent.run.md"
+  },
+  {
+    "id": "_common/agent.run.audit",
+    "title": "agent.run.audit",
+    "summary": "Audit layout for agent runs and artifacts.\n- **Type**: presentation (presentation)\n- **Version**: 1.0.0\n- **Tags**: audit\n- **File**: `packages/libs/contracts-spec/src/agent/presentations/agentRunAudit.presentation.ts`",
+    "route": "/docs/reference/_common/agent.run.audit",
+    "source": "generated",
+    "contentPath": "_common/agent.run.audit.md"
+  },
+  {
+    "id": "_common/agent.run.completed",
+    "title": "agent.run.completed",
+    "summary": "Emitted when an agent run completes successfully.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: run\n- **File**: `packages/libs/contracts-spec/src/agent/events/agentRunCompleted.event.ts`\n```typescript",
+    "route": "/docs/reference/_common/agent.run.completed",
+    "source": "generated",
+    "contentPath": "_common/agent.run.completed.md"
+  },
+  {
+    "id": "_common/agent.run.failed",
+    "title": "agent.run.failed",
+    "summary": "Emitted when an agent run fails.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: run\n- **File**: `packages/libs/contracts-spec/src/agent/events/agentRunFailed.event.ts`\n```typescript\nexport const AgentRunFailedEvent = defineEvent({",
+    "route": "/docs/reference/_common/agent.run.failed",
+    "source": "generated",
+    "contentPath": "_common/agent.run.failed.md"
+  },
+  {
+    "id": "_common/agent.run.started",
+    "title": "agent.run.started",
+    "summary": "Emitted when an agent run starts executing.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: run\n- **File**: `packages/libs/contracts-spec/src/agent/events/agentRunStarted.event.ts`\n```typescript\nexport const AgentRunStartedEvent = defineEvent({",
+    "route": "/docs/reference/_common/agent.run.started",
+    "source": "generated",
+    "contentPath": "_common/agent.run.started.md"
+  },
+  {
+    "id": "_common/agent.status",
+    "title": "agent.status",
+    "summary": "Get status for agent runs.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: status\n- **File**: `packages/libs/contracts-spec/src/agent/queries/agentStatus.query.ts`\nProvide status and progress visibility for background agents.",
+    "route": "/docs/reference/_common/agent.status",
+    "source": "generated",
+    "contentPath": "_common/agent.status.md"
+  },
+  {
+    "id": "_common/context.pack.describe",
+    "title": "context.pack.describe",
+    "summary": "Describe a context pack and its sources.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: pack, describe\n- **File**: `packages/libs/contracts-spec/src/context/queries/contextPackDescribe.query.ts`",
+    "route": "/docs/reference/_common/context.pack.describe",
+    "source": "generated",
+    "contentPath": "_common/context.pack.describe.md"
+  },
+  {
+    "id": "_common/context.pack.search",
+    "title": "context.pack.search",
+    "summary": "Search and filter context packs and snapshots.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: pack, search\n- **File**: `packages/libs/contracts-spec/src/context/queries/contextPackSearch.query.ts`",
+    "route": "/docs/reference/_common/context.pack.search",
+    "source": "generated",
+    "contentPath": "_common/context.pack.search.md"
+  },
+  {
+    "id": "_common/context.pack.snapshot",
+    "title": "context.pack.snapshot",
+    "summary": "Create an immutable snapshot from a context pack.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: snapshot, create\n- **File**: `packages/libs/contracts-spec/src/context/commands/contextPackSnapshot.command.ts`",
+    "route": "/docs/reference/_common/context.pack.snapshot",
+    "source": "generated",
+    "contentPath": "_common/context.pack.snapshot.md"
+  },
+  {
+    "id": "_common/context.snapshot.created",
+    "title": "context.snapshot.created",
+    "summary": "Emitted when a context snapshot is created.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: snapshot\n- **File**: `packages/libs/contracts-spec/src/context/events/contextSnapshotCreated.event.ts`",
+    "route": "/docs/reference/_common/context.snapshot.created",
+    "source": "generated",
+    "contentPath": "_common/context.snapshot.created.md"
+  },
+  {
+    "id": "_common/context.snapshot.summary",
+    "title": "context.snapshot.summary",
+    "summary": "Summary layout for context snapshots.\n- **Type**: presentation (presentation)\n- **Version**: 1.0.0\n- **Tags**: snapshot, summary\n- **File**: `packages/libs/contracts-spec/src/context/presentations/contextSnapshot.presentation.ts`",
+    "route": "/docs/reference/_common/context.snapshot.summary",
+    "source": "generated",
+    "contentPath": "_common/context.snapshot.summary.md"
+  },
+  {
+    "id": "_common/context.system",
+    "title": "context.system",
+    "summary": "Context packs, snapshots, and discovery surfaces.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: system\n- **File**: `packages/libs/contracts-spec/src/context/capabilities/contextSystem.capability.ts`",
+    "route": "/docs/reference/_common/context.system",
+    "source": "generated",
+    "contentPath": "_common/context.system.md"
+  },
+  {
+    "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/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/createUser",
+    "title": "createUser",
+    "summary": "- **Type**: operation (command)\n- **Version**: 1.0.0\n- **File**: `packages/libs/video-gen/src/docs/rendering.docblock.ts`\n```typescript\nexport const createUser = defineCommand({...})\n```",
+    "route": "/docs/reference/_common/createUser",
+    "source": "generated",
+    "contentPath": "_common/createUser.md"
+  },
+  {
+    "id": "_common/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/_common/database.context",
+    "source": "generated",
+    "contentPath": "_common/database.context.md"
+  },
+  {
+    "id": "_common/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/_common/database.dictionary.get",
+    "source": "generated",
+    "contentPath": "_common/database.dictionary.get.md"
+  },
+  {
+    "id": "_common/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/_common/database.migrations.list",
+    "source": "generated",
+    "contentPath": "_common/database.migrations.list.md"
+  },
+  {
+    "id": "_common/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/_common/database.query.readonly",
+    "source": "generated",
+    "contentPath": "_common/database.query.readonly.md"
+  },
+  {
+    "id": "_common/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/_common/database.schema.describe",
+    "source": "generated",
+    "contentPath": "_common/database.schema.describe.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-spec/src/docs/queries/contractReference.query.ts`",
+    "route": "/docs/reference/_common/docs.contract.reference",
+    "source": "generated",
+    "contentPath": "_common/docs.contract.reference.md"
+  },
+  {
+    "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-spec/src/docs/commands/docsGenerate.command.ts`",
+    "route": "/docs/reference/_common/docs.generate",
+    "source": "generated",
+    "contentPath": "_common/docs.generate.md"
+  },
+  {
+    "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-spec/src/docs/events/docsGenerated.event.ts`\n```typescript",
+    "route": "/docs/reference/_common/docs.generated",
+    "source": "generated",
+    "contentPath": "_common/docs.generated.md"
+  },
+  {
+    "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-spec/src/docs/presentations/docsLayout.presentation.ts`",
+    "route": "/docs/reference/_common/docs.layout",
+    "source": "generated",
+    "contentPath": "_common/docs.layout.md"
+  },
+  {
+    "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-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"
+  },
+  {
+    "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-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"
+  },
+  {
+    "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-spec/src/docs/presentations/docsReferencePage.presentation.ts`",
+    "route": "/docs/reference/_common/docs.reference.page",
+    "source": "generated",
+    "contentPath": "_common/docs.reference.page.md"
+  },
+  {
+    "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-spec/src/docs/queries/docsIndex.query.ts`",
+    "route": "/docs/reference/_common/docs.search",
+    "source": "generated",
+    "contentPath": "_common/docs.search.md"
+  },
+  {
+    "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-spec/src/docs/capabilities/documentationSystem.capability.ts`",
+    "route": "/docs/reference/_common/docs.system",
+    "source": "generated",
+    "contentPath": "_common/docs.system.md"
+  },
+  {
+    "id": "_common/docs.tech.contracts.capabilities",
+    "title": "CapabilitySpec Overview",
+    "summary": "Capabilities are **module interfaces** that define:\n1. What operations, events, and presentations a module exposes (`provides`)\n2. What other capabilities it depends on (`requires`)\n3. Inheritance hierarchies via `extends`",
+    "route": "/docs/reference/_common/docs.tech.contracts.capabilities",
+    "source": "generated",
+    "contentPath": "_common/docs.tech.contracts.capabilities.md"
+  },
+  {
+    "id": "_common/docs.tech.contracts.tests",
+    "title": "_common/docs.tech.contracts.tests",
+    "summary": "Use `TestSpec` to describe end-to-end scenarios for contracts and workflows. Specs live alongside your contracts and exercise the same OperationSpecRegistry handlers the app uses.\n- Types & registry: `packages/libs/contracts/src/tests/spec.ts`",
+    "route": "/docs/reference/_common/docs.tech.contracts.tests",
+    "source": "generated",
+    "contentPath": "_common/docs.tech.contracts.tests.md"
+  },
+  {
+    "id": "_common/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-spec` (`src/workflow/spec.ts`) so the same definition powers runtime execution, documentation, and future generation.",
+    "route": "/docs/reference/_common/docs.tech.workflows.overview",
+    "source": "generated",
+    "contentPath": "_common/docs.tech.workflows.overview.md"
+  },
+  {
+    "id": "_common/forms.rich-fields-showcase",
+    "title": "forms.rich-fields-showcase",
+    "summary": "Canonical showcase for readonly, password, autocomplete, address, phone, temporal, and repeated grouped fields.\n- **Type**: form (form)\n- **Version**: 1.0.0\n- **Tags**: forms, showcase\n- **File**: `packages/libs/contracts-spec/src/forms/richFieldsShowcase.form.ts`",
+    "route": "/docs/reference/_common/forms.rich-fields-showcase",
+    "source": "generated",
+    "contentPath": "_common/forms.rich-fields-showcase.md"
+  },
+  {
+    "id": "_common/init",
+    "title": "init",
+    "summary": "Sets up ContractSpec in a project (config, VSCode settings, etc.)\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @lssm/core\n- **Tags**: cli, setup\n- **File**: `packages/bundles/workspace/src/contracts/operations/init.operation.ts`",
+    "route": "/docs/reference/_common/init",
+    "source": "generated",
+    "contentPath": "_common/init.md"
+  },
+  {
+    "id": "_common/opencode.example.echo",
+    "title": "opencode.example.echo",
+    "summary": "Echo a prompt for the OpenCode CLI example.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: experimental\n- **Owners**: @contractspec/examples\n- **Tags**: opencode, example, echo\n- **File**: `packages/examples/opencode-cli/src/contracts/opencode.contracts.ts`",
+    "route": "/docs/reference/_common/opencode.example.echo",
+    "source": "generated",
+    "contentPath": "_common/opencode.example.echo.md"
+  },
+  {
+    "id": "_common/provider-ranking.benchmark.custom.completed",
+    "title": "provider-ranking.benchmark.custom.completed",
+    "summary": "Emitted when a custom benchmark run finishes.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: custom, eval\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/events/benchmarkCustomCompleted.event.ts`",
+    "route": "/docs/reference/_common/provider-ranking.benchmark.custom.completed",
+    "source": "generated",
+    "contentPath": "_common/provider-ranking.benchmark.custom.completed.md"
+  },
+  {
+    "id": "_common/provider-ranking.benchmark.ingest",
+    "title": "provider-ranking.benchmark.ingest",
+    "summary": "Trigger ingestion of external benchmark data from a public source.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: ingest\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/commands/benchmarkIngest.command.ts`",
+    "route": "/docs/reference/_common/provider-ranking.benchmark.ingest",
+    "source": "generated",
+    "contentPath": "_common/provider-ranking.benchmark.ingest.md"
+  },
+  {
+    "id": "_common/provider-ranking.benchmark.ingested",
+    "title": "provider-ranking.benchmark.ingested",
+    "summary": "Emitted after external benchmark data is ingested.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: ingest\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/events/benchmarkIngested.event.ts`",
+    "route": "/docs/reference/_common/provider-ranking.benchmark.ingested",
+    "source": "generated",
+    "contentPath": "_common/provider-ranking.benchmark.ingested.md"
+  },
+  {
+    "id": "_common/provider-ranking.benchmark.results.list",
+    "title": "provider-ranking.benchmark.results.list",
+    "summary": "List raw benchmark results with pagination, filterable by source, model, and dimension.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: results\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/queries/benchmarkResultsList.query.ts`",
+    "route": "/docs/reference/_common/provider-ranking.benchmark.results.list",
+    "source": "generated",
+    "contentPath": "_common/provider-ranking.benchmark.results.list.md"
+  },
+  {
+    "id": "_common/provider-ranking.benchmark.run-custom",
+    "title": "provider-ranking.benchmark.run-custom",
+    "summary": "Launch a custom benchmark evaluation against a specific model.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: custom, eval\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/commands/benchmarkRunCustom.command.ts`",
+    "route": "/docs/reference/_common/provider-ranking.benchmark.run-custom",
+    "source": "generated",
+    "contentPath": "_common/provider-ranking.benchmark.run-custom.md"
+  },
+  {
+    "id": "_common/provider-ranking.model.comparison",
+    "title": "provider-ranking.model.comparison",
+    "summary": "Side-by-side comparison of AI model scores and capabilities.\n- **Type**: presentation (presentation)\n- **Version**: 1.0.0\n- **Tags**: comparison\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/presentations/modelComparison.presentation.ts`",
+    "route": "/docs/reference/_common/provider-ranking.model.comparison",
+    "source": "generated",
+    "contentPath": "_common/provider-ranking.model.comparison.md"
+  },
+  {
+    "id": "_common/provider-ranking.model.profile.get",
+    "title": "provider-ranking.model.profile.get",
+    "summary": "Get detailed profile for a single model including all scores, metadata, cost, and capabilities.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: model, profile\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/queries/modelProfileGet.query.ts`",
+    "route": "/docs/reference/_common/provider-ranking.model.profile.get",
+    "source": "generated",
+    "contentPath": "_common/provider-ranking.model.profile.get.md"
+  },
+  {
+    "id": "_common/provider-ranking.ranking.get",
+    "title": "provider-ranking.ranking.get",
+    "summary": "Get ranked list of providers/models with composite scores, filterable by dimension.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: leaderboard\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/queries/providerRankingGet.query.ts`",
+    "route": "/docs/reference/_common/provider-ranking.ranking.get",
+    "source": "generated",
+    "contentPath": "_common/provider-ranking.ranking.get.md"
+  },
+  {
+    "id": "_common/provider-ranking.ranking.refresh",
+    "title": "provider-ranking.ranking.refresh",
+    "summary": "Recompute composite rankings from latest benchmark data.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: refresh\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/commands/rankingRefresh.command.ts`",
+    "route": "/docs/reference/_common/provider-ranking.ranking.refresh",
+    "source": "generated",
+    "contentPath": "_common/provider-ranking.ranking.refresh.md"
+  },
+  {
+    "id": "_common/provider-ranking.ranking.updated",
+    "title": "provider-ranking.ranking.updated",
+    "summary": "Emitted when composite rankings are recomputed.\n- **Type**: event (event)\n- **Version**: 1.0.0\n- **Tags**: refresh\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/events/rankingUpdated.event.ts`",
+    "route": "/docs/reference/_common/provider-ranking.ranking.updated",
+    "source": "generated",
+    "contentPath": "_common/provider-ranking.ranking.updated.md"
+  },
+  {
+    "id": "_common/provider-ranking.system",
+    "title": "provider-ranking.system",
+    "summary": "Benchmark ingestion, scoring, and ranking for AI providers and models.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Tags**: system\n- **File**: `packages/libs/contracts-spec/src/provider-ranking/capabilities/providerRanking.capability.ts`",
+    "route": "/docs/reference/_common/provider-ranking.system",
+    "source": "generated",
+    "contentPath": "_common/provider-ranking.system.md"
+  },
+  {
+    "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-spec/src/operations/report/getContractVerificationStatus.ts`",
+    "route": "/docs/reference/_common/report.getContractVerificationStatus",
+    "source": "generated",
+    "contentPath": "_common/report.getContractVerificationStatus.md"
+  },
+  {
+    "id": "_common/template.messaging.core",
+    "title": "template.messaging.core",
+    "summary": "Real-time messaging primitives for template applications, including conversations, participants, and delivery events.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Owners**: platform.contractspec-studio",
+    "route": "/docs/reference/_common/template.messaging.core",
+    "source": "generated",
+    "contentPath": "_common/template.messaging.core.md"
+  },
+  {
+    "id": "_common/template.recipes.browse",
+    "title": "template.recipes.browse",
+    "summary": "Internationalized recipe browsing, search, and detail operations for template applications.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Owners**: platform.contractspec-studio\n- **Tags**: templates, recipes, i18n, content",
+    "route": "/docs/reference/_common/template.recipes.browse",
+    "source": "generated",
+    "contentPath": "_common/template.recipes.browse.md"
+  },
+  {
+    "id": "_common/template.todos.crud",
+    "title": "template.todos.crud",
+    "summary": "Create, read, update, delete, and toggle template tasks with categories and priorities.\n- **Type**: capability (capability)\n- **Version**: 1.0.0\n- **Owners**: platform.contractspec-studio\n- **Tags**: templates, todos, productivity",
+    "route": "/docs/reference/_common/template.todos.crud",
+    "source": "generated",
+    "contentPath": "_common/template.todos.crud.md"
+  },
+  {
+    "id": "_common/test",
+    "title": "test",
+    "summary": "Run tests defined in contract specs\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @lssm/core\n- **Tags**: cli, test\n- **File**: `packages/bundles/workspace/src/contracts/operations/test.operation.ts`",
+    "route": "/docs/reference/_common/test",
+    "source": "generated",
+    "contentPath": "_common/test.md"
+  },
+  {
+    "id": "_common/user.create",
+    "title": "user.create",
+    "summary": "Create a new user account with the provided email\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @team\n- **Tags**: user\n- **File**: `packages/examples/minimal/src/contracts/user.ts`",
+    "route": "/docs/reference/_common/user.create",
+    "source": "generated",
+    "contentPath": "_common/user.create.md"
+  },
+  {
+    "id": "_common/validate",
+    "title": "validate",
+    "summary": "Validate a contract spec file structure and optionally its implementation\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Stability**: stable\n- **Owners**: @lssm/core\n- **Tags**: cli, validation\n- **File**: `packages/bundles/workspace/src/contracts/operations/validate.operation.ts`",
+    "route": "/docs/reference/_common/validate",
+    "source": "generated",
+    "contentPath": "_common/validate.md"
+  },
+  {
+    "id": "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/accessibility_wcag_compliance_specs",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/accessibility_wcag_compliance_specs.md",
+    "tags": [
+      "accessibility_wcag_compliance_specs"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.meta.docblocks-process",
+    "title": "DocBlocks process",
+    "summary": "How to author goal/how/usage DocBlocks close to code.",
+    "route": "/docs/meta/docblocks-process",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/meta/docblocks-process.md",
+    "tags": [
+      "docs",
+      "process"
+    ],
+    "kind": "reference",
+    "visibility": "mixed"
+  },
+  {
+    "id": "docs.tech.acp.fs.access",
+    "title": "ACP file system access",
+    "summary": "Access file system through ACP.",
+    "route": "/docs/tech/acp/fs/access",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/acp/fs/access.md",
+    "tags": [
+      "acp",
+      "filesystem"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.acp.prompt.turn",
+    "title": "ACP prompt turn",
+    "summary": "Execute a prompt turn within a session.",
+    "route": "/docs/tech/acp/prompt/turn",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/acp/prompt/turn.md",
+    "tags": [
+      "acp",
+      "prompt"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.acp.session.init",
+    "title": "ACP session init",
+    "summary": "Initialize a new ACP session.",
+    "route": "/docs/tech/acp/session/init",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/acp/session/init.md",
+    "tags": [
+      "acp",
+      "session"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.acp.session.resume",
+    "title": "ACP session resume",
+    "summary": "Resume an existing ACP session.",
+    "route": "/docs/tech/acp/session/resume",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/acp/session/resume.md",
+    "tags": [
+      "acp",
+      "session"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.acp.session.stop",
+    "title": "ACP session stop",
+    "summary": "Stop an ACP session.",
+    "route": "/docs/tech/acp/session/stop",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/acp/session/stop.md",
+    "tags": [
+      "acp",
+      "session"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.acp.terminal.exec",
+    "title": "ACP terminal exec",
+    "summary": "Execute terminal commands via ACP.",
+    "route": "/docs/tech/acp/terminal/exec",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/acp/terminal/exec.md",
+    "tags": [
+      "acp",
+      "terminal"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.acp.tool.calls",
+    "title": "ACP tool calls",
+    "summary": "Execute ACP tool calls.",
+    "route": "/docs/tech/acp/tool/calls",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/acp/tool/calls.md",
+    "tags": [
+      "acp",
+      "tools"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.acp.transport",
+    "title": "ACP transport",
+    "summary": "Agent Client Protocol transport surfaces.",
+    "route": "/docs/tech/acp/transport",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/acp/transport.md",
+    "tags": [
+      "acp",
+      "transport"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.approval.requested",
+    "title": "Agent approval requested event",
+    "summary": "Emitted when approval is required.",
+    "route": "/docs/tech/agent/approval/requested",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/approval/requested.md",
+    "tags": [
+      "agent",
+      "event",
+      "approval"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.approvals",
+    "title": "Agent approvals",
+    "summary": "Resolve an agent approval request.",
+    "route": "/docs/tech/agent/approvals",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/approvals.md",
+    "tags": [
+      "agent",
+      "approval"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.artifacts",
+    "title": "Agent artifacts",
+    "summary": "List artifacts produced by an agent run.",
+    "route": "/docs/tech/agent/artifacts",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/artifacts.md",
+    "tags": [
+      "agent",
+      "artifacts"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.cancel",
+    "title": "Cancel agent run",
+    "summary": "Cancel an in-flight agent run.",
+    "route": "/docs/tech/agent/cancel",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/cancel.md",
+    "tags": [
+      "agent",
+      "cancel"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.execution",
+    "title": "Agent execution",
+    "summary": "Background agent execution, approvals, and artifacts.",
+    "route": "/docs/tech/agent/execution",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/execution.md",
+    "tags": [
+      "agent",
+      "execution"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.memory-tools",
+    "title": "Memory tools",
+    "summary": "Model-accessible CRUD for agent memory and ephemeral knowledge.",
+    "route": "/docs/tech/agent/memory-tools",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/memory-tools.md",
+    "tags": [
+      "agent",
+      "memory",
+      "tools"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.operations-as-tools",
+    "title": "Operations as tools",
+    "summary": "Reference ContractSpec operations as agent tools. One contract to many surfaces.",
+    "route": "/docs/tech/agent/operations-as-tools",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/operations-as-tools.md",
+    "tags": [
+      "agent",
+      "tools",
+      "operations"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.run",
+    "title": "Run agent",
+    "summary": "Submit a background agent run.",
+    "route": "/docs/tech/agent/run",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/run.md",
+    "tags": [
+      "agent",
+      "run"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.run.audit",
+    "title": "Agent run audit presentation",
+    "summary": "Presentation spec for agent run audit views.",
+    "route": "/docs/tech/agent/run/audit",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/run/audit.md",
+    "tags": [
+      "agent",
+      "presentation",
+      "audit"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.run.completed",
+    "title": "Agent run completed event",
+    "summary": "Emitted when an agent run completes.",
+    "route": "/docs/tech/agent/run/completed",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/run/completed.md",
+    "tags": [
+      "agent",
+      "event"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.run.failed",
+    "title": "Agent run failed event",
+    "summary": "Emitted when an agent run fails.",
+    "route": "/docs/tech/agent/run/failed",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/run/failed.md",
+    "tags": [
+      "agent",
+      "event"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.run.form",
+    "title": "Agent run form",
+    "summary": "Form specification for launching an agent run.",
+    "route": "/docs/tech/agent/run/form",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/run/form.md",
+    "tags": [
+      "agent",
+      "form"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.run.index",
+    "title": "Agent run index view",
+    "summary": "Data view for listing agent runs.",
+    "route": "/docs/tech/agent/run/index",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/run/index.md",
+    "tags": [
+      "agent",
+      "data-view"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.run.started",
+    "title": "Agent run started event",
+    "summary": "Emitted when an agent run starts.",
+    "route": "/docs/tech/agent/run/started",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/run/started.md",
+    "tags": [
+      "agent",
+      "event"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.status",
+    "title": "Agent status",
+    "summary": "Query agent run status.",
+    "route": "/docs/tech/agent/status",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/status.md",
+    "tags": [
+      "agent",
+      "status"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.subagents",
+    "title": "Subagents",
+    "summary": "Delegate tasks to subagents with streaming and isolated context.",
+    "route": "/docs/tech/agent/subagents",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/subagents.md",
+    "tags": [
+      "agent",
+      "subagents",
+      "delegation"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.agent.workflow-integration",
+    "title": "Workflow-agent integration",
+    "summary": "Patterns for orchestrator-worker, workflow steps, and evaluator loops.",
+    "route": "/docs/tech/agent/workflow-integration",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/agent/workflow-integration.md",
+    "tags": [
+      "agent",
+      "workflow",
+      "orchestrator"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.context.pack.describe",
+    "title": "Describe context pack",
+    "summary": "Describe a context pack and its sources.",
+    "route": "/docs/tech/context/pack/describe",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/context/pack/describe.md",
+    "tags": [
+      "context",
+      "pack",
+      "describe"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.context.pack.search",
+    "title": "Search context packs",
+    "summary": "Search and filter context packs and snapshots.",
+    "route": "/docs/tech/context/pack/search",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/context/pack/search.md",
+    "tags": [
+      "context",
+      "pack",
+      "search"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.context.pack.search.form",
+    "title": "Context pack search form",
+    "summary": "Form used to search context packs in UI surfaces.",
+    "route": "/docs/tech/context/pack/search-form",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/context/pack/search/form.md",
+    "tags": [
+      "context",
+      "form",
+      "search"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.context.pack.snapshot",
+    "title": "Create context snapshot",
+    "summary": "Create an immutable context snapshot from a pack.",
+    "route": "/docs/tech/context/pack/snapshot",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/context/pack/snapshot.md",
+    "tags": [
+      "context",
+      "snapshot",
+      "create"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.context.snapshot.created",
+    "title": "Context snapshot created event",
+    "summary": "Emitted when a context snapshot is created.",
+    "route": "/docs/tech/context/snapshot/created",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/context/snapshot/created.md",
+    "tags": [
+      "context",
+      "snapshot",
+      "event"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.context.snapshot.index",
+    "title": "Context snapshot index view",
+    "summary": "Data view for listing context snapshots.",
+    "route": "/docs/tech/context/snapshot/index",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/context/snapshot/index.md",
+    "tags": [
+      "context",
+      "snapshot",
+      "data-view"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.context.snapshot.presentation",
+    "title": "Context snapshot presentation",
+    "summary": "Presentation spec for snapshot summaries.",
+    "route": "/docs/tech/context/snapshot/presentation",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/context/snapshot/presentation.md",
+    "tags": [
+      "context",
+      "presentation",
+      "snapshot"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.context.system",
+    "title": "Context system",
+    "summary": "Context packs, snapshots, and discovery surfaces.",
+    "route": "/docs/tech/context/system",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/context/system.md",
+    "tags": [
+      "context",
+      "system",
+      "snapshot"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.app-config",
+    "title": "App Configuration Layers",
+    "summary": "App orchestration is split into three explicit layers:",
+    "route": "/docs/tech/contracts/app-config",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/app-config.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "app-config"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.capabilities",
+    "title": "CapabilitySpec Overview",
+    "summary": "Capability specs define what a module provides (operations, events, presentations) and requires (dependencies). They enable bidirectional linking, inheritance, runtime enforcement, and automated validation.",
+    "route": "/docs/tech/contracts/capabilities",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/capabilities.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "capabilities"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.data-views",
+    "title": "DataViewSpec Overview",
+    "summary": "`DataViewSpec` is the declarative contract for projecting entities into list/detail/table/grid experiences. Each spec ties to contract operations (`source.primary`, `source.item`) and describes how the UI should present, sort, filter, paginate, and pin records. Host applications use the spec to render UI with shared components (`DataViewRenderer`, `DataViewList`, `DataViewTable`, `DataViewDetail`) while keeping presentation logic in a single source of truth.",
+    "route": "/docs/tech/contracts/data-views",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/data-views.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "data-views"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.examples",
+    "title": "Example Specifications",
+    "summary": "ExampleSpec defines complete, demonstrable ContractSpec applications.",
+    "route": "/docs/tech/contracts/examples",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/examples.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "examples",
+      "templates"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.experiments",
+    "title": "ExperimentSpec & ExperimentEvaluator",
+    "summary": "Use experiments to test alternative workflows, data views, or themes with controlled allocations and measurable outcomes.",
+    "route": "/docs/tech/contracts/experiments",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/experiments.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "experiments"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.forms",
+    "title": "Contracts: FormSpec",
+    "summary": "This document defines the canonical contracts for declarative forms.",
+    "route": "/docs/tech/contracts/forms",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/forms.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "forms"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.knowledge",
+    "title": "Knowledge Layer",
+    "summary": "The knowledge layer turns unstructured inputs (uploads, email threads,",
+    "route": "/docs/tech/contracts/knowledge",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/knowledge.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "knowledge"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.migrations",
+    "title": "MigrationSpec Overview",
+    "summary": "`MigrationSpec` provides a declarative plan for schema/data/validation steps so migrations can be generated, reviewed, and executed safely by tooling. Each spec captures ownership metadata, ordered up/down steps, and optional dependency information. Runtime tooling can consume the spec to run SQL/data scripts with pre/post checks and produce audit logs.",
+    "route": "/docs/tech/contracts/migrations",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/migrations.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "migrations"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.openapi-export",
+    "title": "OpenAPI export (OpenAPI 3.1) from OperationSpecRegistry",
+    "summary": "Generate a deterministic OpenAPI document from a OperationSpecRegistry using jsonSchemaForSpec + REST transport metadata.",
+    "route": "/docs/tech/contracts/openapi-export",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/openapi-export.md",
+    "tags": [
+      "contracts",
+      "openapi",
+      "rest"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.ops-to-presentation-linking",
+    "title": "Ops ↔ Presentation linking (V2)",
+    "summary": "This document explains how operations (OperationSpec) are linked to Presentations (PresentationSpec) via Feature modules.",
+    "route": "/docs/tech/contracts/ops-to-presentation-linking",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/ops-to-presentation-linking.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "ops-to-presentation-linking"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.policy",
+    "title": "PolicySpec & PolicyEngine",
+    "summary": "`PolicySpec` gives a declarative, typed home for access-control logic covering:",
+    "route": "/docs/tech/contracts/policy",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/policy.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "policy"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.presentations",
+    "title": "Presentations — Unified Descriptor & Transform Engine",
+    "summary": "How PresentationSpec and TransformEngine keep docs/renderers consistent.",
+    "route": "/docs/tech/contracts/presentations",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/presentations.md",
+    "tags": [
+      "presentations",
+      "docs",
+      "mcp"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.presentations-conventions",
+    "title": "Presentations Conventions (A11y & i18n)",
+    "summary": "- Always provide `meta.description` (≥ 3 chars) — used by a11y/docs/agents.",
+    "route": "/docs/tech/contracts/presentations-conventions",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/presentations-conventions.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "presentations-conventions"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.README",
+    "title": "Contracts: Specs, Registry, Handlers, Adapters",
+    "summary": "- `packages/lssm/libs/contracts` defines the contracts core (OperationSpecRegistry, OperationSpec, PresentationSpec, install helpers, REST/MCP adapters, ...).",
+    "route": "/docs/tech/contracts/README",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/README.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "README"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.regenerator",
+    "title": "Regenerator Service",
+    "summary": "The Regenerator daemon observes telemetry, error, and behavior streams, then suggests spec-level changes (not code patches) that can be reviewed and applied through the App Studio.",
+    "route": "/docs/tech/contracts/regenerator",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/regenerator.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "regenerator"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.telemetry",
+    "title": "TelemetrySpec",
+    "summary": "Telemetry specs describe product analytics in a durable, type-safe way. They reference existing `EventSpec`s (same name/version) but layer on privacy classification, retention, sampling, and anomaly detection so instrumentation stays compliant and observable.",
+    "route": "/docs/tech/contracts/telemetry",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/telemetry.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "telemetry"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.tests",
+    "title": "TestSpec & TestRunner",
+    "summary": "Use `TestSpec` to describe end-to-end scenarios for contracts and workflows. Specs live alongside your contracts and exercise the same OperationSpecRegistry handlers the app uses.",
+    "route": "/docs/tech/contracts/tests",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/tests.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "tests"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.themes",
+    "title": "ThemeSpec Overview",
+    "summary": "`ThemeSpec` defines a structured, versioned source of truth for design tokens, component variants, and scoped overrides. Use it to describe how tenants or individual users should experience the design system without hand-maintaining ad-hoc theme files. Specs live in `@contractspec/lib.contracts-spec`, making them accessible to generators, docs, and runtime tooling.",
+    "route": "/docs/tech/contracts/themes",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/themes.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "themes"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.contracts.workspace-config",
+    "title": "Workspace Configuration (.contractsrc)",
+    "summary": "Configuration-as-code conventions for ContractSpec workspaces (`.contractsrc.json`).",
+    "route": "/docs/tech/contracts/workspace-config",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/contracts/workspace-config.md",
+    "tags": [
+      "tech",
+      "contracts",
+      "config"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.database.context",
+    "title": "Database context",
+    "summary": "Schema, migrations, dictionary, and read-only query surfaces.",
+    "route": "/docs/tech/database/context",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/database/context.md",
+    "tags": [
+      "database",
+      "context"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.database.dictionary.get",
+    "title": "Get data dictionary entry",
+    "summary": "Retrieve a dictionary entry for a schema field.",
+    "route": "/docs/tech/database/dictionary/get",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/database/dictionary/get.md",
+    "tags": [
+      "database",
+      "dictionary"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.database.migrations.list",
+    "title": "List database migrations",
+    "summary": "List migration history for a database.",
+    "route": "/docs/tech/database/migrations/list",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/database/migrations/list.md",
+    "tags": [
+      "database",
+      "migrations"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.database.query.readonly",
+    "title": "Read-only data query",
+    "summary": "Perform a governed read-only query via data views.",
+    "route": "/docs/tech/database/query/readonly",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/database/query/readonly.md",
+    "tags": [
+      "database",
+      "query",
+      "readonly"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.database.schema.describe",
+    "title": "Describe database schema",
+    "summary": "Describe schemas and models with PII signals.",
+    "route": "/docs/tech/database/schema/describe",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/database/schema/describe.md",
+    "tags": [
+      "database",
+      "schema"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.database.schema.index",
+    "title": "Database schema index view",
+    "summary": "Data view for listing schemas and model counts.",
+    "route": "/docs/tech/database/schema/index",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/database/schema/index.md",
+    "tags": [
+      "database",
+      "data-view"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.docs-examples",
+    "title": "Examples catalog",
+    "summary": "Document and surface example projects with sandbox support.",
+    "route": "/docs/tech/docs/examples",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/docs-examples.md",
+    "tags": [
+      "docs",
+      "examples"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.docs-generator",
+    "title": "Docs generator",
+    "summary": "Generate reference docs and metadata from ContractSpecs.",
+    "route": "/docs/tech/docs/generator",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/docs-generator.md",
+    "tags": [
+      "docs",
+      "generator",
+      "cli"
+    ],
+    "kind": "how",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.docs-publish",
+    "title": "Docs publish",
+    "summary": "Publish generated artifacts to the docs host.",
+    "route": "/docs/tech/docs/publish",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/docs-publish.md",
+    "tags": [
+      "docs",
+      "publish"
+    ],
+    "kind": "how",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.docs-reference",
+    "title": "Contract reference pages",
+    "summary": "Resolve any spec into a docs-ready reference payload.",
+    "route": "/docs/tech/docs/reference",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/docs-reference.md",
+    "tags": [
+      "docs",
+      "reference"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.docs-search",
+    "title": "Docs index and search",
+    "summary": "Search DocBlocks by query, tag, kind, or visibility.",
+    "route": "/docs/tech/docs/search",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/docs-search.md",
+    "tags": [
+      "docs",
+      "search"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.docs-system",
+    "title": "Docs system overview",
+    "summary": "How ContractSpec generates, indexes, and presents documentation.",
+    "route": "/docs/tech/docs/system",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/docs-system.md",
+    "tags": [
+      "docs",
+      "system",
+      "contracts"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.provider-ranking.benchmark.custom.completed",
+    "title": "Custom benchmark completed event",
+    "summary": "Emitted when a custom benchmark run finishes.",
+    "route": "/docs/tech/provider-ranking/benchmark/custom/completed",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/provider-ranking/benchmark/custom/completed.md",
+    "tags": [
+      "ai",
+      "ranking",
+      "event",
+      "custom"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.provider-ranking.benchmark.ingest",
+    "title": "Ingest benchmark data",
+    "summary": "Trigger ingestion of external benchmark data.",
+    "route": "/docs/tech/provider-ranking/benchmark/ingest",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/provider-ranking/benchmark/ingest.md",
+    "tags": [
+      "ai",
+      "ranking",
+      "ingest"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.provider-ranking.benchmark.ingest.form",
+    "title": "Benchmark ingest form",
+    "summary": "Form specification for triggering benchmark ingestion.",
+    "route": "/docs/tech/provider-ranking/benchmark/ingest/form",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/provider-ranking/benchmark/ingest/form.md",
+    "tags": [
+      "ai",
+      "ranking",
+      "form"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.provider-ranking.benchmark.ingested",
+    "title": "Benchmark ingested event",
+    "summary": "Emitted after external benchmark data is ingested.",
+    "route": "/docs/tech/provider-ranking/benchmark/ingested",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/provider-ranking/benchmark/ingested.md",
+    "tags": [
+      "ai",
+      "ranking",
+      "event"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.provider-ranking.benchmark.results.index",
+    "title": "Benchmark results view",
+    "summary": "Data view for raw benchmark results.",
+    "route": "/docs/tech/provider-ranking/benchmark/results/index",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/provider-ranking/benchmark/results/index.md",
+    "tags": [
+      "ai",
+      "ranking",
+      "data-view"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.provider-ranking.benchmark.results.list",
+    "title": "List benchmark results",
+    "summary": "List raw benchmark results.",
+    "route": "/docs/tech/provider-ranking/benchmark/results/list",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/provider-ranking/benchmark/results/list.md",
+    "tags": [
+      "ai",
+      "ranking",
+      "results"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.provider-ranking.benchmark.run-custom",
+    "title": "Run custom benchmark",
+    "summary": "Launch a custom benchmark evaluation against a model.",
+    "route": "/docs/tech/provider-ranking/benchmark/run-custom",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/provider-ranking/benchmark/run-custom.md",
+    "tags": [
+      "ai",
+      "ranking",
+      "custom",
+      "eval"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.provider-ranking.benchmark.run-custom.form",
+    "title": "Custom benchmark form",
+    "summary": "Form specification for launching custom benchmarks.",
+    "route": "/docs/tech/provider-ranking/benchmark/run-custom/form",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/provider-ranking/benchmark/run-custom/form.md",
+    "tags": [
+      "ai",
+      "ranking",
+      "form"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.provider-ranking.model.comparison",
+    "title": "Model comparison presentation",
+    "summary": "Presentation spec for side-by-side model comparison.",
+    "route": "/docs/tech/provider-ranking/model/comparison",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/provider-ranking/model/comparison.md",
+    "tags": [
+      "ai",
+      "ranking",
+      "presentation",
+      "comparison"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.provider-ranking.model.profile.get",
+    "title": "Get model profile",
+    "summary": "Get detailed profile for a single model.",
+    "route": "/docs/tech/provider-ranking/model/profile/get",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/provider-ranking/model/profile/get.md",
+    "tags": [
+      "ai",
+      "ranking",
+      "model",
+      "profile"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.provider-ranking.ranking.get",
+    "title": "Get provider rankings",
+    "summary": "Get ranked list of providers and models.",
+    "route": "/docs/tech/provider-ranking/ranking/get",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/provider-ranking/ranking/get.md",
+    "tags": [
+      "ai",
+      "ranking",
+      "leaderboard"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.provider-ranking.ranking.index",
+    "title": "Provider rankings view",
+    "summary": "Data view for the model leaderboard.",
+    "route": "/docs/tech/provider-ranking/ranking/index",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/provider-ranking/ranking/index.md",
+    "tags": [
+      "ai",
+      "ranking",
+      "data-view"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.provider-ranking.ranking.refresh",
+    "title": "Refresh rankings",
+    "summary": "Recompute composite rankings from latest benchmark data.",
+    "route": "/docs/tech/provider-ranking/ranking/refresh",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/provider-ranking/ranking/refresh.md",
+    "tags": [
+      "ai",
+      "ranking",
+      "refresh"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.provider-ranking.ranking.updated",
+    "title": "Ranking updated event",
+    "summary": "Emitted when composite rankings are recomputed.",
+    "route": "/docs/tech/provider-ranking/ranking/updated",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/provider-ranking/ranking/updated.md",
+    "tags": [
+      "ai",
+      "ranking",
+      "event"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.provider-ranking.system",
+    "title": "AI Provider Ranking",
+    "summary": "Benchmark ingestion, scoring, and ranking for AI providers and models.",
+    "route": "/docs/tech/provider-ranking/system",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/provider-ranking/system.md",
+    "tags": [
+      "ai",
+      "ranking",
+      "benchmark"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  },
+  {
+    "id": "docs.tech.report-verification-table",
+    "title": "Contract Verification Table",
+    "summary": "How the impact report renders per-contract verification status.",
+    "route": "/docs/tech/report/verification-table",
+    "source": "docblock",
+    "contentPath": "docblocks/docs/tech/report-verification-table.md",
+    "tags": [
+      "report",
+      "drift",
+      "verification",
+      "impact"
+    ],
+    "kind": "how",
+    "visibility": "public",
+    "owners": [
+      "platform.core"
+    ]
+  },
+  {
+    "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, including runtime adapter capabilities/ports for checkpointing, suspend-resume orchestration, and explicit waiting/retry states. 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"
+    ],
+    "kind": "reference",
+    "visibility": "public"
+  }
+]