feat(data-inspector): auto-expose globalThis on the --import path

The zero-code `--import` agent has nowhere to call registerDataSource, so it now
auto-registers a `globalThis` source (createGlobalThisDataSource) — assigning to
the global object is enough to inspect anything. Opt out with
DEVFRAME_DATA_INSPECTOR_GLOBAL=0. Docs updated with the workflow.

Author: antfubot

docs/plugins/data-inspector.md

@@ -129,6 +129,16 @@ Or with zero code changes:
 DEVFRAME_DATA_INSPECTOR=1 node --import @devframes/plugin-data-inspector/inject server.js
 ```
 
+On this zero-code path there is nowhere to call `registerDataSource`, so the agent auto-registers a **`globalThis`** source. Assign anything you want to inspect onto the global object and query it live:
+
+```ts
+// somewhere in the running process
+globalThis.store = store
+globalThis.cache = cache
+```
+
+Then query `store`, `cache`, or `keys($)` to see what's there. The source reads `globalThis` at query time, so assignments made after the agent started show up on the next run. Opt out with `DEVFRAME_DATA_INSPECTOR_GLOBAL=0`.
+
 The agent binds `127.0.0.1`, requires devframe's trust handshake with a per-run pre-shared token, and advertises its endpoint in `node_modules/.data-inspector/agent.json` — `devframe-data-inspector attach` consumes it automatically (or pass `ws://…` and `--token` explicitly). Queries execute inside the target process, where the live objects are. Treat the endpoint like a debugger port.
 
 ## RPC surface

plugins/data-inspector/README.md

@@ -62,6 +62,8 @@ or with zero code changes:
 DEVFRAME_DATA_INSPECTOR=1 node --import @devframes/plugin-data-inspector/inject server.js
 ```
 
+On the zero-code path there's nowhere to call `registerDataSource`, so the agent auto-registers a **`globalThis`** source: assign what you want to inspect onto the global object (`globalThis.store = store`) and query it live. Opt out with `DEVFRAME_DATA_INSPECTOR_GLOBAL=0`.
+
 The agent binds `127.0.0.1`, requires devframe's trust handshake with a per-run token by default, and advertises its endpoint in `node_modules/.data-inspector/agent.json`, which `devframe-data-inspector attach` picks up automatically.
 
 > [!WARNING]

plugins/data-inspector/src/inject/index.ts

@@ -23,6 +23,11 @@
  * DEVFRAME_DATA_INSPECTOR=1 node --import @devframes/plugin-data-inspector/inject server.js
  * ```
  *
+ * On that zero-code path there's nowhere to call `registerDataSource`, so the
+ * agent auto-registers a **`globalThis`** source: assign anything you want to
+ * inspect onto the global object (`globalThis.store = store`) and query it
+ * live. Opt out with `DEVFRAME_DATA_INSPECTOR_GLOBAL=0`.
+ *
  * It binds `127.0.0.1` and requires devframe's trust handshake by
  * default: a random pre-shared token is minted per run, printed to stderr,
  * and written (with the endpoint) to the discovery file
@@ -91,6 +96,24 @@ export interface DataInspectorAgent {
   close: () => Promise<void>
 }
 
+/**
+ * A data source exposing the inspected process's global object. On the
+ * zero-code `--import` path there is nowhere to call `registerDataSource`, so
+ * assigning to `globalThis` is how you surface things to inspect
+ * (`globalThis.store = store`); this source makes them queryable live. The
+ * factory reads `globalThis` at query time, so late assignments show up on the
+ * next run.
+ */
+export function createGlobalThisDataSource(): DataSourceEntry {
+  return {
+    id: 'globalThis',
+    title: 'globalThis',
+    description: 'The global object of the inspected process. Assign values to inspect them, e.g. globalThis.store = store',
+    icon: 'i-ph:globe-duotone',
+    data: () => globalThis,
+  }
+}
+
 /** Start the agent endpoint in the current process. */
 export async function exposeDataInspector(options: ExposeDataInspectorOptions = {}): Promise<DataInspectorAgent> {
   // Deferred so `--import`ing the agent never pulls the whole node surface
@@ -174,6 +197,9 @@ if (process.env.DEVFRAME_DATA_INSPECTOR === '1' || process.env.DEVFRAME_DATA_INS
     auth: process.env.DEVFRAME_DATA_INSPECTOR_AUTH !== '0',
     token: process.env.DEVFRAME_DATA_INSPECTOR_TOKEN,
     exampleSource: process.env.DEVFRAME_DATA_INSPECTOR_EXAMPLE !== '0',
+    // Zero-code path: with no chance to call `registerDataSource`, expose
+    // `globalThis` so assigning to it is enough to inspect anything.
+    sources: process.env.DEVFRAME_DATA_INSPECTOR_GLOBAL !== '0' ? [createGlobalThisDataSource()] : undefined,
   }).catch((error) => {
     console.error('[data-inspector] agent failed to start:', error)
   })

tests/__snapshots__/tsnapi/@devframes/plugin-data-inspector/inject.snapshot.d.ts

@@ -25,6 +25,7 @@ export interface ExposeDataInspectorOptions {
 // #endregion
 
 // #region Functions
+export declare function createGlobalThisDataSource(): DataSourceEntry;
 export declare function exposeDataInspector(_?: ExposeDataInspectorOptions): Promise<DataInspectorAgent>;
 // #endregion
 

tests/__snapshots__/tsnapi/@devframes/plugin-data-inspector/inject.snapshot.js

@@ -2,6 +2,7 @@
  * Generated by tsnapi — public API snapshot of `@devframes/plugin-data-inspector/inject`
  */
 // #region Functions
+export function createGlobalThisDataSource() {}
 export async function exposeDataInspector(_) {}
 // #endregion