@contractspec/bundle.library 3.8.10 → 3.8.11

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

@@ -1,13 +1,13 @@
 {
-	"generatedAt": "2026-03-21T22:41:08.515Z",
-	"total": 1068,
+	"generatedAt": "2026-04-09T02:40:04.488Z",
+	"total": 1127,
 	"version": null,
 	"contentRoot": "../../../../../../../generated/docs",
 	"chunks": [
 		{
 			"key": "_common",
 			"file": "docs-index._common.json",
-			"total": 184
+			"total": 180
 		},
 		{
 			"key": "agent-console",
@@ -64,6 +64,11 @@
 			"file": "docs-index.content-generation.json",
 			"total": 1
 		},
+		{
+			"key": "control-plane",
+			"file": "docs-index.control-plane.json",
+			"total": 2
+		},
 		{
 			"key": "crm-pipeline",
 			"file": "docs-index.crm-pipeline.json",
@@ -74,6 +79,11 @@
 			"file": "docs-index.data-grid-showcase.json",
 			"total": 2
 		},
+		{
+			"key": "defineExample",
+			"file": "docs-index.defineExample.json",
+			"total": 1
+		},
 		{
 			"key": "email-gmail",
 			"file": "docs-index.email-gmail.json",
@@ -287,32 +297,32 @@
 		{
 			"key": "platform.acp",
 			"file": "docs-index.platform-acp.json",
-			"total": 9
+			"total": 17
 		},
 		{
 			"key": "platform.agent",
 			"file": "docs-index.platform-agent.json",
-			"total": 12
+			"total": 23
 		},
 		{
 			"key": "platform.context",
 			"file": "docs-index.platform-context.json",
-			"total": 7
+			"total": 13
 		},
 		{
 			"key": "platform.control-plane",
 			"file": "docs-index.platform-control-plane.json",
-			"total": 31
+			"total": 40
 		},
 		{
 			"key": "platform.database",
 			"file": "docs-index.platform-database.json",
-			"total": 6
+			"total": 11
 		},
 		{
 			"key": "platform.docs",
 			"file": "docs-index.platform-docs.json",
-			"total": 11
+			"total": 19
 		},
 		{
 			"key": "platform.harness",
@@ -332,12 +342,12 @@
 		{
 			"key": "platform.provider-ranking",
 			"file": "docs-index.platform-provider-ranking.json",
-			"total": 12
+			"total": 23
 		},
 		{
 			"key": "pocket-family-office",
 			"file": "docs-index.pocket-family-office.json",
-			"total": 15
+			"total": 16
 		},
 		{
 			"key": "policy-safe-knowledge-assistant",
@@ -372,7 +382,7 @@
 		{
 			"key": "unknown",
 			"file": "docs-index.unknown.json",
-			"total": 64
+			"total": 65
 		},
 		{
 			"key": "versioned-knowledge-base",

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

@@ -63,6 +63,70 @@
 		"source": "generated",
 		"contentPath": "platform.acp/acp.transport.md"
 	},
+	{
+		"id": "platform.acp/docs.tech.acp.fs.access",
+		"title": "acp.fs.access",
+		"summary": "Performs file system access with policy gating.",
+		"route": "/docs/reference/platform.acp/docs.tech.acp.fs.access",
+		"source": "generated",
+		"contentPath": "platform.acp/docs.tech.acp.fs.access.md"
+	},
+	{
+		"id": "platform.acp/docs.tech.acp.prompt.turn",
+		"title": "acp.prompt.turn",
+		"summary": "Runs a prompt turn and returns structured outputs and tool calls.",
+		"route": "/docs/reference/platform.acp/docs.tech.acp.prompt.turn",
+		"source": "generated",
+		"contentPath": "platform.acp/docs.tech.acp.prompt.turn.md"
+	},
+	{
+		"id": "platform.acp/docs.tech.acp.session.init",
+		"title": "acp.session.init",
+		"summary": "Creates a new ACP session and returns session metadata.",
+		"route": "/docs/reference/platform.acp/docs.tech.acp.session.init",
+		"source": "generated",
+		"contentPath": "platform.acp/docs.tech.acp.session.init.md"
+	},
+	{
+		"id": "platform.acp/docs.tech.acp.session.resume",
+		"title": "acp.session.resume",
+		"summary": "Resumes a previously initialized ACP session.",
+		"route": "/docs/reference/platform.acp/docs.tech.acp.session.resume",
+		"source": "generated",
+		"contentPath": "platform.acp/docs.tech.acp.session.resume.md"
+	},
+	{
+		"id": "platform.acp/docs.tech.acp.session.stop",
+		"title": "acp.session.stop",
+		"summary": "Stops an active ACP session with audit trails.",
+		"route": "/docs/reference/platform.acp/docs.tech.acp.session.stop",
+		"source": "generated",
+		"contentPath": "platform.acp/docs.tech.acp.session.stop.md"
+	},
+	{
+		"id": "platform.acp/docs.tech.acp.terminal.exec",
+		"title": "acp.terminal.exec",
+		"summary": "Executes terminal commands in a governed ACP session.",
+		"route": "/docs/reference/platform.acp/docs.tech.acp.terminal.exec",
+		"source": "generated",
+		"contentPath": "platform.acp/docs.tech.acp.terminal.exec.md"
+	},
+	{
+		"id": "platform.acp/docs.tech.acp.tool.calls",
+		"title": "acp.tool.calls",
+		"summary": "Executes tool calls with governance and telemetry.",
+		"route": "/docs/reference/platform.acp/docs.tech.acp.tool.calls",
+		"source": "generated",
+		"contentPath": "platform.acp/docs.tech.acp.tool.calls.md"
+	},
+	{
+		"id": "platform.acp/docs.tech.acp.transport",
+		"title": "ACP transport",
+		"summary": "Defines the ContractSpec ACP server + client surfaces for HTTP streamable transport.",
+		"route": "/docs/reference/platform.acp/docs.tech.acp.transport",
+		"source": "generated",
+		"contentPath": "platform.acp/docs.tech.acp.transport.md"
+	},
 	{
 		"id": "platform.acp/platform.acp",
 		"title": "platform.acp",

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

@@ -87,10 +87,98 @@
 		"source": "generated",
 		"contentPath": "platform.agent/agent.status.md"
 	},
+	{
+		"id": "platform.agent/docs.tech.agent.approval.requested",
+		"title": "agent.approval.requested",
+		"summary": "Emitted when an approval gate is triggered.",
+		"route": "/docs/reference/platform.agent/docs.tech.agent.approval.requested",
+		"source": "generated",
+		"contentPath": "platform.agent/docs.tech.agent.approval.requested.md"
+	},
+	{
+		"id": "platform.agent/docs.tech.agent.approvals",
+		"title": "agent.approvals",
+		"summary": "Approve or reject a pending agent action.",
+		"route": "/docs/reference/platform.agent/docs.tech.agent.approvals",
+		"source": "generated",
+		"contentPath": "platform.agent/docs.tech.agent.approvals.md"
+	},
+	{
+		"id": "platform.agent/docs.tech.agent.artifacts",
+		"title": "agent.artifacts",
+		"summary": "Lists files, diffs, and outputs produced during agent execution.",
+		"route": "/docs/reference/platform.agent/docs.tech.agent.artifacts",
+		"source": "generated",
+		"contentPath": "platform.agent/docs.tech.agent.artifacts.md"
+	},
+	{
+		"id": "platform.agent/docs.tech.agent.cancel",
+		"title": "agent.cancel",
+		"summary": "Stops an active agent run and records cancellation metadata.",
+		"route": "/docs/reference/platform.agent/docs.tech.agent.cancel",
+		"source": "generated",
+		"contentPath": "platform.agent/docs.tech.agent.cancel.md"
+	},
+	{
+		"id": "platform.agent/docs.tech.agent.execution",
+		"title": "Agent execution",
+		"summary": "Defines the core operations, events, and UI surfaces for background agent runs with auditability and approvals.",
+		"route": "/docs/reference/platform.agent/docs.tech.agent.execution",
+		"source": "generated",
+		"contentPath": "platform.agent/docs.tech.agent.execution.md"
+	},
+	{
+		"id": "platform.agent/docs.tech.agent.run",
+		"title": "agent.run",
+		"summary": "Creates a new agent run with a context snapshot and execution metadata.",
+		"route": "/docs/reference/platform.agent/docs.tech.agent.run",
+		"source": "generated",
+		"contentPath": "platform.agent/docs.tech.agent.run.md"
+	},
+	{
+		"id": "platform.agent/docs.tech.agent.run.audit",
+		"title": "agent.run.audit",
+		"summary": "Presentation surface used to inspect run provenance, tools, approvals, and outputs.",
+		"route": "/docs/reference/platform.agent/docs.tech.agent.run.audit",
+		"source": "generated",
+		"contentPath": "platform.agent/docs.tech.agent.run.audit.md"
+	},
+	{
+		"id": "platform.agent/docs.tech.agent.run.completed",
+		"title": "agent.run.completed",
+		"summary": "Emitted when a run completes successfully.",
+		"route": "/docs/reference/platform.agent/docs.tech.agent.run.completed",
+		"source": "generated",
+		"contentPath": "platform.agent/docs.tech.agent.run.completed.md"
+	},
+	{
+		"id": "platform.agent/docs.tech.agent.run.failed",
+		"title": "agent.run.failed",
+		"summary": "Emitted when a run terminates with failure.",
+		"route": "/docs/reference/platform.agent/docs.tech.agent.run.failed",
+		"source": "generated",
+		"contentPath": "platform.agent/docs.tech.agent.run.failed.md"
+	},
+	{
+		"id": "platform.agent/docs.tech.agent.run.started",
+		"title": "agent.run.started",
+		"summary": "Emitted when an agent run begins execution.",
+		"route": "/docs/reference/platform.agent/docs.tech.agent.run.started",
+		"source": "generated",
+		"contentPath": "platform.agent/docs.tech.agent.run.started.md"
+	},
+	{
+		"id": "platform.agent/docs.tech.agent.status",
+		"title": "agent.status",
+		"summary": "Returns status summaries for one or many agent runs.",
+		"route": "/docs/reference/platform.agent/docs.tech.agent.status",
+		"source": "generated",
+		"contentPath": "platform.agent/docs.tech.agent.status.md"
+	},
 	{
 		"id": "platform.agent/platform.agent",
 		"title": "platform.agent",
-		"summary": "Run, cancel, and approve AI agent executions with full audit trail\n- **Type**: feature\n- **Version**: 1.0.0\n- **File**: `packages/libs/contracts-spec/src/agent/agent.feature.ts`\n- `agent.run` (v1.0.0)\n- `agent.cancel` (v1.0.0)",
+		"summary": "Run, cancel, and approve AI agent executions with full audit trail\n- **Type**: feature\n- **Version**: 1.0.0\n- **Tags**: agent, execution\n- **File**: `packages/libs/contracts-spec/src/agent/agent.feature.ts`",
 		"route": "/docs/reference/platform.agent/platform.agent",
 		"source": "generated",
 		"contentPath": "platform.agent/platform.agent.md"

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

@@ -47,6 +47,54 @@
 		"source": "generated",
 		"contentPath": "platform.context/context.system.md"
 	},
+	{
+		"id": "platform.context/docs.tech.context.pack.describe",
+		"title": "context.pack.describe",
+		"summary": "Returns a canonical view of a context pack, including sources and ownership metadata.",
+		"route": "/docs/reference/platform.context/docs.tech.context.pack.describe",
+		"source": "generated",
+		"contentPath": "platform.context/docs.tech.context.pack.describe.md"
+	},
+	{
+		"id": "platform.context/docs.tech.context.pack.search",
+		"title": "context.pack.search",
+		"summary": "Search context packs and surface their latest snapshot details for discovery and UI lists.",
+		"route": "/docs/reference/platform.context/docs.tech.context.pack.search",
+		"source": "generated",
+		"contentPath": "platform.context/docs.tech.context.pack.search.md"
+	},
+	{
+		"id": "platform.context/docs.tech.context.pack.snapshot",
+		"title": "context.pack.snapshot",
+		"summary": "Creates a versioned snapshot that is used as the immutable context for agent execution.",
+		"route": "/docs/reference/platform.context/docs.tech.context.pack.snapshot",
+		"source": "generated",
+		"contentPath": "platform.context/docs.tech.context.pack.snapshot.md"
+	},
+	{
+		"id": "platform.context/docs.tech.context.snapshot.created",
+		"title": "context.snapshot.created",
+		"summary": "Emitted when a new snapshot has been persisted and is ready for use.",
+		"route": "/docs/reference/platform.context/docs.tech.context.snapshot.created",
+		"source": "generated",
+		"contentPath": "platform.context/docs.tech.context.snapshot.created.md"
+	},
+	{
+		"id": "platform.context/docs.tech.context.snapshot.presentation",
+		"title": "context.snapshot.summary",
+		"summary": "Defines the presentation surface for snapshot summaries across UI channels.",
+		"route": "/docs/reference/platform.context/docs.tech.context.snapshot.presentation",
+		"source": "generated",
+		"contentPath": "platform.context/docs.tech.context.snapshot.presentation.md"
+	},
+	{
+		"id": "platform.context/docs.tech.context.system",
+		"title": "Context system",
+		"summary": "The context system defines how ContractSpec bundles DocBlocks, contracts, knowledge spaces, and data views into deterministic snapshots.",
+		"route": "/docs/reference/platform.context/docs.tech.context.system",
+		"source": "generated",
+		"contentPath": "platform.context/docs.tech.context.system.md"
+	},
 	{
 		"id": "platform.context/platform.context",
 		"title": "platform.context",

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

@@ -1,4 +1,12 @@
 [
+	{
+		"id": "platform.control-plane/channel.messaging-policy",
+		"title": "channel.messaging-policy",
+		"summary": "Applies contract-backed blocked, assist, and autonomous routing for inbound messaging events.\n- **Type**: policy (policy)\n- **Version**: 2.0.0\n- **Tags**: policy, messaging\n- **File**: `packages/libs/contracts-spec/src/control-plane/policies/controlPlaneMessaging.policy.ts`",
+		"route": "/docs/reference/platform.control-plane/channel.messaging-policy",
+		"source": "generated",
+		"contentPath": "platform.control-plane/channel.messaging-policy.md"
+	},
 	{
 		"id": "platform.control-plane/control-plane.approval",
 		"title": "control-plane.approval",
@@ -39,6 +47,14 @@
 		"source": "generated",
 		"contentPath": "platform.control-plane/control-plane.skill-registry.md"
 	},
+	{
+		"id": "platform.control-plane/controlPlane.execution.abort",
+		"title": "controlPlane.execution.abort",
+		"summary": "Abort an execution-lane run immediately.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: execution, lane\n- **File**: `packages/libs/contracts-spec/src/control-plane/commands/controlPlaneExecutionAbort.command.ts`",
+		"route": "/docs/reference/platform.control-plane/controlPlane.execution.abort",
+		"source": "generated",
+		"contentPath": "platform.control-plane/controlPlane.execution.abort.md"
+	},
 	{
 		"id": "platform.control-plane/controlPlane.execution.approve",
 		"title": "controlPlane.execution.approve",
@@ -63,6 +79,14 @@
 		"source": "generated",
 		"contentPath": "platform.control-plane/controlPlane.execution.completed.md"
 	},
+	{
+		"id": "platform.control-plane/controlPlane.execution.evidence.export",
+		"title": "controlPlane.execution.evidence.export",
+		"summary": "Export the evidence set attached to an execution-lane run.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: execution, evidence\n- **File**: `packages/libs/contracts-spec/src/control-plane/commands/controlPlaneExecutionEvidenceExport.command.ts`",
+		"route": "/docs/reference/platform.control-plane/controlPlane.execution.evidence.export",
+		"source": "generated",
+		"contentPath": "platform.control-plane/controlPlane.execution.evidence.export.md"
+	},
 	{
 		"id": "platform.control-plane/controlPlane.execution.failed",
 		"title": "controlPlane.execution.failed",
@@ -79,6 +103,22 @@
 		"source": "generated",
 		"contentPath": "platform.control-plane/controlPlane.execution.get.md"
 	},
+	{
+		"id": "platform.control-plane/controlPlane.execution.lane.get",
+		"title": "controlPlane.execution.lane.get",
+		"summary": "Fetch the current state of one execution-lane run.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: execution, lane\n- **File**: `packages/libs/contracts-spec/src/control-plane/queries/controlPlaneExecutionLaneGet.query.ts`",
+		"route": "/docs/reference/platform.control-plane/controlPlane.execution.lane.get",
+		"source": "generated",
+		"contentPath": "platform.control-plane/controlPlane.execution.lane.get.md"
+	},
+	{
+		"id": "platform.control-plane/controlPlane.execution.lane.list",
+		"title": "controlPlane.execution.lane.list",
+		"summary": "List execution-lane runs with lane-focused filters.\n- **Type**: operation (query)\n- **Version**: 1.0.0\n- **Tags**: execution, lane\n- **File**: `packages/libs/contracts-spec/src/control-plane/queries/controlPlaneExecutionLaneList.query.ts`",
+		"route": "/docs/reference/platform.control-plane/controlPlane.execution.lane.list",
+		"source": "generated",
+		"contentPath": "platform.control-plane/controlPlane.execution.lane.list.md"
+	},
 	{
 		"id": "platform.control-plane/controlPlane.execution.list",
 		"title": "controlPlane.execution.list",
@@ -87,6 +127,14 @@
 		"source": "generated",
 		"contentPath": "platform.control-plane/controlPlane.execution.list.md"
 	},
+	{
+		"id": "platform.control-plane/controlPlane.execution.pause",
+		"title": "controlPlane.execution.pause",
+		"summary": "Pause an active execution-lane run.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: execution, lane\n- **File**: `packages/libs/contracts-spec/src/control-plane/commands/controlPlaneExecutionPause.command.ts`",
+		"route": "/docs/reference/platform.control-plane/controlPlane.execution.pause",
+		"source": "generated",
+		"contentPath": "platform.control-plane/controlPlane.execution.pause.md"
+	},
 	{
 		"id": "platform.control-plane/controlPlane.execution.reject",
 		"title": "controlPlane.execution.reject",
@@ -95,6 +143,30 @@
 		"source": "generated",
 		"contentPath": "platform.control-plane/controlPlane.execution.reject.md"
 	},
+	{
+		"id": "platform.control-plane/controlPlane.execution.resume",
+		"title": "controlPlane.execution.resume",
+		"summary": "Resume a paused execution-lane run.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: execution, lane\n- **File**: `packages/libs/contracts-spec/src/control-plane/commands/controlPlaneExecutionResume.command.ts`",
+		"route": "/docs/reference/platform.control-plane/controlPlane.execution.resume",
+		"source": "generated",
+		"contentPath": "platform.control-plane/controlPlane.execution.resume.md"
+	},
+	{
+		"id": "platform.control-plane/controlPlane.execution.retry",
+		"title": "controlPlane.execution.retry",
+		"summary": "Retry the current lane execution phase.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: execution, lane\n- **File**: `packages/libs/contracts-spec/src/control-plane/commands/controlPlaneExecutionRetry.command.ts`",
+		"route": "/docs/reference/platform.control-plane/controlPlane.execution.retry",
+		"source": "generated",
+		"contentPath": "platform.control-plane/controlPlane.execution.retry.md"
+	},
+	{
+		"id": "platform.control-plane/controlPlane.execution.shutdown",
+		"title": "controlPlane.execution.shutdown",
+		"summary": "Shutdown an execution-lane run and move it to a terminal state.\n- **Type**: operation (command)\n- **Version**: 1.0.0\n- **Tags**: execution, lane\n- **File**: `packages/libs/contracts-spec/src/control-plane/commands/controlPlaneExecutionShutdown.command.ts`",
+		"route": "/docs/reference/platform.control-plane/controlPlane.execution.shutdown",
+		"source": "generated",
+		"contentPath": "platform.control-plane/controlPlane.execution.shutdown.md"
+	},
 	{
 		"id": "platform.control-plane/controlPlane.execution.start",
 		"title": "controlPlane.execution.start",

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

@@ -39,6 +39,46 @@
 		"source": "generated",
 		"contentPath": "platform.database/database.schema.describe.md"
 	},
+	{
+		"id": "platform.database/docs.tech.database.context",
+		"title": "Database context",
+		"summary": "Database context covers schema descriptions, migrations, data dictionary entries, and governed read-only access.",
+		"route": "/docs/reference/platform.database/docs.tech.database.context",
+		"source": "generated",
+		"contentPath": "platform.database/docs.tech.database.context.md"
+	},
+	{
+		"id": "platform.database/docs.tech.database.dictionary.get",
+		"title": "database.dictionary.get",
+		"summary": "Returns semantic descriptions and PII tags for fields.",
+		"route": "/docs/reference/platform.database/docs.tech.database.dictionary.get",
+		"source": "generated",
+		"contentPath": "platform.database/docs.tech.database.dictionary.get.md"
+	},
+	{
+		"id": "platform.database/docs.tech.database.migrations.list",
+		"title": "database.migrations.list",
+		"summary": "Returns migration registry entries and statuses for auditability.",
+		"route": "/docs/reference/platform.database/docs.tech.database.migrations.list",
+		"source": "generated",
+		"contentPath": "platform.database/docs.tech.database.migrations.list.md"
+	},
+	{
+		"id": "platform.database/docs.tech.database.query.readonly",
+		"title": "database.query.readonly",
+		"summary": "Executes read-only data access using data views with policy and redaction.",
+		"route": "/docs/reference/platform.database/docs.tech.database.query.readonly",
+		"source": "generated",
+		"contentPath": "platform.database/docs.tech.database.query.readonly.md"
+	},
+	{
+		"id": "platform.database/docs.tech.database.schema.describe",
+		"title": "database.schema.describe",
+		"summary": "Returns deterministic schema summaries for agents and operators.",
+		"route": "/docs/reference/platform.database/docs.tech.database.schema.describe",
+		"source": "generated",
+		"contentPath": "platform.database/docs.tech.database.schema.describe.md"
+	},
 	{
 		"id": "platform.database/platform.database",
 		"title": "platform.database",

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

@@ -1,4 +1,12 @@
 [
+	{
+		"id": "platform.docs/AddNumbersSpec",
+		"title": "AddNumbersSpec",
+		"summary": "- **Type**: operation (command)\n- **Version**: 1.0.0\n- **File**: `packages/libs/contracts-spec/src/docs/docblocks.manifest.generated.ts`\n```typescript\nexport const AddNumbersSpec = defineCommand({\\n  meta: { name: 'math.add', version: '1.0.0', /* … */ },\\n  io: {\\n    input: AddNumbersInput,\\n    output: AddNumbersOutput,\\n  },\\n  policy: { auth: 'user' },\\n});",
+		"route": "/docs/reference/platform.docs/AddNumbersSpec",
+		"source": "generated",
+		"contentPath": "platform.docs/AddNumbersSpec.md"
+	},
 	{
 		"id": "platform.docs/docs_search",
 		"title": "docs_search",
@@ -7,6 +15,14 @@
 		"source": "generated",
 		"contentPath": "platform.docs/docs_search.md"
 	},
+	{
+		"id": "platform.docs/docs.accessibility_wcag_compliance_specs",
+		"title": "Accessibility & WCAG Compliance — **specs.md**",
+		"summary": "> **Goal:** Ship interfaces that are usable by everyone, by default. This spec sets non‑negotiable rules, checklists, and CI gates to meet **WCAG 2.2 AA** (aim for AAA where low‑cost), align with **EN 301 549** (EU), and keep parity on **web (Next.js)** and **mobile (Expo/React Native)**.",
+		"route": "/docs/reference/platform.docs/docs.accessibility_wcag_compliance_specs",
+		"source": "generated",
+		"contentPath": "platform.docs/docs.accessibility_wcag_compliance_specs.md"
+	},
 	{
 		"id": "platform.docs/docs.contract.reference",
 		"title": "docs.contract.reference",
@@ -39,6 +55,14 @@
 		"source": "generated",
 		"contentPath": "platform.docs/docs.layout.md"
 	},
+	{
+		"id": "platform.docs/docs.meta.docblocks-process",
+		"title": "platform.docs/docs.meta.docblocks-process",
+		"summary": "- Colocate docs beside implementation; avoid barrel /docs folders.\n- Split intent:\n- **goal**: why this exists (before implementation).\n- **how**: operational/runbook steps.\n- **usage**: quick checklist for consumers.",
+		"route": "/docs/reference/platform.docs/docs.meta.docblocks-process",
+		"source": "generated",
+		"contentPath": "platform.docs/docs.meta.docblocks-process.md"
+	},
 	{
 		"id": "platform.docs/docs.publish",
 		"title": "docs.publish",
@@ -79,6 +103,46 @@
 		"source": "generated",
 		"contentPath": "platform.docs/docs.system.md"
 	},
+	{
+		"id": "platform.docs/docs.tech.docs-generator",
+		"title": "Docs generator",
+		"summary": "The generator produces documentation artifacts, search metadata, and reference pages from ContractSpecs and DocBlocks.",
+		"route": "/docs/reference/platform.docs/docs.tech.docs-generator",
+		"source": "generated",
+		"contentPath": "platform.docs/docs.tech.docs-generator.md"
+	},
+	{
+		"id": "platform.docs/docs.tech.docs-publish",
+		"title": "Docs publish",
+		"summary": "Publishing moves generated artifacts to a hosting target with versioning and release metadata.",
+		"route": "/docs/reference/platform.docs/docs.tech.docs-publish",
+		"source": "generated",
+		"contentPath": "platform.docs/docs.tech.docs-publish.md"
+	},
+	{
+		"id": "platform.docs/docs.tech.docs-reference",
+		"title": "Contract reference",
+		"summary": "Contract reference pages are generated from spec metadata plus schema details and exposed as a docs-ready payload.",
+		"route": "/docs/reference/platform.docs/docs.tech.docs-reference",
+		"source": "generated",
+		"contentPath": "platform.docs/docs.tech.docs-reference.md"
+	},
+	{
+		"id": "platform.docs/docs.tech.docs-search",
+		"title": "Docs index and search",
+		"summary": "The docs index is the canonical list of DocBlocks exposed to UI, CLI, and MCP surfaces for filtering and retrieval.",
+		"route": "/docs/reference/platform.docs/docs.tech.docs-search",
+		"source": "generated",
+		"contentPath": "platform.docs/docs.tech.docs-search.md"
+	},
+	{
+		"id": "platform.docs/docs.tech.docs-system",
+		"title": "Docs system overview",
+		"summary": "ContractSpec treats documentation as a first-class output of your specs. The docs system combines contracts, DocBlocks, manifests, and presentations into a consistent docs surface.",
+		"route": "/docs/reference/platform.docs/docs.tech.docs-system",
+		"source": "generated",
+		"contentPath": "platform.docs/docs.tech.docs-system.md"
+	},
 	{
 		"id": "platform.docs/platform.docs",
 		"title": "platform.docs",