@hachej/boring-ui-plugin-cli 0.1.31 → 0.1.33

package/dist/index.d.ts

@@ -1,4 +1,105 @@
+interface CreatePluginOptions {
+    name: string;
+    path?: string;
+    cwd?: string;
+}
+interface CreatePluginResult {
+    id: string;
+    pluginDir: string;
+    packageName: string;
+    filesCreated: string[];
+}
+declare function createPlugin(options: CreatePluginOptions): CreatePluginResult;
+
+interface ScaffoldPluginOptions {
+    /** Plugin id — must be kebab-case, used as folder name + npm package name. */
+    name: string;
+    /** Workspace root the .pi/extensions/<name>/ folder is created under. */
+    workspaceRoot: string;
+    /** Optional override for the canonical templates dir (test escape hatch). */
+    templatesDir?: string;
+}
+interface ScaffoldPluginResult {
+    pluginDir: string;
+    filesCreated: string[];
+}
+declare function scaffoldPlugin(opts: ScaffoldPluginOptions): ScaffoldPluginResult;
+
+interface VerifyPluginOptions {
+    /** Workspace root containing `.pi/extensions/`. */
+    workspaceRoot: string;
+    /** Optional plugin name to verify only one; otherwise verifies all. */
+    name?: string;
+}
+interface PluginVerifyOutcome {
+    id: string;
+    dir: string;
+    ok: boolean;
+    errors: string[];
+    /**
+     * Non-fatal informational messages — e.g. "this plugin declares
+     * boring.server, which is boot-time/static composition only and is
+     * not hot-registered by /reload". Does NOT flip `ok` to false;
+     * boring-ui-plugin verify is about manifest validity, not activation.
+     */
+    warnings: string[];
+}
+interface VerifyPluginResult {
+    outcomes: PluginVerifyOutcome[];
+    ok: boolean;
+    /** Absolute path of the `.pi/extensions/` dir that was scanned. */
+    extensionsDir: string;
+    /** True when `.pi/extensions/` doesn't exist at all under the workspace. */
+    extensionsDirMissing: boolean;
+}
+/**
+ * Verify boring-ui plugins on disk WITHOUT a running workspace server.
+ * Runs the same manifest validator the asset manager runs, plus file-
+ * existence checks for `boring.front` / `boring.server` / `pi.extensions`
+ * paths. Designed to catch the common authoring mistakes (invalid
+ * `boring.server` value, missing front file, malformed manifest, etc.)
+ * in the same agent turn that wrote the files.
+ *
+ * Does NOT execute plugin code (no jiti, no Vite). Syntax errors in
+ * front/Pi modules only surface when the workspace's real /reload runs;
+ * declared `boring.server` files require static composition plus a
+ * process restart to execute.
+ */
+declare function verifyPlugin(opts: VerifyPluginOptions): VerifyPluginResult;
+declare function formatVerifyResult(result: VerifyPluginResult): string;
+declare function findHintForError(message: string): string | undefined;
+
+type PaneSelfTestState = "ready" | "loading" | "error" | "missing" | "timeout" | "no-browser-connected";
+interface SelfTestEvent {
+    code: string;
+    message: string;
+}
+interface SelfTestResult {
+    ok: boolean;
+    workspaceId?: string;
+    pluginId: string;
+    revision?: number;
+    reloadErrors: SelfTestEvent[];
+    pane: {
+        found: boolean;
+        state: PaneSelfTestState;
+        panelId: string;
+        panelInstanceId: string;
+        error?: SelfTestEvent;
+        lastReportedAt?: string;
+    };
+}
+interface RunPluginSelfTestOptions {
+    pluginId: string;
+    url?: string;
+    workspaceId?: string;
+    panelId?: string;
+    timeoutMs?: number;
+}
+declare function runPluginSelfTest(options: RunPluginSelfTestOptions): Promise<SelfTestResult>;
+declare function formatSelfTestResult(result: SelfTestResult): string;
+
 declare function pluginCommandUsage(): string;
-declare function runBoringUiPluginCli(argv?: string[]): void;
+declare function runBoringUiPluginCli(argv?: string[]): Promise<void>;
 
