build: doc-sync gates — typecheck doc code blocks + verify event taxonomy (RFC 006 pts 1-2)

Two tsx CI gates make doc/code drift fail fast:
- doc-typecheck extracts every fenced ts block from README/docs/package READMEs,
  compiles them with tsc --noEmit against a temp project (vendor->lib, harness->src
  paths from tsconfig.typecheck.json), and fails on errors. Deliberate sketches opt
  out with ```ts ignore-check; the opt-out ratio is reported and capped.
- verify-event-taxonomy asserts the docs/architecture.md taxonomy table names
  exactly the events declared in the interface Events blocks. This surfaced three
  events the table had been missing (tools/change, llm/adapter-change,
  system-prompt/change), now added.

Doc snippets made compilable with stub imports/declares (1 genuine sketch ignored).
Wired into CI after typecheck. API reports (RFC 006 pt 3) deferred. Graduates RFC
006 pts 1-2 -> ADR 0014.

scripts/verify-event-taxonomy.ts

@@ -0,0 +1,98 @@
+/**
+ * Doc-sync gate (RFC 006 part 2): verify the event-taxonomy table in
+ * docs/architecture.md against the events actually declared in source.
+ *
+ * The table duplicates the `declare module 'cordis' { interface Events }`
+ * blocks across packages/* /src. This script extracts both sets of event names
+ * and asserts they match exactly — every declared event appears in the table,
+ * and the table names no event that isn't declared. Verify, don't generate
+ * (per the RFC): the table keeps its hand-written Mode/Purpose columns; only
+ * the set of names is checked.
+ *
+ * Run: `tsx scripts/verify-event-taxonomy.ts`.
+ */
+
+import { readFileSync } from 'node:fs'
+import { join, relative, resolve } from 'node:path'
+import { glob } from 'node:fs/promises'
+
+const root = resolve(import.meta.dirname, '..')
+
+/**
+ * Event names declared in source: the keys inside every `interface Events`
+ * block under packages/* /src. A declared event is a quoted `'scope/name'(`
+ * method signature at the start of a line within such a block.
+ */
+async function declaredEvents(): Promise<Map<string, string>> {
+  const found = new Map<string, string>()
+  for await (const match of glob('packages/*/src/**/*.ts', { cwd: root })) {
+    const abs = resolve(root, match)
+    const text = readFileSync(abs, 'utf8')
+    // Walk `interface Events {` blocks brace-balanced and pull quoted keys.
+    const re = /interface\s+Events\s*\{/g
+    let m: RegExpExecArray | null
+    while ((m = re.exec(text)) !== null) {
+      let depth = 1
+      let i = m.index + m[0].length
+      const start = i
+      while (i < text.length && depth > 0) {
+        const ch = text[i]
+        if (ch === '{') depth++
+        else if (ch === '}') depth--
+        i++
+      }
+      const body = text.slice(start, i - 1)
+      // A declaration is a quoted event name followed by `(` (method form).
+      for (const k of body.matchAll(/['"]([a-z][a-z-]*\/[a-z-]+)['"]\s*\(/g)) {
+        const name = k[1]
+        if (name) found.set(name, relative(root, abs))
+      }
+    }
+  }
+  return found
+}
+
+/** Event names referenced in the architecture-doc taxonomy table (in `code`). */
+function tableEvents(): Set<string> {
+  const text = readFileSync(join(root, 'docs/architecture.md'), 'utf8')
+  const lines = text.split('\n')
+  const heading = lines.findIndex(l => /^###\s+Event taxonomy/.test(l))
+  if (heading === -1) throw new Error('verify-event-taxonomy: "### Event taxonomy" heading not found')
+  const names = new Set<string>()
+  for (let i = heading + 1; i < lines.length; i++) {
+    const line = lines[i] ?? ''
+    if (/^###\s/.test(line)) break // next section ends the table
+    if (!line.includes('|')) continue
+    for (const code of line.matchAll(/`([^`]+)`/g)) {
+      // A cell may read "`a/b` / `c/d` (pkg)" — pull each scoped name.
+      for (const name of (code[1] ?? '').matchAll(/[a-z][a-z-]*\/[a-z-]+/g)) names.add(name[0])
+    }
+  }
+  return names
+}
+
+const declared = await declaredEvents()
+const table = tableEvents()
+
+const declaredNames = new Set(declared.keys())
+const missingFromTable = [...declaredNames].filter(n => !table.has(n)).sort()
+const missingFromSource = [...table].filter(n => !declaredNames.has(n)).sort()
+
+if (missingFromTable.length === 0 && missingFromSource.length === 0) {
+  console.log(`verify-event-taxonomy: ${declaredNames.size} events match the architecture-doc table.`)
+  process.exit(0)
+}
+
+if (missingFromTable.length > 0) {
+  console.error('verify-event-taxonomy: declared in source but MISSING from the docs/architecture.md table:')
+  for (const n of missingFromTable) {
+    console.error(`  ${n}  (declared in ${declared.get(n) ?? '?'})`)
+  }
+}
+if (missingFromSource.length > 0) {
+  console.error('verify-event-taxonomy: named in the table but NOT declared in source (stale doc):')
+  for (const n of missingFromSource) {
+    console.error(`  ${n}`)
+  }
+}
+process.exit(1)