refactor(devframe): namespace adapters and invert client dep from kit

Move the six adapters (cli/build/spa/vite/kit/embedded) into
`devframe/adapters/*` so they're clearly grouped and no longer share the
top-level subpath namespace. Relocate the framework-neutral RPC client
surface from `@vitejs/devtools-kit/client` into `devframe/client`,
including `rpc`, `rpc-shared-state`, `rpc-static`, `rpc-ws`, `static-rpc`,
`docks`, and `context`. Kit now re-exports `devframe/client` plus its
kit-only `remote` + `client-script` helpers, establishing that devframe
must never depend on vite or any `@vitejs/*` package. Add a Dep Boundary
section to AGENTS.md documenting the rule.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: antfu

AGENTS.md

@@ -8,7 +8,7 @@ Monorepo (`pnpm` workspaces + `turbo`). ESM TypeScript; bundled with `tsdown`. P
 
 | Package | npm | Description |
 |---------|-----|-------------|
-| `packages/devframe` | `devframe` | Framework-neutral foundation — RPC layer (birpc + valibot + WS presets), host classes, createHostContext, six adapters (cli/build/spa/vite/kit/embedded), connectDevtool client |
+| `packages/devframe` | `devframe` | Framework-neutral foundation — RPC layer (birpc + valibot + WS presets), host classes, createHostContext, six adapters at `devframe/adapters/*` (cli/build/spa/vite/kit/embedded), connectDevtool client |
 | `packages/core` | `@vitejs/devtools` | Vite plugin, CLI, standalone/webcomponents client. Wraps devframe's createHostContext with the Vite plugin scan |
 | `packages/kit` | `@vitejs/devtools-kit` | Vite-specific superset of devframe — adds PluginWithDevTools, ViteDevToolsNodeContext, and re-exports devframe's public types |
 | `packages/ui` | `@vitejs/devtools-ui` | Shared UI components, composables, and UnoCSS preset (`presetDevToolsUI`). Private, not published |
@@ -32,6 +32,10 @@ flowchart TD
   webext --> core
 ```
 
+## Dep Boundary
+
+`packages/devframe` is the lowest-level package in this monorepo and is positioned to be extracted into its own repo. It MUST NOT import from `vite` or any `@vitejs/*` package — not as a `dependencies` entry, not as an inlined dep, not as a source import. `packages/kit` and above build on top of devframe, never the reverse.
+
 ## Architecture
 
 - **Entry**: `createDevToolsContext` (`packages/core/src/node/context.ts`) builds `DevToolsNodeContext` with hosts for RPC, docks, views, terminals. Invokes `plugin.devtools.setup` hooks.

alias.ts

@@ -21,13 +21,13 @@ export const alias = {
   'devframe/utils/shared-state': r('devframe/src/utils/shared-state.ts'),
   'devframe/utils/state': r('devframe/src/utils/state.ts'),
   'devframe/utils/when': r('devframe/src/utils/when.ts'),
-  'devframe/cli': r('devframe/src/cli.ts'),
-  'devframe/build': r('devframe/src/build.ts'),
-  'devframe/spa': r('devframe/src/spa.ts'),
-  'devframe/vite': r('devframe/src/vite.ts'),
-  'devframe/kit': r('devframe/src/kit.ts'),
-  'devframe/embedded': r('devframe/src/embedded.ts'),
-  'devframe/client': r('devframe/src/client.ts'),
+  'devframe/adapters/cli': r('devframe/src/adapters/cli.ts'),
+  'devframe/adapters/build': r('devframe/src/adapters/build.ts'),
+  'devframe/adapters/spa': r('devframe/src/adapters/spa.ts'),
+  'devframe/adapters/vite': r('devframe/src/adapters/vite.ts'),
+  'devframe/adapters/kit': r('devframe/src/adapters/kit.ts'),
+  'devframe/adapters/embedded': r('devframe/src/adapters/embedded.ts'),
+  'devframe/client': r('devframe/src/client/index.ts'),
   'devframe': r('devframe/src'),
   '@vitejs/devtools-kit/node': r('kit/src/node/index.ts'),
   '@vitejs/devtools-kit/client': r('kit/src/client/index.ts'),

examples/devframe-counter/bin.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import process from 'node:process'
-import { createCli } from 'devframe/cli'
+import { createCli } from 'devframe/adapters/cli'
 import devtool from './src/devtool.ts'
 
 async function main() {

packages/devframe/package.json

@@ -20,19 +20,20 @@
   "sideEffects": false,
   "exports": {
     ".": "./dist/index.mjs",
-    "./build": "./dist/build.mjs",
-    "./cli": "./dist/cli.mjs",
-    "./client": "./dist/client.mjs",
+    "./adapters/build": "./dist/adapters/build.mjs",
+    "./adapters/cli": "./dist/adapters/cli.mjs",
+    "./adapters/embedded": "./dist/adapters/embedded.mjs",
+    "./adapters/kit": "./dist/adapters/kit.mjs",
+    "./adapters/spa": "./dist/adapters/spa.mjs",
+    "./adapters/vite": "./dist/adapters/vite.mjs",
+    "./client": "./dist/client/index.mjs",
     "./constants": "./dist/constants.mjs",
-    "./embedded": "./dist/embedded.mjs",
-    "./kit": "./dist/kit.mjs",
     "./node": "./dist/node/index.mjs",
     "./rpc": "./dist/rpc/index.mjs",
     "./rpc/client": "./dist/rpc/client.mjs",
     "./rpc/server": "./dist/rpc/server.mjs",
     "./rpc/transports/ws-client": "./dist/rpc/transports/ws-client.mjs",
     "./rpc/transports/ws-server": "./dist/rpc/transports/ws-server.mjs",
-    "./spa": "./dist/spa.mjs",
     "./types": "./dist/types/index.mjs",
     "./utils/events": "./dist/utils/events.mjs",
     "./utils/human-id": "./dist/utils/human-id.mjs",
@@ -41,7 +42,6 @@
     "./utils/shared-state": "./dist/utils/shared-state.mjs",
     "./utils/state": "./dist/utils/state.mjs",
     "./utils/when": "./dist/utils/when.mjs",
-    "./vite": "./dist/vite.mjs",
     "./package.json": "./package.json"
   },
   "types": "./dist/index.d.ts",
@@ -72,21 +72,13 @@
     "tsdown": "catalog:build"
   },
   "inlinedDependencies": {
-    "@jridgewell/trace-mapping": "0.3.31",
-    "@oxc-project/types": "0.126.0",
-    "@rolldown/pluginutils": "1.0.0-rc.16",
     "acorn": "8.16.0",
-    "esbuild": "0.28.0",
     "human-id": "4.1.3",
     "immer": "11.1.4",
     "mlly": "1.8.2",
     "obug": "2.1.1",
     "perfect-debounce": "2.1.0",
-    "postcss": "8.5.10",
-    "rolldown": "1.0.0-rc.16",
-    "terser": "5.44.1",
     "tinyexec": "1.1.1",
-    "ua-parser-modern": "0.1.1",
-    "vite": "8.0.9"
+    "ua-parser-modern": "0.1.1"
   }
 }

packages/devframe/src/build.ts packages/devframe/src/adapters/build.tspackages/devframe/src/build.ts renamed to packages/devframe/src/adapters/build.ts

@@ -1,5 +1,5 @@
 /* eslint-disable no-console */
