@agentskit/doc-bridge 1.0.2 → 1.2.1

package/ecosystem.json

@@ -0,0 +1,235 @@
+{
+  "schemaVersion": 2,
+  "$comment": "Canonical registry of AgentsKit ecosystem products. Stable identity lives here; numeric values live in the generated ecosystem-claims ledger. The deprecated properties array temporarily preserves v1 sibling consumers.",
+  "parentBrand": {
+    "id": "agentskit",
+    "name": "AgentsKit"
+  },
+  "products": [
+    {
+      "id": "agentskit",
+      "name": "AgentsKit",
+      "shortName": "AgentsKit",
+      "kind": "library",
+      "role": "foundation",
+      "promise": "Build agents without gluing many libraries together.",
+      "maturity": "beta",
+      "repo": "AgentsKit-io/agentskit",
+      "accent": "#2EA043",
+      "surfaces": {
+        "home": "https://www.agentskit.io",
+        "docs": "https://www.agentskit.io/docs",
+        "llms": "https://www.agentskit.io/llms.txt",
+        "stats": "https://www.agentskit.io/api/stats.json",
+        "documentation": "fumadocs",
+        "chat": "agentschat"
+      },
+      "navigation": {
+        "showInBar": true,
+        "order": 0,
+        "next": ["registry", "agentskit-chat", "playbook", "doc-bridge", "code-review", "akos"]
+      }
+    },
+    {
+      "id": "registry",
+      "name": "AgentsKit Registry",
+      "shortName": "Registry",
+      "kind": "registry",
+      "role": "starting-point",
+      "promise": "Copy ready-made agents and own the source.",
+      "maturity": "beta",
+      "repo": "AgentsKit-io/agentskit-registry",
+      "accent": "#58A6FF",
+      "surfaces": {
+        "home": "https://registry.agentskit.io",
+        "docs": "https://registry.agentskit.io/docs",
+        "llms": "https://registry.agentskit.io/llms.txt",
+        "stats": "https://registry.agentskit.io/r/index.json",
+        "documentation": "fumadocs",
+        "chat": "agentschat"
+      },
+      "navigation": {
+        "showInBar": true,
+        "order": 1,
+        "next": ["agentskit", "agentskit-chat", "playbook", "doc-bridge", "code-review", "akos"]
+      }
+    },
+    {
+      "id": "agentskit-chat",
+      "name": "AgentsKit Chat",
+      "shortName": "Chat",
+      "kind": "framework",
+      "role": "experience",
+      "promise": "Define one agent experience and deliver it across interfaces.",
+      "maturity": "alpha",
+      "repo": "AgentsKit-io/agentskit-chat",
+      "accent": "#F59E0B",
+      "surfaces": {
+        "home": "https://chat.agentskit.io",
+        "docs": "https://chat.agentskit.io/docs",
+        "llms": "https://chat.agentskit.io/llms.txt",
+        "documentation": "fumadocs",
+        "chat": "agentschat"
+      },
+      "navigation": {
+        "showInBar": true,
+        "order": 2,
+        "next": ["agentskit", "registry", "playbook", "doc-bridge", "code-review", "akos"]
+      }
+    },
+    {
+      "id": "playbook",
+      "name": "Agents Playbook",
+      "shortName": "Playbook",
+      "kind": "methodology",
+      "role": "discipline",
+      "promise": "Make agents ship code a human would actually merge.",
+      "maturity": "stable",
+      "repo": "AgentsKit-io/agents-playbook",
+      "accent": "#8B5CF6",
+      "surfaces": {
+        "home": "https://playbook.agentskit.io",
+        "docs": "https://playbook.agentskit.io/docs",
+        "llms": "https://playbook.agentskit.io/llms.txt",
+        "stats": "https://playbook.agentskit.io/api/stats.json",
+        "documentation": "fumadocs",
+        "chat": "custom"
+      },
+      "navigation": {
+        "showInBar": true,
+        "order": 3,
+        "next": ["agentskit", "registry", "agentskit-chat", "doc-bridge", "code-review", "akos"]
+      }
+    },
+    {
+      "id": "doc-bridge",
+      "name": "Doc Bridge",
+      "shortName": "Doc Bridge",
+      "kind": "developer-tool",
+      "role": "understanding",
+      "promise": "Turn repository documentation into executable agent handoffs.",
+      "maturity": "stable",
+      "repo": "AgentsKit-io/doc-bridge",
+      "accent": "#06B6D4",
+      "surfaces": {
+        "home": "https://agentskit-io.github.io/doc-bridge/",
+        "docs": "https://agentskit-io.github.io/doc-bridge/",
+        "llms": "https://agentskit-io.github.io/doc-bridge/llms.txt",
+        "documentation": "fumadocs",
+        "chat": "none"
+      },
+      "navigation": {
+        "showInBar": true,
+        "order": 4,
+        "next": ["agentskit", "registry", "agentskit-chat", "playbook", "code-review", "akos"]
+      }
+    },
+    {
+      "id": "code-review",
+      "name": "AgentsKit Code Review",
+      "shortName": "Code Review",
+      "kind": "developer-tool",
+      "role": "verification",
+      "promise": "Run deep, low-noise review with the model already in use.",
+      "maturity": "alpha",
+      "repo": "AgentsKit-io/code-review-cli",
+      "accent": "#F97316",
+      "surfaces": {
+        "home": "https://github.com/AgentsKit-io/code-review-cli",
+        "docs": "https://github.com/AgentsKit-io/code-review-cli#readme",
+        "llms": "https://raw.githubusercontent.com/AgentsKit-io/code-review-cli/main/llms.txt",
+        "documentation": "repository",
+        "chat": "none"
+      },
+      "navigation": {
+        "showInBar": true,
+        "order": 5,
+        "next": ["agentskit", "registry", "agentskit-chat", "playbook", "doc-bridge", "akos"]
+      }
+    },
+    {
+      "id": "akos",
+      "name": "AgentsKit OS",
+      "shortName": "AKOS",
+      "kind": "product",
+      "role": "operation",
+      "promise": "Run and govern agents in production.",
+      "maturity": "stable",
+      "repo": "AgentsKit-io/agentskit-os",
+      "accent": "#34D399",
+      "surfaces": {
+        "home": "https://akos.agentskit.io",
+        "docs": "https://akos.agentskit.io/docs",
+        "llms": "https://akos.agentskit.io/llms.txt",
+        "stats": "https://akos.agentskit.io/api/stats.json",
+        "documentation": "fumadocs",
+        "chat": "none"
+      },
+      "navigation": {
+        "showInBar": true,
+        "order": 6,
+        "next": []
+      }
+    }
+  ],
+  "properties": [
+    {
+      "id": "agentskit",
+      "name": "AgentsKit",
+      "barLabel": "AgentsKit",
+      "domain": "www.agentskit.io",
+      "url": "https://www.agentskit.io",
+      "repo": "AgentsKit-io/agentskit",
+      "tagline": "Build agents without gluing many libraries together.",
+      "kind": "library",
+      "accent": "#2EA043",
+      "llms": "https://www.agentskit.io/llms.txt",
+      "stats": "https://www.agentskit.io/api/stats.json"
+    },
+    {
+      "id": "akos",
+      "name": "AgentsKit OS",
+      "barLabel": "AKOS",
+      "domain": "akos.agentskit.io",
+      "url": "https://akos.agentskit.io",
+      "repo": "AgentsKit-io/agentskit-os",
+      "tagline": "Run and govern agents in production.",
+      "kind": "product",
+      "accent": "#34D399",
+      "llms": "https://akos.agentskit.io/llms.txt",
+      "stats": "https://akos.agentskit.io/api/stats.json"
+    },
+    {
+      "id": "playbook",
+      "name": "Agents Playbook",
+      "barLabel": "Playbook",
+      "domain": "playbook.agentskit.io",
+      "url": "https://playbook.agentskit.io",
+      "repo": "AgentsKit-io/agents-playbook",
+      "tagline": "Make agents ship code a human would actually merge.",
+      "kind": "methodology",
+      "accent": "#8B5CF6",
+      "llms": "https://playbook.agentskit.io/llms.txt",
+      "stats": "https://playbook.agentskit.io/api/stats.json"
+    },
+    {
+      "id": "registry",
+      "name": "AgentsKit Registry",
+      "barLabel": "Registry",
+      "domain": "registry.agentskit.io",
+      "url": "https://registry.agentskit.io",
+      "repo": "AgentsKit-io/agentskit-registry",
+      "tagline": "Copy ready-made agents and own the source.",
+      "kind": "registry",
+      "accent": "#58A6FF",
+      "llms": "https://registry.agentskit.io/llms.txt",
+      "stats": "https://registry.agentskit.io/r/index.json"
+    }
+  ],
+  "builder": {
+    "id": "emersonbraun",
+    "name": "Emerson Braun",
+    "url": "https://emersonbraun.dev",
+    "$comment": "Link-source only. The builder is not a peer product and is not shown in shared product navigation."
+  }
+}

