AGENTS.md@packages/dashboard-plugin-runtime git:20260928.b6ef839A

Immutable. This exact content never changes and is served at /api/v1/blob/a2431631e66ebe3c.

# DOX — packages/dashboard-plugin-runtime

Files in this directory. One row per source file.

| File | Purpose |
|------|---------|
| `README.md` | Package overview. Plugin loader, slot registry, slot consumers, plugin context API, Vite plugin. Public import paths: barrel, `/context` (client hooks), `/server` (loader, `ServerPluginContext`, config validator), `/vite-plugin` (`viteDashboardPluginsPlugin`). Plugins import ONLY these paths; internal-package imports banned (lint fails). Manifest = `pi-dashboard-plugin` field in `package.json`. Documents settings-section placement (`tab` inert) + `nav` hint (fields, limits, drop-with-warning, `models` allowlist, first-party scope, reserved labels). See change: promote-model-roles-settings. |
| `vitest.config.ts` | Vitest config for runtime package. jsdom env, forks pool, `src/**/__tests__` include, `globalSetup` from shared test-support. Aliases `@blackbelt-technology/pi-dashboard-shared` to `../shared/src` so worktree-local shared source wins over hoisted symlink. See change: add-blackhole-session-pipeline (runtime alias pattern reused by server/client/blackhole vitest configs for `dashboard-plugin-runtime`). |