docs: update plugin names, namespaces, and code-server launcher UI

Author: antfubot

todos/01-plugin-rpc-state-inspector.md todos/01-plugin-inspect.mdtodos/01-plugin-rpc-state-inspector.md renamed to todos/01-plugin-inspect.md

@@ -1,10 +1,10 @@
 # Plugin 01 — RPC & State self-inspector
 
-**Package:** `@devframes/plugin-rpc` · **Dir:** `plugins/rpc/`
+**Package:** `@devframes/plugin-inspect` · **Dir:** `plugins/inspect/`
 **Inspiration:** port of the RPC + shared-state inspector panels from
 `vitejs/devtools`.
 **SPA stack (Axis B):** Vue + Vite (direct port).
-**Diagnostics band:** `DF90xx`.
+**Diagnostics band:** `DP_INSPECT_00xx`.
 
 ## Why first
 
@@ -35,20 +35,20 @@ APIs every other plugin produces, so it is the fastest way to discover whether:
 - the agent surface (`ctx.agent`, the `BUILTIN_AGENT_RPC`) is browsable.
 
 Expected gaps: missing introspection getters (may need a built-in
-`rpc:list-functions` style meta RPC in core), dump fidelity for non-JSON values,
+`devframe:list-functions` style meta RPC in core), dump fidelity for non-JSON values,
 and how a devframe inspects a connection it is *also* part of.
 
 ## Host integrations (Axis A)
 
-- `.` — `createRpcInspectorDevframe()` factory + default `DevframeDefinition`.
-- `/cli` — `npx @devframes/plugin-rpc` opens the inspector against a target.
+- `.` — `createInspectDevframe()` factory + default `DevframeDefinition`.
+- `/cli` — `npx @devframes/plugin-inspect` opens the inspector against a target.
 - `/vite` — mount into a Vite host to inspect that host's devframe connection.
 - `/client` — Vue mount helpers + any dock `custom-render` modules.
 
 ## Package layout
 
 ```
-plugins/rpc/
+plugins/inspect/
   src/
     index.ts            # `.`   default DevframeDefinition + factory
     node/index.ts       # `/node` setup(ctx): register introspection RPCs + docks
@@ -58,29 +58,29 @@ plugins/rpc/
     rpc/
       index.ts          # serverFunctions tuple + DevframeRpcServerFunctions augment
       functions/
-        list-functions.ts   # rpc:list-functions  (query, snapshot)
-        invoke.ts            # rpc:invoke           (action) — gated to query fns
-        list-state-keys.ts   # rpc:list-state-keys  (query)
-        describe-agent.ts    # rpc:describe-agent   (query, snapshot)
+        list-functions.ts   # devframes-plugin-inspect:list-functions  (query, snapshot)
+        invoke.ts            # devframes-plugin-inspect:invoke           (action) — gated to query fns
+        list-state-keys.ts   # devframes-plugin-inspect:list-state-keys  (query)
+        describe-agent.ts    # devframes-plugin-inspect:describe-agent   (query, snapshot)
     spa/                # Vue + Vite UI
   bin.mjs
   test/
 ```
 
 ## Node side
 
-- RPC (namespaced `rpc:*`):
-  - `rpc:list-functions` — `query`, `snapshot: true`, `jsonSerializable: true`:
+- RPC (namespaced `devframes-plugin-inspect:*`):
+  - `devframes-plugin-inspect:list-functions` — `query`, `snapshot: true`, `jsonSerializable: true`:
     returns the registry with metadata. May need a core hook to read the registry;
     if absent, that is a tracked gap to add to `devframe` core.
-  - `rpc:invoke` — `action`: invoke a named `query` function with validated args;
+  - `devframes-plugin-inspect:invoke` — `action`: invoke a named `query` function with validated args;
     refuse `action`/mutating functions for safety.
-  - `rpc:list-state-keys` — enumerate shared-state keys + current snapshots.
-  - `rpc:describe-agent` — surface `ctx.agent` tools/resources.
-- Docks: a single `iframe` (or `custom-render`) dock `rpc:inspector` titled
+  - `devframes-plugin-inspect:list-state-keys` — enumerate shared-state keys + current snapshots.
+  - `devframes-plugin-inspect:describe-agent` — surface `ctx.agent` tools/resources.
+- Docks: a single `iframe` (or `custom-render`) dock `devframes-plugin-inspect:inspector` titled
   "RPC & State", icon e.g. `ph:plugs-duotone`.
 - Shared state observed (read-only): all keys; no new keys written except a small