-export { pluginCommandUsage, runBoringUiPluginCli };
+export { type CreatePluginOptions, type CreatePluginResult, type PaneSelfTestState, type PluginVerifyOutcome, type RunPluginSelfTestOptions, type ScaffoldPluginOptions, type ScaffoldPluginResult, type SelfTestEvent, type SelfTestResult, type VerifyPluginResult, createPlugin, findHintForError, formatSelfTestResult, formatVerifyResult, pluginCommandUsage, runBoringUiPluginCli, runPluginSelfTest, scaffoldPlugin, verifyPlugin };

package/dist/index.js

@@ -1,8 +1,22 @@
 import {
+  createPlugin,
+  findHintForError,
+  formatSelfTestResult,
+  formatVerifyResult,
   pluginCommandUsage,
-  runBoringUiPluginCli
-} from "./chunk-MNNNQ7Y7.js";
+  runBoringUiPluginCli,
+  runPluginSelfTest,
+  scaffoldPlugin,
+  verifyPlugin
+} from "./chunk-DH4PSVGY.js";
 export {
+  createPlugin,
+  findHintForError,
+  formatSelfTestResult,
+  formatVerifyResult,
   pluginCommandUsage,
-  runBoringUiPluginCli
+  runBoringUiPluginCli,
+  runPluginSelfTest,
+  scaffoldPlugin,
+  verifyPlugin
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hachej/boring-ui-plugin-cli",
-  "version": "0.1.31",
+  "version": "0.1.33",
   "description": "Slim boring-ui plugin authoring CLI for workspace runtimes.",
   "license": "MIT",
   "type": "module",
@@ -18,11 +18,6 @@
     },
     "./package.json": "./package.json"
   },
-  "scripts": {
-    "build": "tsup",
-    "typecheck": "tsc --noEmit",
-    "test": "pnpm run build && vitest run"
-  },
   "devDependencies": {
     "@types/node": "^22.15.3",
     "tsup": "^8.4.0",
@@ -33,5 +28,10 @@
     "type": "git",
     "url": "git+https://github.com/hachej/boring-ui.git"
   },
-  "homepage": "https://github.com/hachej/boring-ui"
-}
+  "homepage": "https://github.com/hachej/boring-ui",
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "pnpm run build && vitest run"
+  }
+}

package/templates/front-canonical.tsx

@@ -1,34 +1,150 @@
-// CANONICAL front/index.tsx for a boring-ui plugin.
+// CANONICAL front/index.tsx for a boring-ui runtime plugin.
 // Copy this shape — replace <kebab-name> and <Label>.
 //
-// definePlugin takes a single DECLARATIVE config object. For
-// conditional registration or runtime branching that the declarative
-// fields can't express, use the optional `setup: (api) => void`
-// escape hatch — it runs LAST, after every declarative field has
-// been registered.
+// Structure rule:
+// - Commands open full-size center panes for detailed work.
+// - Left tabs are compact, persistent sidebar/navigator panes.
+// - If a plugin has both, do NOT render the same component in both places.
+//   Register a small LeftPane and a separate MainPane.
 
 import React from "react"
-import { definePlugin } from "@hachej/boring-workspace/plugin"
+import { definePlugin, type PaneProps } from "@hachej/boring-workspace/plugin"
+import {
+  Badge,
+  Button,
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+  EmptyState,
+  Toolbar,
+  ToolbarGroup,
+} from "@hachej/boring-ui-kit"
 
