@contractspec/bundle.library 3.0.0 → 3.2.0

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

@@ -1,4 +1,204 @@
 [
+  {
+    "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/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",
@@ -263,6 +463,46 @@
     "source": "generated",
     "contentPath": "_common/controlPlane.trace.get.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",
@@ -351,6 +591,94 @@
     "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",
@@ -429,6 +757,237 @@
     "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.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.auth.better-auth-nextjs",
     "title": "Better Auth + Next.js integration (ContractSpec)",
@@ -452,6 +1011,94 @@
     "visibility": "public",
     "owners": ["@contractspec/app.cli-contractspec"]
   },
+  {
+    "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.openapi-export",
     "title": "OpenAPI export (OpenAPI 3.1) from OperationSpecRegistry",
@@ -507,6 +1154,72 @@
     "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",
@@ -650,6 +1363,171 @@
     "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/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",
@@ -826,7 +1704,7 @@
   {
     "id": "docs.tech.workflows.overview",
     "title": "WorkflowSpec Overview",
-    "summary": "WorkflowSpec provides a declarative, versioned format for long-running flows that mix automation and human review. Specs stay inside `@contractspec/lib.contracts-spec` (`src/workflow/spec.ts`) so the same definition powers runtime execution, documentation, and future generation.",
+    "summary": "WorkflowSpec provides a declarative, versioned format for long-running flows that mix automation and human review, including runtime adapter capabilities/ports for checkpointing and suspend-resume orchestration. 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",