package/examples/verify-handoff.mjs

@@ -0,0 +1,5 @@
+import { execFileSync } from 'node:child_process'
+
+execFileSync(process.execPath, ['bin/ak-docs.js', 'demo', '--text'], {
+  stdio: 'inherit',
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentskit/doc-bridge",
-  "version": "1.0.2",
+  "version": "1.2.1",
   "description": "Human↔agent documentation bridge — deterministic handoffs, doc-site links, memory→docs, optional AgentsKit RAG/chat.",
   "type": "module",
   "bin": {
@@ -23,6 +23,10 @@
     "bin",
     "action.yml",
     "scripts/prepare.mjs",
+    "scripts/check-ecosystem-upstream.mjs",
+    "ecosystem.json",
+    "ecosystem-claims.json",
+    "ecosystem-upstream.json",
     "docs",
     "examples",
     "README.md",
@@ -41,6 +45,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "coverage": "vitest run --coverage",
+    "check:ecosystem-upstream": "node scripts/check-ecosystem-upstream.mjs",
+    "check:no-legacy-chat-imports": "node scripts/check-no-legacy-chat-imports.mjs",
     "typecheck": "tsc --noEmit",
     "smoke:packaged": "node scripts/smoke-packaged.mjs",
     "smoke:docsites": "node scripts/smoke-docsites.mjs",
@@ -48,12 +54,24 @@
     "smoke:ollama": "node scripts/smoke-ollama.mjs",
     "coverage:badge": "node scripts/update-coverage-badge.mjs",
     "changeset": "changeset",
-    "version-packages": "changeset version",
+    "version-packages": "changeset version && node scripts/sync-version.mjs",
     "release": "npm run build && npm test && changeset publish",
-    "version": "node scripts/sync-version.mjs && git add package.json src/version.ts",
+    "version": "node scripts/sync-version.mjs && git add package.json src/version.ts action.yml",
     "prepublishOnly": "npm run build && npm test",
     "prepare": "node scripts/prepare.mjs",
-    "prepack": "npm run build"
+    "prepack": "npm run build",
+    "docs:dev": "cd apps/docs && next dev",
+    "docs:artifacts": "node scripts/build-docs-artifacts.mjs",
+    "docs:build": "pnpm build && node bin/ak-docs.js index && pnpm docs:artifacts && cd apps/docs && next build",
+    "docs:typecheck": "cd apps/docs && fumadocs-mdx && tsc --noEmit",
+    "docs:e2e": "playwright test",
+    "docs:lighthouse": "lhci autorun",
+    "test:readme-standard": "node --test scripts/readme-standard.test.mjs",
+    "test:marketplace": "node --test scripts/marketplace-contract.test.mjs",
+    "check:marketplace": "node scripts/check-marketplace-contract.mjs",
+    "test:docs-artifacts": "node --test scripts/docs-artifacts-contract.test.mjs",
+    "check:readme-standard": "node scripts/check-readme-standard.mjs",
+    "check:docs": "pnpm check:readme-standard && node bin/ak-docs.js gate run && node bin/ak-docs.js conformance run documentation-standard-v1 --text && pnpm docs:typecheck && pnpm docs:build && pnpm test:docs-artifacts"
   },
   "keywords": [
     "agentskit",
@@ -108,13 +126,37 @@
     }
   },
   "devDependencies": {
+    "@agentskit/chat": "0.3.0",
+    "@agentskit/core": "1.12.3",
+    "@agentskit/react": "0.7.4",
     "@changesets/cli": "^2.31.0",
+    "@lhci/cli": "^0.15.1",
+    "@playwright/test": "1.61.1",
+    "@tailwindcss/postcss": "4.3.2",
     "@types/node": "^22.15.3",
+    "@types/react": "19.0.0",
+    "@types/react-dom": "19.0.0",
     "@vitest/coverage-v8": "4.1.10",
+    "fumadocs-core": "15.6.5",
+    "fumadocs-mdx": "11.6.4",
+    "fumadocs-ui": "15.6.5",
+    "lucide-react": "0.460.0",
+    "next": "15.5.19",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "tailwindcss": "4.3.2",
     "tsup": "^8.5.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.9"
   },
+  "pnpm": {
+    "overrides": {
+      "esbuild": "^0.28.1",
+      "postcss": "8.5.19",
+      "tmp": "0.2.7",
+      "uuid": "11.1.1"
+    }
+  },
   "directories": {
     "doc": "docs",
     "example": "examples",

package/scripts/check-ecosystem-upstream.mjs

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { createHash } from 'node:crypto'
+import { readFileSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), '..')
+const metadata = JSON.parse(readFileSync(join(root, 'ecosystem-upstream.json'), 'utf8'))
+if (metadata.schemaVersion !== 1 || typeof metadata.repository !== 'string' || typeof metadata.ref !== 'string') {
+  throw new Error('Invalid ecosystem-upstream.json metadata.')
+}
+
+const sha256 = (value) => createHash('sha256').update(value).digest('hex')
+const requiredFiles = ['ecosystem.json', 'ecosystem-claims.json']
+if (
+  !metadata.files ||
+  Object.keys(metadata.files).length !== requiredFiles.length ||
+  requiredFiles.some((file) => !/^[a-f0-9]{64}$/.test(metadata.files[file] ?? ''))
+) {
+  throw new Error('Upstream metadata must contain SHA-256 digests for both canonical files.')
+}
+
+const fetchText = async (url) => {
+  let lastError
+  for (let attempt = 1; attempt <= 2; attempt += 1) {
+    try {
+      const response = await fetch(url, { signal: AbortSignal.timeout(10_000) })
+      if (!response.ok) throw new Error(`HTTP ${response.status}`)
+      return await response.text()
+    } catch (error) {
+      lastError = error
+    }
+  }
+  throw new Error(`Unable to verify ${url}: ${lastError instanceof Error ? lastError.message : String(lastError)}`)
+}
+
+for (const file of requiredFiles) {
+  const expectedDigest = metadata.files[file]
+  const local = readFileSync(join(root, file), 'utf8')
+  const localDigest = sha256(local)
+  if (localDigest !== expectedDigest) {
+    throw new Error(`${file} differs from its recorded upstream SHA-256 digest.`)
+  }
+  const url = `https://raw.githubusercontent.com/${metadata.repository}/${metadata.ref}/${file}`
+  const upstream = await fetchText(url)
+  if (sha256(upstream) !== expectedDigest || upstream !== local) {
+    throw new Error(`${file} is stale against ${metadata.repository}@${metadata.ref}. Sync the canonical snapshot and digest.`)
+  }
+  process.stdout.write(`ecosystem upstream parity: ${file}\n`)
+}

package/src/cli/program.ts

@@ -4,6 +4,11 @@ import { createInterface } from 'node:readline/promises'
 
 import { loadConfig, projectRootFromConfigPath } from '../config/load-config.js'
 import type { DocBridgeConfigV1 } from '../config/schema.js'
+import {
+  DOCUMENTATION_STANDARD_V1_ID,
+  formatDocumentationStandardText,
+  runDocumentationStandardV1,
+} from '../conformance/documentation-standard-v1.js'
 import { buildDocBridgeIndex } from '../index-builder/build-index.js'
 import { discoverPnpmPackages } from '../index-builder/plugins/pnpm-monorepo.js'
 import { scanHumanDocRecords } from '../index-builder/human-adapters/index.js'
@@ -55,6 +60,7 @@ type Command =
   | 'chat'
   | 'rag'
   | 'list'
+  | 'conformance'
 
 const usage = `ak-docs — human↔agent documentation bridge (@agentskit/doc-bridge)
 
@@ -68,6 +74,7 @@ Core (no API key):
   ak-docs list <packages|intents|changes|knowledge> [--text]
   ak-docs ask [question]          local consult (no LLM)
   ak-docs gate run [gate-id]
+  ak-docs conformance run documentation-standard-v1 [--text|--json]
   ak-docs mcp
   ak-docs mcp install --cursor | --claude
   ak-docs memory ingest|classify|promote [--pr] [--dry-run]
@@ -92,7 +99,13 @@ Global flags:
 
 const QUERY_KINDS = new Set<QueryKind>(['package', 'ownership', 'intent', 'change', 'search'])
 const LIST_KINDS = new Set(['packages', 'intents', 'changes', 'knowledge'])
-const GATE_IDS = new Set<GateId>(['index-freshness', 'human-guide-links', 'okf-type', 'docs-style'])
+const GATE_IDS = new Set<GateId>([
+  'index-freshness',
+  'human-guide-links',
+  'okf-type',
+  'docs-style',
+  'documentation-standard-v1',
+])
 
 const parseArgs = (argv: readonly string[]) => {
   const flags = new Set<string>()
@@ -136,6 +149,7 @@ const parseArgs = (argv: readonly string[]) => {
   else if (positional[0] === 'chat') command = 'chat'
   else if (positional[0] === 'rag') command = 'rag'
   else if (positional[0] === 'list') command = 'list'
+  else if (positional[0] === 'conformance') command = 'conformance'
 
   return { command, flags, configPath, positional }
 }
@@ -782,12 +796,12 @@ export const runCli = (argv: readonly string[]): number | undefined | Promise<nu
     const action = positional[1]
     const gateId = positional[2] as GateId | undefined
     if (action !== 'run') {
-      process.stderr.write('Usage: ak-docs gate run [index-freshness]\n')
+      process.stderr.write('Usage: ak-docs gate run [gate-id]\n')
       return 1
     }
     if (gateId && !GATE_IDS.has(gateId)) {
       process.stderr.write(
-        `Unsupported gate "${gateId}". Supported gates: index-freshness, human-guide-links, okf-type, docs-style\n`,
+        `Unsupported gate "${gateId}". Supported gates: ${[...GATE_IDS].join(', ')}\n`,
       )
       return 1
     }
@@ -802,6 +816,25 @@ export const runCli = (argv: readonly string[]): number | undefined | Promise<nu
     }
   }
 
+  if (command === 'conformance') {
+    const action = positional[1]
+    const profile = positional[2]
+    if (action !== 'run' || profile !== DOCUMENTATION_STANDARD_V1_ID) {
+      process.stderr.write(`Usage: ak-docs conformance run ${DOCUMENTATION_STANDARD_V1_ID} [--text|--json]\n`)
+      return 1
+    }
+    try {
+      const { config, root } = loadProject(configPath)
+      const report = runDocumentationStandardV1(root, config)
+      if (wantsTextOutput(flags, config)) writeLines(formatDocumentationStandardText(report))
+      else writeJson(report)
+      return report.ok ? 0 : 1
+    } catch (error) {
+      process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`)
+      return 1
+    }
+  }
+
   if (command === 'mcp') {
     if (positional[1] === 'install') {
       const target = flags.has('--claude') ? 'claude' : flags.has('--cursor') ? 'cursor' : undefined

package/src/config/index.ts

@@ -10,6 +10,12 @@ export {
   DocBridgeConfigV1Schema,
   AgentCorpusConfigSchema,
   HumanCorpusConfigSchema,
+  DocumentationStandardRuleIdSchema,
+  DocumentationStandardV1ConfigSchema,
+  EcosystemContractEvidenceSchema,
+  ConformanceConfigSchema,
   type DocBridgeConfigV1,
   type AgentCorpusConfig,
-} from './schema.js'
+  type DocumentationStandardRuleId,
+  type DocumentationStandardV1Config,
+} from './schema.js'

package/src/config/load-config.ts

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync } from 'node:fs'
 import { basename, dirname, join, resolve } from 'node:path'