-function MyPane() {
-  return <div style={{ padding: 16 }}>Hello from &lt;kebab-name&gt;</div>
+const MAIN_PANEL_ID = "<kebab-name>.panel"
+const LEFT_PANEL_ID = "<kebab-name>.left"
+
+function MainPane() {
+  return (
+    <div className="flex h-full min-h-0 min-w-0 flex-col bg-background text-foreground">
+      <Toolbar className="border-b border-border px-3 py-2">
+        <ToolbarGroup>
+          <Badge variant="secondary">Runtime plugin</Badge>
+          <Badge variant="outline"><Label></Badge>
+        </ToolbarGroup>
+        <ToolbarGroup className="ml-auto">
+          <Button size="sm" variant="secondary">Refresh</Button>
+        </ToolbarGroup>
+      </Toolbar>
+
+      <div className="min-h-0 min-w-0 flex-1 overflow-auto p-4">
+        <div className="grid min-w-0 gap-4 lg:grid-cols-[minmax(0,1fr)_280px]">
+          <Card className="min-w-0">
+            <CardHeader>
+              <CardTitle><Label></CardTitle>
+              <CardDescription>
+                This is the full center pane. Put detailed views, tables, charts,
+                editors, previews, and multi-step workflows here.
+              </CardDescription>
+            </CardHeader>
+            <CardContent>
+              <EmptyState
+                title="Nothing to show yet"
+                description="Connect data, register a surface resolver, or add actions for this plugin."
+                actions={<Button size="sm">Primary action</Button>}
+              />
+            </CardContent>
+          </Card>
+
+          <Card className="min-w-0">
+            <CardHeader>
+              <CardTitle className="text-sm">Details</CardTitle>
+              <CardDescription>Use side cards for metadata or secondary controls.</CardDescription>
+            </CardHeader>
+            <CardContent>
+              <div className="space-y-2 text-sm text-muted-foreground">
+                <div className="flex items-center justify-between gap-3">
+                  <span>Status</span>
+                  <Badge variant="outline">Ready</Badge>
+                </div>
+                <div className="flex items-center justify-between gap-3">
+                  <span>Items</span>
+                  <span>0</span>
+                </div>
+              </div>
+            </CardContent>
+          </Card>
+        </div>
+      </div>
+    </div>
+  )
+}
+
+function LeftPane({ containerApi }: PaneProps) {
+  const openMainPane = () => {
+    containerApi.addPanel({
+      id: `${MAIN_PANEL_ID}.from-left`,
+      component: MAIN_PANEL_ID,
+      title: "<Label>",
+      params: { source: "left-tab" },
+    })
+  }
+
+  return (
+    <div className="flex h-full min-h-0 min-w-0 flex-col bg-background text-foreground">
+      <div className="border-b border-border/60 px-3 py-2">
+        <div className="text-sm font-medium"><Label></div>
+        <div className="text-xs text-muted-foreground">Compact sidebar navigator</div>
+      </div>
+
+      <div className="min-h-0 min-w-0 flex-1 overflow-auto p-3">
+        <div className="space-y-3">
+          <Card className="min-w-0">
+            <CardHeader className="space-y-1 p-3">
+              <CardTitle className="text-sm">Overview</CardTitle>
+              <CardDescription className="text-xs">
+                Keep left tabs small: summary, filters, navigation, and actions.
+              </CardDescription>
+            </CardHeader>
+            <CardContent className="p-3 pt-0">
+              <Button size="sm" className="w-full" onClick={openMainPane}>
+                Open main pane
+              </Button>
+            </CardContent>
+          </Card>
+
+          <div className="space-y-1 text-xs text-muted-foreground">
+            <div className="rounded-md border border-border bg-card px-2 py-1.5">Recent item</div>
+            <div className="rounded-md border border-border bg-card px-2 py-1.5">Saved filter</div>
+          </div>
+        </div>
+      </div>
+    </div>
+  )
 }
 
 export default definePlugin({
   id: "<kebab-name>",              // contribution namespace; matching package name is recommended
   label: "<Label>",
   panels: [
-    { id: "<kebab-name>.panel", label: "<Label>", component: MyPane },
+    { id: MAIN_PANEL_ID, label: "<Label>", component: MainPane },
+    // Optional left-tab component. Register separately from the main panel so
+    // the sidebar does not duplicate a full workbench view.
+    { id: LEFT_PANEL_ID, label: "<Label>", component: LeftPane },
   ],
   commands: [
-    { id: "<kebab-name>.open", title: "Open <Label>", panelId: "<kebab-name>.panel" },
+    { id: "<kebab-name>.open", title: "Open <Label>", panelId: MAIN_PANEL_ID },
   ],
-  // Do not add leftTabs by default: left tabs are persistent sidebar
-  // navigation. Use them only for always-on tools/catalogs that deserve a
-  // permanent sidebar entry; file visualizers should use surfaceResolvers.
+  // Do not add leftTabs just because a plugin has a panel. A left tab is a
+  // permanent sidebar category. Keep it compact, and use its buttons/rows to
+  // open the full center panel via containerApi.addPanel(...).
+  //
+  // If this plugin should have persistent sidebar navigation, uncomment this:
   // leftTabs: [
-  //   { id: "<kebab-name>.tab", title: "<Label>", panelId: "<kebab-name>.panel" },
+  //   { id: "<kebab-name>.tab", title: "<Label>", panelId: LEFT_PANEL_ID },
   // ],
+  //
   // File visualizer example: import WORKSPACE_OPEN_PATH_SURFACE_KIND from
   // "@hachej/boring-workspace/plugin", import useApiBaseUrl/useWorkspaceRequestId
   // from "@hachej/boring-workspace", set kind: WORKSPACE_OPEN_PATH_SURFACE_KIND,
@@ -43,6 +159,10 @@ export default definePlugin({
   // setup: (api) => { if (env.beta) api.registerPanel(betaPanel) },
 })
 
+// Responsive pane rule: panels and left tabs live inside resizable dock regions.
+// Avoid fixed large widths; prefer w-full/min-w-0 layouts and responsive chart
+// wrappers such as Recharts ResponsiveContainer.
+//
 // All available `definePlugin` config fields:
 //   id            (required, string)
 //   label         (optional, string)

package/templates/plugin/README.md

@@ -0,0 +1,56 @@
+# Plugin template
+
+Reference shape for **app/internal publishable npm-package plugins**.
+The plugin CLI copies this directory when you run:
+
+```sh
+boring-ui-plugin create <your-name> --path plugins
+cd plugins/<your-name>
+pnpm install
+pnpm typecheck && pnpm test
+```
+
+> **Building a generated/runtime user plugin instead** (hot-reloadable,
+> no build step, drops into a workspace's `.pi/extensions/<name>/`)?
+> Don't copy this template and don't use `npx` from inside the agent
+> runtime — run the workspace-local `boring-ui-plugin scaffold <name>`.
+
+## Shape
+
+```
+plugins/<name>/
+  package.json         private: true, workspace:* deps, nested exports map
+  tsconfig.json        paths aliases into packages/workspace/src for fast iteration
+  tsup.config.ts       nested entries (front/index, server/index, shared/index)
+  vitest.config.ts     jsdom + @vitejs/plugin-react + globals: true
+                       setupFiles: ./src/test-setup.ts
+  src/
+    front/
+      index.ts         definePlugin({ ... }) entry and re-exports
+      panels.tsx
+      surfaceResolver.ts
+      __tests__/xxxPlugin.test.ts
+    server/
+      index.ts         createXxxServerPlugin() and default server factory
+    shared/
+      constants.ts     ids, surface kinds
+      types.ts         param/option types
+      index.ts         re-export
+```
+
+## What lives where
+
+- **front/** — anything that runs in the browser shell: panels, command
+  contributions, surface resolvers, providers, bindings.
+- **server/** — anything that runs in the agent backend: agent tools,
+  system prompt fragments, server hooks.
+- **shared/** — constants and types used by both sides. Keep it tiny.
+- **`src/test-setup.ts`** — jest-dom matchers, ResizeObserver + Range
+  polyfills, testing-library cleanup. Each plugin owns its own copy;
+  keep them in sync with `packages/plugin-cli/templates/plugin/src/test-setup.ts`
+  if the canonical setup changes.
+
+## Invariants
+
+`packages/workspace/scripts/check-plugin-invariants.mjs` lints this
+template (and the live plugins) for the plugin contract. Keep it valid.

package/templates/plugin/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@hachej/boring-plugin-template",
+  "version": "0.0.0",
+  "type": "module",
+  "private": true,
+  "description": "Reference app/internal boring-ui package-plugin example using declarative definePlugin({ ... }) front contributions plus boot-time server integration. Generated .pi/extensions plugins should use boring-ui-plugin scaffold instead.",
+  "boring": {
+    "label": "Sample",
+    "front": "dist/front/index.js",
+    "server": "dist/server/index.js"
+  },
+  "pi": {
+    "systemPrompt": "Sample plugin template \u2014 replace this prompt with a short hint telling the agent when to use your plugin's panels/tools."
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/front/index.d.ts",
+      "import": "./dist/front/index.js"
+    },
+    "./front": {
+      "types": "./dist/front/index.d.ts",
+      "import": "./dist/front/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    },
+    "./shared": {
+      "types": "./dist/shared/index.d.ts",
+      "import": "./dist/shared/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "pnpm --filter @hachej/boring-ui-kit build && pnpm --filter @hachej/boring-agent build && pnpm --filter @hachej/boring-workspace build && tsc --noEmit",
+    "test": "pnpm --filter @hachej/boring-ui-kit build && vitest run --passWithNoTests",
+    "lint": "pnpm run typecheck",
+    "clean": "rm -rf dist .tsbuildinfo"
+  },
+  "peerDependencies": {
+    "@hachej/boring-workspace": "workspace:*",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@hachej/boring-ui-kit": "workspace:*"
+  },
+  "devDependencies": {
+    "@hachej/boring-workspace": "workspace:*",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.0.0",
+    "jsdom": "^29.0.2",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^3.1.3"
+  }
+}

package/templates/plugin/src/front/__tests__/samplePlugin.test.ts

@@ -0,0 +1,53 @@
+import { describe, expect, it, vi } from "vitest"
+import samplePlugin, { SAMPLE_PANEL_ID, SamplePanel } from "../index"
+import { SAMPLE_PLUGIN_ID, SAMPLE_SURFACE_KIND } from "../../shared/constants"
+
+describe("samplePlugin (BoringFrontFactory)", () => {
+  it("registers a panel, a panel command, and a surface resolver", async () => {
+    const registerPanel = vi.fn()
+    const registerPanelCommand = vi.fn()
+    const registerSurfaceResolver = vi.fn()
+    const api = {
+      registerProvider: vi.fn(),
+      registerBinding: vi.fn(),
+      registerCatalog: vi.fn(),
+      registerPanel,
+      registerPanelCommand,
+      registerLeftTab: vi.fn(),
+      registerSurfaceResolver,
+    }
+
+    await samplePlugin(api)
+
+    expect(registerPanel).toHaveBeenCalledExactlyOnceWith(
+      expect.objectContaining({
+        id: SAMPLE_PANEL_ID,
+        label: "Sample",
+        placement: "center",
+        component: SamplePanel,
+      }),
+    )
+    expect(registerPanelCommand).toHaveBeenCalledExactlyOnceWith(
+      expect.objectContaining({
+        id: "sample.open",
+        title: "Open Sample",
+        panelId: SAMPLE_PANEL_ID,
+      }),
+    )
+    expect(registerSurfaceResolver).toHaveBeenCalledExactlyOnceWith(
+      expect.objectContaining({
+        id: "sample",
+        kind: SAMPLE_SURFACE_KIND,
+      }),
+    )
+  })
+
+  it("is the default export (required for hot-reload dynamic import)", () => {
+    expect(typeof samplePlugin).toBe("function")
+  })
+
+  it("carries pluginId + pluginLabel metadata (definePlugin contract)", () => {
+    expect(samplePlugin.pluginId).toBe(SAMPLE_PLUGIN_ID)
+    expect(samplePlugin.pluginLabel).toBe("Sample")
+  })
+})

package/templates/plugin/src/front/index.ts

@@ -0,0 +1,45 @@
+import { definePlugin, type BoringFrontFactoryWithId } from "@hachej/boring-workspace/plugin"
+import { SAMPLE_PLUGIN_ID } from "../shared/constants"
+import { SAMPLE_PANEL_ID, SamplePanel } from "./panels"
+import { sampleSurfaceResolver } from "./surfaceResolver"
+
+/**
+ * Default-exported `BoringFrontFactoryWithId`. The workspace shell
+ * accepts this directly in `WorkspaceProvider.plugins`; on bootstrap,
+ * it dispatches each declarative field to the corresponding
+ * `api.register*` method.
+ *
+ * `definePlugin(config)` takes a single declarative config object.
+ * For imperative composition (calling an external factory), use the
+ * `setup: (api) => void` escape hatch — see SKILL.md.
+ *
+ * Plugins in `.pi/extensions/<name>/` also get hot-reloaded — the
+ * workspace dynamically re-imports this module and re-runs the
+ * factory.
+ */
+const samplePlugin: BoringFrontFactoryWithId = definePlugin({
+  id: SAMPLE_PLUGIN_ID,
+  label: "Sample",
+  panels: [
+    {
+      id: SAMPLE_PANEL_ID,
+      label: "Sample",
+      component: SamplePanel,
+      placement: "center",
+      source: "app",
+    },
+  ],
+  commands: [
+    {
+      id: "sample.open",
+      title: "Open Sample",
+      panelId: SAMPLE_PANEL_ID,
+    },
+  ],
+  surfaceResolvers: [sampleSurfaceResolver],
+})
+
+export default samplePlugin
+
+export { SamplePanel, SAMPLE_PANEL_ID } from "./panels"
+export { sampleSurfaceResolver } from "./surfaceResolver"

package/templates/plugin/src/front/panels.tsx

@@ -0,0 +1,16 @@
+import type { PaneProps } from "@hachej/boring-workspace"
+import type { SampleParams } from "../shared/types"
+
+export const SAMPLE_PANEL_ID = "sample-panel"
+
+export function SamplePanel({ params }: PaneProps<SampleParams>) {
+  return (
+    <div className="flex h-full min-h-0 min-w-0 flex-col bg-background text-foreground">
+      <div className="min-h-0 min-w-0 flex-1 overflow-auto p-4">
+        <div className="rounded-lg border border-border bg-card p-4 text-sm">
+          {params.id}
+        </div>
+      </div>
+    </div>
+  )
+}

package/templates/plugin/src/front/surfaceResolver.ts

@@ -0,0 +1,19 @@
+import type { BoringFrontSurfaceResolverRegistration } from "@hachej/boring-workspace/plugin"
+import { SAMPLE_SURFACE_KIND } from "../shared/constants"
+import { SAMPLE_PANEL_ID } from "./panels"
+
+export const sampleSurfaceResolver: BoringFrontSurfaceResolverRegistration = {
+  id: "sample",
+  kind: SAMPLE_SURFACE_KIND,
+  source: "app",
+  resolve(request) {
+    if (request.kind !== SAMPLE_SURFACE_KIND) return undefined
+    return {
+      id: `sample:${request.target}`,
+      component: SAMPLE_PANEL_ID,
+      title: request.target,
+      params: { id: request.target },
+      score: 0,
+    }
+  },
+}

package/templates/plugin/src/server/index.ts

@@ -0,0 +1,29 @@
+import type { AgentTool } from "@hachej/boring-workspace"
+import {
+  defineServerPlugin,
+  type WorkspaceServerPlugin,
+} from "@hachej/boring-workspace/server"
+import { SAMPLE_PLUGIN_ID } from "../shared/constants"
+
+export function createSampleServerPlugin(): WorkspaceServerPlugin {
+  return defineServerPlugin({
+    id: SAMPLE_PLUGIN_ID,
+    label: "Sample",
+    agentTools: [] satisfies AgentTool[],
+    systemPrompt: "## Sample Plugin",
+  })
+}
+
+/**
+ * Default export — adapter for the standard `defaultPluginPackages`
+ * load process. The workspace's `pluginEntryResolver` calls a
+ * dir-source plugin's default-exported factory with `(options, ctx)`
+ * where `ctx = { workspaceRoot, bridge }`. The named
+ * `createSampleServerPlugin()` factory stays for direct callers.
+ */
+export default function defaultSampleServerPlugin(
+  _options?: unknown,
+  _ctx?: { workspaceRoot: string; bridge: unknown },
+): WorkspaceServerPlugin {
+  return createSampleServerPlugin()
+}

package/templates/plugin/src/shared/constants.ts

@@ -0,0 +1,2 @@
+export const SAMPLE_PLUGIN_ID = "sample"
+export const SAMPLE_SURFACE_KIND = "sample.open"

package/templates/plugin/src/shared/index.ts

@@ -0,0 +1,2 @@
+export * from "./constants"
+export * from "./types"

package/templates/plugin/src/shared/types.ts

@@ -0,0 +1,3 @@
+export interface SampleParams {
+  id: string
+}