-  `rpc:inspector:ui` for persisted panel UI prefs (serializable).
+  `devframes-plugin-inspect:inspector:ui` for persisted panel UI prefs (serializable).
 
 ## Client side
 
@@ -93,8 +93,8 @@ plugins/rpc/
 
 1. Scaffold package + tsdown three-config + alias/turbo/workspace wiring (this is
    the template all others copy).
-2. `rpc:list-functions` + Functions view (read-only).
-3. `rpc:invoke` for `query` functions + result rendering.
+2. `devframes-plugin-inspect:list-functions` + Functions view (read-only).
+3. `devframes-plugin-inspect:invoke` for `query` functions + result rendering.
 4. State view with live subscription + diff.
 5. Agent view; `static`/`spa` degradation; tsnapi snapshot + e2e.
 
@@ -106,5 +106,5 @@ plugins/rpc/
 - How much of the `vitejs/devtools` Vue code ports cleanly vs. needs a rewrite
   against devframe's client (`connectDevframe`, `rpc.sharedState`) rather than
   Vite DevTools' kit client.
-- Safety model for `rpc:invoke` (which function types are invokable; argument
+- Safety model for `devframes-plugin-inspect:invoke` (which function types are invokable; argument
   validation surface).

todos/02-plugin-terminals.md

@@ -4,7 +4,7 @@
 **Inspiration:** replace Vite DevTools' built-in terminal panel with a portable,
 hub-native one.
 **SPA stack (Axis B):** Vanilla TS + Vite (+ `@xterm/xterm`).
-**Diagnostics band:** `DF91xx`.
+**Diagnostics band:** `DP_TERMINALS_00xx`.
 
 ## What it does
 
@@ -54,11 +54,11 @@ plugins/terminals/
     rpc/
       index.ts
       functions/
-        spawn.ts        # terminals:spawn   (action) → ctx.terminals.startChildProcess
-        terminate.ts    # terminals:terminate (action)
-        restart.ts      # terminals:restart (action)
-        write.ts        # terminals:write   (action) — stdin, IF host gains support
-        list.ts         # terminals:list    (query)
+        spawn.ts        # devframes-plugin-terminals:spawn   (action) → ctx.terminals.startChildProcess
+        terminate.ts    # devframes-plugin-terminals:terminate (action)
+        restart.ts      # devframes-plugin-terminals:restart (action)
+        write.ts        # devframes-plugin-terminals:write   (action) — stdin, IF host gains support
+        list.ts         # devframes-plugin-terminals:list    (query)
     spa/
   bin.mjs
   test/
@@ -68,26 +68,26 @@ plugins/terminals/
 
 - Uses `ctx.terminals` directly; control RPCs are thin wrappers that call into the
   host and return session descriptors.
-- `terminals:spawn` validates the requested command against an allow-list passed
+- `devframes-plugin-terminals:spawn` validates the requested command against an allow-list passed
   to `createTerminalsDevframe` (security: never spawn arbitrary commands from the
-  client without opt-in). Diagnostics `DF91xx` for disallowed command / unknown
+  client without opt-in). Diagnostics `DP_TERMINALS_00xx` for disallowed command / unknown
   session / spawn failure.
 - Subscribes the UI to the `devframe:terminals` streaming channel and
   `devframe:terminals:updated` broadcast.
 
 ## Client side
 
 - Vanilla TS + xterm.js. One xterm instance per session, fed from the streaming
-  channel reader; tabs/list driven by `terminals:list` + the updated broadcast.
+  channel reader; tabs/list driven by `devframes-plugin-terminals:list` + the updated broadcast.
   Toolbar: spawn (from allow-list), terminate, restart, clear.
 
 ## Milestones
 