-import vm from 'node:vm'
 
+import { parseStaticJsObject } from '../lib/static-js-literal.js'
 import { applyConfigDefaults } from './defaults.js'
 import { DocBridgeConfigV1Schema, type DocBridgeConfigV1 } from './schema.js'
 
@@ -60,28 +60,18 @@ const parseJsonConfig = (raw: string, path: string): unknown => {
 }
 
 const parseCodeConfig = (raw: string, path: string): unknown => {
-  const code = raw
+  const unsupportedImports = raw
     .replace(/import\s+type\s+[\s\S]*?;?\n/g, '')
     .replace(/import\s+\{\s*defineConfig\s*\}\s+from\s+['"]@agentskit\/doc-bridge(?:\/config)?['"];?\n?/g, '')
-    .replace(/\s+satisfies\s+[A-Za-z0-9_.$<>{}\[\],\s]+(?=\s*(?:;|\)|$))/g, '')
-    .replace(/export\s+default/, 'module.exports.default =')
-
-  if (/\bimport\b/.test(code)) {
+  if (/\bimport\b/.test(unsupportedImports)) {
     throw new Error(`Unsupported import in ${path}. Static config only supports defineConfig imports.`)
   }
-
-  const sandbox = {
-    module: { exports: {} as { default?: unknown } },
-    exports: {},
-    defineConfig: (config: unknown) => config,
-  }
   try {
-    vm.runInNewContext(code, sandbox, { timeout: 250, filename: path })
+    return parseStaticJsObject(raw)
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error)
     throw new Error(`Failed to load config at ${path}: ${message}`)
   }
-  return sandbox.module.exports.default
 }
 
 const parseConfig = (input: unknown): DocBridgeConfigV1 => {

package/src/config/schema.ts

@@ -124,6 +124,7 @@ export const GatesConfigSchema = z
           'docs-style',
           'routing-currency',
           'bootstrap-size',
+          'documentation-standard-v1',
         ]),
       )
       .max(16)