-import type { DevtoolDefinition } from './types/devtool'
+import type { DevtoolDefinition } from '../types/devtool'
 import { existsSync } from 'node:fs'
 import fs from 'node:fs/promises'
 import process from 'node:process'
@@ -10,10 +10,10 @@ import {
   DEVTOOLS_DIRNAME,
   DEVTOOLS_RPC_DUMP_DIRNAME,
   DEVTOOLS_RPC_DUMP_MANIFEST_FILENAME,
-} from './constants'
-import { createHostContext } from './node/context'
-import { createH3DevToolsHost } from './node/host-h3'
-import { collectStaticRpcDump } from './node/static-dump'
+} from '../constants'
+import { createHostContext } from '../node/context'
+import { createH3DevToolsHost } from '../node/host-h3'
+import { collectStaticRpcDump } from '../node/static-dump'
 
 export interface BuildStaticOptions {
   outDir: string

packages/devframe/src/cli.ts packages/devframe/src/adapters/cli.tspackages/devframe/src/cli.ts renamed to packages/devframe/src/adapters/cli.ts

@@ -1,16 +1,16 @@
-import type { DevtoolDefinition } from './types/devtool'
+import type { DevtoolDefinition } from '../types/devtool'
 import process from 'node:process'
 import c from 'ansis'
 import cac from 'cac'
 import { getPort } from 'get-port-please'
 import { createApp } from 'h3'
 import { resolve } from 'pathe'
 import sirv from 'sirv'
+import { DEVTOOLS_MOUNT_PATH } from '../constants'
+import { createHostContext } from '../node/context'
+import { createH3DevToolsHost } from '../node/host-h3'
+import { startHttpAndWs } from '../node/server'
 import { buildStatic } from './build'
-import { DEVTOOLS_MOUNT_PATH } from './constants'
-import { createHostContext } from './node/context'
-import { createH3DevToolsHost } from './node/host-h3'
-import { startHttpAndWs } from './node/server'
 import { buildSpa } from './spa'
 
 export interface CreateCliOptions {

packages/devframe/src/embedded.ts …ckages/devframe/src/adapters/embedded.tspackages/devframe/src/embedded.ts renamed to packages/devframe/src/adapters/embedded.ts packages/devframe/src/embedded.ts renamed to packages/devframe/src/adapters/embedded.ts

@@ -1,5 +1,5 @@
-import type { DevToolsNodeContext } from './types/context'
-import type { DevtoolDefinition } from './types/devtool'
+import type { DevToolsNodeContext } from '../types/context'
+import type { DevtoolDefinition } from '../types/devtool'
 
 /**
  * Register a devtool into an already-running devframe/Kit context at

packages/devframe/src/kit.ts packages/devframe/src/adapters/kit.tspackages/devframe/src/kit.ts renamed to packages/devframe/src/adapters/kit.ts

@@ -1,4 +1,4 @@
-import type { DevtoolDefinition } from './types/devtool'
+import type { DevtoolDefinition } from '../types/devtool'
 
 export interface KitPlugin {
   name: string

packages/devframe/src/spa.ts packages/devframe/src/adapters/spa.tspackages/devframe/src/spa.ts renamed to packages/devframe/src/adapters/spa.ts

@@ -1,5 +1,5 @@
 /* eslint-disable no-console */
-import type { DevtoolDefinition } from './types/devtool'
+import type { DevtoolDefinition } from '../types/devtool'
 import fs from 'node:fs/promises'
 import c from 'ansis'
 import { resolve } from 'pathe'

packages/devframe/src/vite.ts packages/devframe/src/adapters/vite.tspackages/devframe/src/vite.ts renamed to packages/devframe/src/adapters/vite.ts

@@ -1,4 +1,4 @@
-import type { DevtoolDefinition } from './types/devtool'
+import type { DevtoolDefinition } from '../types/devtool'
 import { resolve } from 'pathe'
 import sirv from 'sirv'