-1. Scaffold (copy from #1). Dock + `terminals:list` + render existing sessions'
+1. Scaffold (copy from #1). Dock + `devframes-plugin-terminals:list` + render existing sessions'
    buffered output.
 2. Live streaming via `devframe:terminals` channel into xterm; reconnect/replay.
-3. `terminals:spawn` / `terminate` / `restart` with allow-list.
-4. (If host extended) stdin `terminals:write` + resize/PTY.
+3. `devframes-plugin-terminals:spawn` / `terminate` / `restart` with allow-list.
+4. (If host extended) stdin `devframes-plugin-terminals:write` + resize/PTY.
 5. tsnapi snapshot + Playwright e2e (spawn → output → terminate).
 
 ## Open questions / risks

todos/03-plugin-git-dashboard.md

@@ -4,7 +4,7 @@
 **Inspiration:** GitLens — repository insight surfaced inline.
 **SPA stack (Axis B):** Vue + Vite (reuses inspector UI primitives), vanilla
 fallback acceptable.
-**Diagnostics band:** `DF92xx`.
+**Diagnostics band:** `DP_GIT_00xx`.
 
 ## What it does
 
@@ -25,7 +25,7 @@ watching + `json-render` + commands/docks**. Stresses:
   and the debounce behavior `createHubContext` applies in `dev` mode;
 - `json-render` driven docks (`ctx.createJsonRenderer`) as an alternative to a
   full custom SPA for some panels;
-- command-palette entries (`git:checkout`, `git:fetch`) via `ctx.commands`.
+- command-palette entries (`devframes-plugin-git:checkout`, `devframes-plugin-git:fetch`) via `ctx.commands`.
 
 Expected gaps: efficient diffing of large repos over RPC, incremental updates vs.
 full snapshots, and error diagnostics for non-repo / detached-HEAD states.
@@ -51,14 +51,14 @@ plugins/git/
     rpc/
       index.ts
       functions/
-        status.ts           # git:status        (query, snapshot)
-        log.ts              # git:log            (query) — paginated
-        diff.ts             # git:diff           (query)
-        blame.ts            # git:blame          (query)
-        branches.ts         # git:branches       (query)
-        stage.ts            # git:stage          (action, write-gated)
-        commit.ts           # git:commit         (action, write-gated)
-        checkout.ts         # git:checkout       (action, write-gated)
+        status.ts           # devframes-plugin-git:status        (query, snapshot)
+        log.ts              # devframes-plugin-git:log            (query) — paginated
+        diff.ts             # devframes-plugin-git:diff           (query)
+        blame.ts            # devframes-plugin-git:blame          (query)
+        branches.ts         # devframes-plugin-git:branches       (query)
+        stage.ts            # devframes-plugin-git:stage          (action, write-gated)
+        commit.ts           # devframes-plugin-git:commit         (action, write-gated)
+        checkout.ts         # devframes-plugin-git:checkout       (action, write-gated)
     watcher.ts              # HEAD/index watcher → shared-state push
     spa/
   bin.mjs
@@ -70,10 +70,10 @@ plugins/git/
 - Git access via `simple-git` (or `isomorphic-git` for zero-binary portability —
   decide in milestone 0; add to the `deps` catalog). Run commands relative to
   `ctx.workspaceRoot` / `ctx.cwd`.
-- Watcher updates `git:state` shared state (branch, ahead/behind, dirty counts) on
+- Watcher updates `devframes-plugin-git:state` shared state (branch, ahead/behind, dirty counts) on
   `.git/HEAD` / index changes; debounced.
 - Write RPCs only registered when `createGitDevframe({ write: true })`; otherwise
-  omitted from the registry entirely (not just hidden). Diagnostics `DF92xx`:
+  omitted from the registry entirely (not just hidden). Diagnostics `DP_GIT_00xx`:
   not-a-repo, dirty-tree-conflict, write-disabled.
 
 ## Client side
@@ -83,10 +83,10 @@ plugins/git/
 
 ## Milestones
 
-1. Scaffold. `git:status` + Status view (read-only).
-2. `git:log` (paginated) + History; `git:diff` + Diff viewer.
-3. Live `git:state` watcher → shared state.
-4. `git:branches` + `git:blame`.
+1. Scaffold. `devframes-plugin-git:status` + Status view (read-only).
+2. `devframes-plugin-git:log` (paginated) + History; `devframes-plugin-git:diff` + Diff viewer.
+3. Live `devframes-plugin-git:state` watcher → shared state.
+4. `devframes-plugin-git:branches` + `devframes-plugin-git:blame`.
 5. Opt-in write actions + command-palette entries.
 6. tsnapi snapshot + e2e against a temp-repo fixture.
 

todos/04-plugin-og-viewer.md

@@ -4,7 +4,7 @@
 **Inspiration:** Nuxt DevTools' Open Graph image viewer.
 **SPA stack (Axis B):** Nuxt (static export) — the marquee proof that a Nuxt-built
 SPA is a drop-in devframe client.
-**Diagnostics band:** `DF93xx`.
+**Diagnostics band:** `DP_OG_00xx`.
 
 ## What it does
 
@@ -54,22 +54,22 @@ plugins/og/
     rpc/
       index.ts
       functions/
-        scan-routes.ts     # og:scan-routes   (query, snapshot)
-        resolve-meta.ts    # og:resolve-meta  (query) — fetch+parse a URL's head
-        render-image.ts    # og:render-image  (query) — bytes / data URL
+        scan-routes.ts     # devframes-plugin-og:scan-routes   (query, snapshot)
+        resolve-meta.ts    # devframes-plugin-og:resolve-meta  (query) — fetch+parse a URL's head
+        render-image.ts    # devframes-plugin-og:render-image  (query) — bytes / data URL
     spa/                   # Nuxt app, output: 'export', assetPrefix relative
   bin.mjs
   test/
 ```
 
 ## Node side
 
-- `og:resolve-meta` fetches a target URL (or reads built HTML) and parses
+- `devframes-plugin-og:resolve-meta` fetches a target URL (or reads built HTML) and parses
   `og:*` / `twitter:*` meta into a structured snapshot.
-- `og:render-image` optionally renders via `satori` + `resvg` (add to catalog) or
+- `devframes-plugin-og:render-image` optionally renders via `satori` + `resvg` (add to catalog) or
   defers to a project-provided generator hook.
 - Build mode: emit a static OG report so `createBuild` output can be deployed and
-  shared. Diagnostics `DF93xx`: unfetchable URL, parse failure, render failure.
+  shared. Diagnostics `DP_OG_00xx`: unfetchable URL, parse failure, render failure.
 
 ## Client side
 
@@ -81,9 +81,9 @@ plugins/og/
 
 1. Scaffold + Nuxt SPA build wired to `cli.distDir` (prove Nuxt static export
    mounts and connects).
-2. `og:resolve-meta` + meta table + card preview.
-3. `og:scan-routes` to populate the route picker.
-4. `og:render-image` (satori) or generator-hook path.
+2. `devframes-plugin-og:resolve-meta` + meta table + card preview.
+3. `devframes-plugin-og:scan-routes` to populate the route picker.
+4. `devframes-plugin-og:render-image` (satori) or generator-hook path.
 5. `build` adapter snapshot (deployable report) + `spa.loader: 'query'`.
 6. tsnapi snapshot + e2e.
 

todos/05-plugin-a11y-check.md

@@ -4,7 +4,7 @@
 **Inspiration:** axe-core powered accessibility auditing, surfaced as a devtool.
 **SPA stack (Axis B):** React via **rspack** — the proof that an rspack build
 produces a valid static devframe SPA.
-**Diagnostics band:** `DF94xx`.
+**Diagnostics band:** `DP_A11Y_00xx`.
 
 ## What it does
 
@@ -55,21 +55,21 @@ plugins/a11y/
     rpc/
       index.ts
       functions/
-        report.ts         # a11y:report        (action) — client posts results
-        scan-headless.ts  # a11y:scan-headless (action) — node+Playwright run
-        list-results.ts   # a11y:list-results  (query, snapshot)
+        report.ts         # devframes-plugin-a11y:report        (action) — client posts results
+        scan-headless.ts  # devframes-plugin-a11y:scan-headless (action) — node+Playwright run
+        list-results.ts   # devframes-plugin-a11y:list-results  (query, snapshot)
     spa/                  # React, built with rspack
   bin.mjs
   test/
 ```
 
 ## Node side
 
-- `a11y:report` receives results from the in-page `clientScript`, stores them in
-  `a11y:results` shared state, and fans violations into `ctx.messages` (one entry
-  per violation, deduped by rule+target). Diagnostics `DF94xx`: scan failure,
+- `devframes-plugin-a11y:report` receives results from the in-page `clientScript`, stores them in
+  `devframes-plugin-a11y:results` shared state, and fans violations into `ctx.messages` (one entry
+  per violation, deduped by rule+target). Diagnostics `DP_A11Y_00xx`: scan failure,
   Playwright unavailable, invalid rule config.
-- `a11y:scan-headless` runs axe via Playwright against a URL (node-side), for the
+- `devframes-plugin-a11y:scan-headless` runs axe via Playwright against a URL (node-side), for the
   CLI/CI path.
 
 ## Client side
@@ -83,10 +83,10 @@ plugins/a11y/
 
 1. Scaffold + rspack SPA build wired to `cli.distDir` (prove rspack static SPA
    mounts + connects).
-2. In-page `clientScript` scan → `a11y:report` → `a11y:results` shared state +
+2. In-page `clientScript` scan → `devframes-plugin-a11y:report` → `devframes-plugin-a11y:results` shared state +
    results dashboard.
 3. Violations → `ctx.messages` feed; node highlighting.
-4. `a11y:scan-headless` (Playwright) + CLI/CI report.
+4. `devframes-plugin-a11y:scan-headless` (Playwright) + CLI/CI report.
 5. `when`-clause-driven actions; tsnapi snapshot + e2e.
 
 ## Open questions / risks

todos/06-plugin-mcp-inspector.md todos/06-plugin-mcp-inspect.mdtodos/06-plugin-mcp-inspector.md renamed to todos/06-plugin-mcp-inspect.md

@@ -1,9 +1,9 @@
 # Plugin 06 — MCP inspector
 
-**Package:** `@devframes/plugin-mcp` · **Dir:** `plugins/mcp/`
+**Package:** `@devframes/plugin-mcp-inspect` · **Dir:** `plugins/mcp-inspect/`
 **Inspiration:** the MCP inspector; optional Vercel AI SDK / evals integration.
 **SPA stack (Axis B):** Next (static export) — React + the Vercel ecosystem.
-**Diagnostics band:** `DF95xx`.
+**Diagnostics band:** `DP_MCP_00xx`.
 
 ## What it does
 
@@ -40,15 +40,15 @@ core addition), and agent-surface metadata richness.
 ## Host integrations (Axis A)
 
 - `.` — `createMcpInspectorDevframe(options)` (target server config).
-- `/cli` — `npx @devframes/plugin-mcp` → connect to an MCP server from the terminal.
+- `/cli` — `npx @devframes/plugin-mcp-inspect` → connect to an MCP server from the terminal.
 - `/next` — first-class Next integration (the SPA is Next; host integration too).
 - `/vite` — generic Vite host mount.
 - `/client` — Next-built SPA + connect glue.
 
 ## Package layout
 
 ```
-plugins/mcp/
+plugins/mcp-inspect/
   src/
     index.ts
     node/index.ts
@@ -59,12 +59,12 @@ plugins/mcp/
     rpc/
       index.ts
       functions/
-        connect.ts        # mcp:connect        (action) — open a client to a server
-        list-tools.ts     # mcp:list-tools     (query, snapshot)
-        invoke-tool.ts    # mcp:invoke-tool    (action)
-        list-resources.ts # mcp:list-resources (query)
-        read-resource.ts  # mcp:read-resource  (query)
-        run-eval.ts       # mcp:run-eval       (action) — stretch, Vercel AI SDK
+        connect.ts        # devframes-plugin-mcp-inspect:connect        (action) — open a client to a server
+        list-tools.ts     # devframes-plugin-mcp-inspect:list-tools     (query, snapshot)
+        invoke-tool.ts    # devframes-plugin-mcp-inspect:invoke-tool    (action)
+        list-resources.ts # devframes-plugin-mcp-inspect:list-resources (query)
+        read-resource.ts  # devframes-plugin-mcp-inspect:read-resource  (query)
+        run-eval.ts       # devframes-plugin-mcp-inspect:run-eval       (action) — stretch, Vercel AI SDK
     spa/                  # Next, output: 'export', assetPrefix relative
   bin.mjs
   test/
@@ -73,10 +73,10 @@ plugins/mcp/
 ## Node side
 
 - MCP client via `@modelcontextprotocol/sdk` (already a catalog dep; optional peer
-  in core). Manage connections in `mcp:connections` shared state.
+  in core). Manage connections in `devframes-plugin-mcp-inspect:connections` shared state.
 - Optional: expose devframe's *own* MCP server via `createMcpServer` and let the
   inspector connect to it (self-inspection loop).
-- Diagnostics `DF95xx`: connect failure, unsupported transport, tool-invoke error,
+- Diagnostics `DP_MCP_00xx`: connect failure, unsupported transport, tool-invoke error,
   eval-provider missing.
 
 ## Client side
@@ -88,8 +88,8 @@ plugins/mcp/
 
 1. Scaffold + Next static-export SPA wired to `cli.distDir` (prove Next SPA mounts
    + connects).
-2. `mcp:connect` (stdio) + `mcp:list-tools` + Tools browser.
-3. `mcp:invoke-tool` (schema-driven form) + response viewer.
+2. `devframes-plugin-mcp-inspect:connect` (stdio) + `devframes-plugin-mcp-inspect:list-tools` + Tools browser.
+3. `devframes-plugin-mcp-inspect:invoke-tool` (schema-driven form) + response viewer.
 4. Resources/prompts browse + read.
 5. Point at devframe's own `createMcpServer` (self-inspection); request log.
 6. (Stretch) Vercel AI SDK evals tab.