feat: data-inspector plugin, cross-plugin services, storage scopes

Promotes the data-inspector spike to a real plugin and lands the two core
primitives it design-required:

devframe core:
- ctx.services — typed, namespaced cross-plugin service registry
  (provide/get/whenAvailable, augmentable DevframeServicesRegistry,
  DF0037 on duplicate providers); whenAvailable absorbs setup-order
  differences between provider and consumer
- getStorageDir scopes become workspace/project/global: workspace is the
  committable .devframe/ dir (team-shared), project is the per-checkout
  node_modules dir (the old 'workspace'), global stays per-user; all
  hosts and call sites migrated (settings and dock prefs now persist
  under 'project')

@devframes/plugin-data-inspector:
- process-global source registry (globalThis Symbol store): sources are
  { id, title, description?, icon?, data: value | (async) factory,
  static?, queries? }; registerDataSource() needs no context, the same
  store is provided as the 'devframes:plugin:data-inspector:sources'
  context service, and changes broadcast to connected UIs
- isomorphic engine (normalize/skeleton/jora bridges) — the Map/Set
  methods duck-type live collections AND their normalized tags, so
  saved queries stay portable between live and static modes
- Vue + @antfu/design SPA with discovery's CodeMirror jora editor
  (remote stat-mode suggestions), struct viewer with type badges,
  shape panel, filters, per-source drafts, URL state, saved queries
  (workspace/project scopes via the new storage classes)
- standalone CLI: inspect .json/.jsonl files, attach to a process
  running the in-process agent (loopback + pre-shared-token auth by
  default, discovery file handshake), and build self-contained static
  exports that run the engine client-side
- unit tests for registry/engine/saved-queries/file loaders; core
  services tests; API snapshots updated

The prototype example is replaced by the plugin; the minimal Vite hub
dogfoods it with the live ViteDevServer registered as a source.

Author: antfubot

alias.ts

@@ -62,9 +62,18 @@ export const alias = {
   '@devframes/plugin-terminals/vite': p('terminals/src/vite.ts'),
   '@devframes/plugin-terminals': p('terminals/src/index.ts'),
   '@devframes/plugin-git': p('git/src/index.ts'),
+  'devframe/recipes/interactive-auth': r('devframe/src/recipes/interactive-auth.ts'),
   'devframe/recipes/open-helpers': r('devframe/src/recipes/open-helpers.ts'),
   'devframe/client': r('devframe/src/client/index.ts'),
   'devframe': r('devframe/src'),
+  '@devframes/plugin-data-inspector/client': p('data-inspector/src/client/index.ts'),
+  '@devframes/plugin-data-inspector/node': p('data-inspector/src/node/index.ts'),
+  '@devframes/plugin-data-inspector/registry': p('data-inspector/src/registry/index.ts'),
+  '@devframes/plugin-data-inspector/engine': p('data-inspector/src/engine/index.ts'),
+  '@devframes/plugin-data-inspector/agent': p('data-inspector/src/agent/index.ts'),
+  '@devframes/plugin-data-inspector/cli': p('data-inspector/src/cli.ts'),
+  '@devframes/plugin-data-inspector/vite': p('data-inspector/src/vite.ts'),
+  '@devframes/plugin-data-inspector': p('data-inspector/src/index.ts'),
   '@devframes/plugin-inspect/client': p('inspect/src/client/index.ts'),
   '@devframes/plugin-inspect/node': p('inspect/src/node/index.ts'),
   '@devframes/plugin-inspect/cli': p('inspect/src/cli.ts'),

docs/errors/DF0037.md

@@ -0,0 +1,36 @@
+---
+outline: deep
+---
+
+# DF0037: Duplicate Service Provider
+
+## Message
+
+> A service is already provided under "`{id}`".
+
+## Cause
+
+`ctx.services` holds exactly one provider per service id. A second `provide()` under the same id throws instead of silently replacing a service another integration may already hold a reference to.
+
+## Example
+
+```ts
+// ✗ Bad — provided twice
+ctx.services.provide('my-plugin:sources', hostA)
+ctx.services.provide('my-plugin:sources', hostB)
+
+// ✓ Good — revoke the previous provider first
+const revoke = ctx.services.provide('my-plugin:sources', hostA)
+revoke()
+ctx.services.provide('my-plugin:sources', hostB)
+```
+
+## Fix
+
+- Revoke the existing provider first — `provide()` returns a revoke function.
+- If the collision is between two unrelated integrations, namespace the id with your plugin id (`<plugin-id>:<service>`), the same rule RPC function names follow.
+- Guard idempotent setup paths with `ctx.services.has(id)`.
+
+## Source
+
+- [`packages/devframe/src/node/host-services.ts`](https://github.com/devframes/devframe/blob/main/packages/devframe/src/node/host-services.ts) — `provide()` throws this when the id is already taken.

docs/guide/devframe-definition.md

@@ -112,11 +112,37 @@ interface DevframeNodeContext {
   views: DevframeViewHost // static file hosting (`hostStatic`)
   diagnostics: DevframeDiagnosticsHost
   agent: DevframeAgentHost // experimental
+  services: DevframeServicesHost // typed cross-plugin service registry
 
   scope: (id) => DevframeScopedNodeContext // namespaced view (preferred)
 }
 ```
 
+### Cross-plugin services
+
+`ctx.services` is a typed, namespaced registry through which one integration exposes a capability and others consume it without a hard package dependency. The provider augments the `DevframeServicesRegistry` interface (so consumers get full typing from a types-only import) and provides the implementation at setup time; consumers use `whenAvailable`, which absorbs setup-order differences:
+
+```ts
+// provider
+declare module 'devframe' {
+  interface DevframeServicesRegistry {
+    'my-plugin:sources': SourcesService
+  }
+}
+ctx.services.provide('my-plugin:sources', sources)
+
+// consumer — types come from `import type`, no runtime dependency
+ctx.services.whenAvailable('my-plugin:sources', (sources) => {
+  sources.register(/* ... */)
+})
+```
+
+Service ids follow the RPC naming rule: prefix with the providing plugin's id. Duplicate ids throw [`DF0037`](https://devfra.me/errors/DF0037).
+
+### Storage scopes
+
+`ctx.host.getStorageDir(scope)` places persisted state in one of three classes: `'workspace'` (committable, shared with the team — conventionally `<workspaceRoot>/.devframe/`), `'project'` (per-checkout private, under `node_modules`), and `'global'` (per-user, under the home directory).
+
 `ctx.scope(id)` returns a namespace-scoped view that auto-prefixes every RPC id, shared-state key, and streaming channel and adds a persisted top-level `settings` store. It's the recommended entry point from a single tool's setup code — see [Scoped Context](./scoped-context).
 
 Host adapters can augment `ctx` with additional surfaces. For example, the [`vite` adapter](/adapters/vite) exposes Vite DevTools' dock, command, message, and terminal hosts via an optional `setup` hook on `createPluginFromDevframe` — consult the host's docs for those extras.

examples/minimal-next-devframe-hub/src/client/devframe/minimal-next-devframe-hub.ts

@@ -177,9 +177,11 @@ export async function minimalNextDevframeHub(
       return `http://${hostName}:3000`
     },
     getStorageDir(scope) {
-      return scope === 'workspace'
-        ? join(cwd, 'node_modules/.minimal-next-devframe-hub')
-        : join(homedir(), '.minimal-next-devframe-hub')
+      if (scope === 'workspace')
+        return join(cwd, '.devframe')
+      if (scope === 'project')
+        return join(cwd, 'node_modules/.minimal-next-devframe-hub')
+      return join(homedir(), '.minimal-next-devframe-hub')
     },
   }
 