@@ -138,6 +139,7 @@ export const GatesConfigSchema = z
           'docs-style',
           'routing-currency',
           'bootstrap-size',
+          'documentation-standard-v1',
         ]),
       )
       .max(16)
@@ -264,6 +266,92 @@ export const FederationConfigSchema = z
   })
   .strict()
 
+export const DocumentationEvidenceFileSchema = z
+  .object({
+    path: z.string().min(1).max(512),
+    contains: z.array(z.string().min(1).max(512)).min(1).max(32),
+  })
+  .strict()
+
+export const DocumentationLinkEvidenceSchema = z
+  .object({
+    url: z.string().url().max(512),
+    paths: z.array(z.string().min(1).max(512)).min(1).max(32),
+  })
+  .strict()
+
+export const DocumentationQuickstartEvidenceSchema = z
+  .object({
+    id: z.string().regex(/^[a-z][a-z0-9-]*$/).max(128),
+    doc: z.string().min(1).max(512),
+    test: z.string().min(1).max(512),
+    command: z.string().min(1).max(512),
+    testContains: z.array(z.string().min(1).max(256)).min(1).max(16),
+  })
+  .strict()
+
+export const EcosystemContractEvidenceSchema = z
+  .object({
+    manifest: z.string().min(1).max(512),
+    claims: z.string().min(1).max(512),
+    productId: z.string().regex(/^[a-z][a-z0-9-]*$/).max(128),
+  })
+  .strict()
+
+export const DocumentationStandardRuleIdSchema = z.enum([
+  'human-docs',
+  'llms-and-raw-source',
+  'agent-handoffs',
+  'contribution',
+  'metadata',
+  'cross-links',
+  'tested-quickstarts',
+  'visual-explanations',
+  'structured-diagrams',
+])
+
+export const DocumentationStandardExceptionSchema = z
+  .object({
+    ruleId: DocumentationStandardRuleIdSchema,
+    reason: z.string().min(10).max(1_024),
+    approvedBy: z.string().min(1).max(256),
+    trackingUrl: z.string().url().max(512),
+  })
+  .strict()
+
+export const DocumentationStandardV1ConfigSchema = z
+  .object({
+    rawSources: z.array(z.string().min(1).max(512)).max(64).optional(),
+    contributionPaths: z.array(z.string().min(1).max(512)).max(16).optional(),
+    metadata: z.array(DocumentationEvidenceFileSchema).max(32).optional(),
+    links: z.array(DocumentationLinkEvidenceSchema).max(64).optional(),
+    quickstarts: z.array(DocumentationQuickstartEvidenceSchema).max(32).optional(),
+    visuals: z.array(z.string().min(1).max(512)).max(64).optional(),
+    diagrams: z.array(DocumentationEvidenceFileSchema).max(32).optional(),
+    ecosystemContract: EcosystemContractEvidenceSchema.optional(),
+    exceptions: z.array(DocumentationStandardExceptionSchema).max(32).optional(),
+  })
+  .strict()
+  .superRefine((value, context) => {
+    const seen = new Set<string>()
+    for (const [index, exception] of (value.exceptions ?? []).entries()) {
+      if (seen.has(exception.ruleId)) {
+        context.addIssue({
+          code: 'custom',
+          path: ['exceptions', index, 'ruleId'],
+          message: `Duplicate exception for rule ${exception.ruleId}`,
+        })
+      }
+      seen.add(exception.ruleId)
+    }
+  })
+
+export const ConformanceConfigSchema = z
+  .object({
+    documentationStandardV1: DocumentationStandardV1ConfigSchema.optional(),
+  })
+  .strict()
+
 export const DocBridgeConfigV1Schema = z
   .object({
     schemaVersion: z.literal(CONFIG_SCHEMA_VERSION),
@@ -286,9 +374,12 @@ export const DocBridgeConfigV1Schema = z
     surfaces: SurfacesConfigSchema.optional(),
     intelligence: IntelligenceConfigSchema.optional(),
     federation: FederationConfigSchema.optional(),
+    conformance: ConformanceConfigSchema.optional(),
   })
   .strict()
 
 export type DocBridgeConfigV1 = z.infer<typeof DocBridgeConfigV1Schema>
 export type AgentCorpusConfig = z.infer<typeof AgentCorpusConfigSchema>
 export type HumanCorpusConfig = z.infer<typeof HumanCorpusConfigSchema>
+export type DocumentationStandardV1Config = z.infer<typeof DocumentationStandardV1ConfigSchema>
+export type DocumentationStandardRuleId = z.infer<typeof DocumentationStandardRuleIdSchema>