feat(page)!: page-as-extension direct rewrite - dispatcher, 38 client-bodied verbs, catalog-derived CLI (#269)

[omridevk]

Stacked on #275 -> #268; retarget after they merge.

The page-as-extension DIRECT rewrite chain (#255 epic): page stops being a special case. Every page verb is a defineTool().client(body) declaration in @conciv/extension-page, dispatched by name through the registry over one wire, gated through the same decide() path as every extension.

Scope map

Dispatcher, final form — packages/page/src/page-tool-dispatcher.ts: instance-scoped name -> __clientExecute lookup off client tools passed as an argument to makeDomPageDriver/startPagePlane; per-call ClientToolCtx (document, lazy target(locator) with mirror-on-resolve per declaration meta, non-throwing resolve, addRef/resetRefs, console reader); zero module-level state. page-driver.ts is dispatcher-only; DOM_HANDLERS/page-handlers.ts are gone.

Final wire — PageQuerySchema is {requestId, name, input} (protocol page-types.ts); no kind enum, no field-bag, no legacy union. The bus timeout budget peeks input.timeout.

All 38 verbs — 37 declarations in packages/extensions/page/src/shared/defs.ts, browser bodies in src/client/bodies.ts calling @conciv/page primitives (react bridge, snapshot/refs, dehydrate, render tracker stay put). effect carries as the documented stub, catalog-honest. The 38th (ext) died with the vocabulary. locate is server-wraps-client (P6): the client body returns raw frames, the server half (src/server.ts) symbolicates via symbolicateFrames threaded into mount deps. Core always mounts the page server extension; the embed always prepends the page client extension, so every host keeps page capability with no per-host wiring.

One registration ratchet — isRegistryDeclared covers client-bodied tools (binding + meta/outputSchema); registration reads mount SURVIVORS (createInstances drops a throwing __client(); the driver collects tools off router.options.context.instances). The spike's registerExtensionClientTools shape is unified into registerExtensionTools.

Vocabulary deleted — PAGE_QUERY_KINDS, PageQueryInputSchema, MUTATING_KINDS/MIRROR_KINDS + helpers, page.run (rpc + contract), ext kind, PageVerbMap/definePageVerbs/page-verb-registry.ts/bindExtensionPageVerbs, scopedPageCaller, BUILTIN_PAGE_TOOLS. Widget action cards and running titles read labels/icons from the declaration metadata (@conciv/extension-page/defs); mutating/mirror/journal are meta-driven everywhere (journal entries now carry full tool names, e.g. page.fill).

CLI re-derives (P3) — rpc.registry.catalog (signatures incl. JSON-schema inputs) + rpc.registry.call replace rpc.page.run; conciv tools page/conciv tools react build their command trees at runtime from the catalog (packages/cli/src/page.ts, wireToolCommand).

decide() on every surface — chat: conciv_page calls with a mutating verb (per registry meta) prompt through the run gate; code-mode: page tools are registry capabilities, already gated by gatedToolRun; CLI: the blanket conciv tools* Bash allow is gone, replaced by catalog-derived read-only allows, so a mutating CLI page command surfaces the Approve/Deny card.

TanStack (P8) — the 14 pageVerbs are .client() tools (tanstack.detect ... tanstack.back, src/shared/verb-defs.ts with real zod result schemas mirroring framework-types); the framework adapter reaches its own browser tools through server.tools.call (registry threaded into mount deps); callPageVerb/PageCaller died. ServerApi now carries page.call (raw browser ask), tools.call (registry), and symbolicate.

conciv_open (noted in #275's report): verified NOT redundant as a surface — it is the chat-facing tool the system prompts name, while registry open serves code-mode/rpc. The duplicate execution path IS gone: conciv_open now executes through registry.call('open', ...).

Grep proofs (all zero)

grep -rn "DOM_HANDLERS\|PAGE_QUERY_KINDS\|PageVerbMap\|page\.run\|dispatchExtVerb\|scopedPageCaller\|BUILTIN_PAGE_TOOLS\|callPageVerb\|pagespike\|PageQueryInputSchema\|MUTATING_KINDS\|MIRROR_KINDS\|definePageVerbs\|registerExtensionPageVerbs" \
  --include='*.ts' --include='*.tsx' --include='*.mdx' packages apps e2e   # -> no matches

Verification

• turbo run typecheck build --filter='!@conciv/extension-whiteboard' — 107/107 green
• turbo run test --concurrency=1 (VITEST_MAX_FORKS=1, whiteboard excluded per repo rule) — green; bootNormal (page-plane.it) AND bootConnect (page-dispatch-boot.it) ITs green against the prebuilt embed; the moved page behavior suite runs in packages/extensions/page/test in a real browser; whiteboard verifies in CI
• pnpm lint, pnpm format:check — green
• fallow audit --changed-since origin/registry-cleanup-232 — verdict pass, zero INTRODUCED

Closes #269

🤖 Generated with Claude Code