examples/minimal-vite-devframe-hub/package.json

@@ -15,6 +15,7 @@
     "@devframes/hub": "workspace:*",
     "@devframes/plugin-a11y": "workspace:*",
     "@devframes/plugin-code-server": "workspace:*",
+    "@devframes/plugin-data-inspector": "workspace:*",
     "@devframes/plugin-git": "workspace:*",
     "@devframes/plugin-inspect": "workspace:*",
     "@devframes/plugin-messages": "workspace:*",

examples/minimal-vite-devframe-hub/src/minimal-vite-devframe-hub.ts

@@ -115,9 +115,11 @@ export function minimalViteDevframeHub(options: MinimalViteDevframeHubOptions =
           return resolved ? new URL(resolved).origin : 'http://localhost:5173'
         },
         getStorageDir(scope) {
-          return scope === 'workspace'
-            ? join(cwd, 'node_modules/.minimal-vite-devframe-hub')
-            : join(homedir(), '.minimal-vite-devframe-hub')
+          if (scope === 'workspace')
+            return join(cwd, '.devframe')
+          if (scope === 'project')
+            return join(cwd, 'node_modules/.minimal-vite-devframe-hub')
+          return join(homedir(), '.minimal-vite-devframe-hub')
         },
       }
 

examples/minimal-vite-devframe-hub/vite.config.ts

@@ -1,5 +1,7 @@
 import a11yDevframe, { a11yAgentBundlePath } from '@devframes/plugin-a11y'
 import codeServerDevframe from '@devframes/plugin-code-server'
+import dataInspectorDevframe from '@devframes/plugin-data-inspector'
+import { registerDataSource } from '@devframes/plugin-data-inspector/registry'
 import gitDevframe from '@devframes/plugin-git'
 import inspectDevframe from '@devframes/plugin-inspect'
 import messagesDevframe from '@devframes/plugin-messages'
@@ -18,6 +20,34 @@ export default defineConfig({
   server: { allowedHosts: true, strictPort: false },
   plugins: [
     UnoCSS(),
+    {
+      // The host registers its own live objects as data-inspector sources —
+      // the registry is process-global, so this works from any plugin hook.
+      name: 'minimal-vite-devframe-hub:data-sources',
+      configureServer(server) {
+        registerDataSource({
+          id: 'vite:server',
+          title: 'Vite Dev Server',
+          description: 'The live ViteDevServer instance serving this hub.',
+          icon: 'i-ph:lightning-duotone',
+          data: () => server,
+          queries: [
+            { title: 'Plugin names', query: 'config.plugins.name' },
+            {
+              title: 'Module graph',
+              description: 'Client-environment modules with their importers',
+              query: 'environments.client.moduleGraph.idToModuleMap.mapEntries().value.({ url, type, importers: importers.fromSet().url })',
+            },
+            {
+              title: 'Resolved config (clean)',
+              query: 'config',
+              excludeFunctions: true,
+              excludeUnderscoreProps: true,
+            },
+          ],
+        })
+      },
+    },
     minimalViteDevframeHub({
       devframes: [
         demoDevframe,
@@ -28,6 +58,7 @@ export default defineConfig({
         terminalsDevframe,
         codeServerDevframe,
         inspectDevframe,
+        dataInspectorDevframe,
         a11yDevframe,
         messagesDevframe,
       ],