Files
kandev/docs/plans/plugins/task-12-settings-page.md
T
Kandev Agent c53f699714 feat: add plugin system with grpc runtime and native ui plugins
- go plugin backends ship as release tarballs (per-platform binaries, checksums) that
  kandev installs from url/upload or filesystem sideload+sync, then spawns and
  supervises via hashicorp/go-plugin (unix socket / loopback tcp+automtls)
- strict typed grpc contract (kandev.plugin.v1): DeliverEvent/InvokeTool/HandleWebhook
  plus a capability-gated host service (state, secrets, emit); author sdk in
  pkg/pluginsdk; packaging cli in cmd/plugin-pack
- native frontend bundles: window.registerKandevPlugin + registry/host loader with
  dynamic routes, nav items, slots and ws handlers; plugins settings page with
  install dialog, sync button and enable/disable/uninstall
- gated behind the plugins feature flag (prod off, dev/e2e on); covered by unit and
  integration tests plus playwright e2e against a real packaged fixture plugin

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-16 17:55:45 +01:00

2.2 KiB

id, title, status, wave, depends_on, plan
id title status wave depends_on plan
task-12 Plugins settings page (list/register/enable/disable/uninstall) pending 3
task-10
task-11
docs/plans/plugins/plan.md

Plugins settings page

Title

A Plugins settings page listing registered plugins with status badges and enable/disable/uninstall actions plus a register-via-manifest-paste dialog, gated on the plugins feature flag.

Inputs

  • Slice + API from task-11; feature flag from task-10 (useFeature("plugins") via apps/web/hooks/domains/features/use-feature.ts).
  • Page + route convention: apps/web/app/settings/integrations/jira/page.tsx and registration in apps/web/src/settings-routes.tsx (add import PluginsSettingsPage, a SETTINGS_ROUTES entry, and the switch/nav wiring parallel to IntegrationsIndexPage). Add a nav entry in the settings nav (grep where integrations nav item is defined).
  • Shadcn components via @kandev/ui. Status badge colors: active=green, error=red, disabled=gray, registered=amber, uninstalled=hidden.
  • /mobile-parity: page must be responsive; include mobile layout.

Acceptance

  1. apps/web/app/settings/plugins/page.tsx: lists plugins (name, id, status badge, categories); actions enable/disable/uninstall (confirm dialog on uninstall); "Register plugin" opens a dialog with a manifest YAML textarea → registerPlugin, showing the returned api_key + webhook_secret once with a copy button and a "shown only once" warning.
  2. Route registered in src/settings-routes.tsx; nav item added; whole page gated on useFeature("plugins") (renders nothing / notFound when off).
  3. Each plugin row links to the detail route /settings/plugins/:id (task-13).
  4. Loading/empty/error states.

Files

  • apps/web/app/settings/plugins/page.tsx (+ small child components as needed)
  • edits: apps/web/src/settings-routes.tsx, settings nav file
  • apps/web/app/settings/plugins/page.test.tsx (render + action wiring with mocked slice)

Verification

  • cd apps/web && pnpm run typecheck && pnpm lint && pnpm test -- plugins

Output contract

Report: route key added, nav wiring, feature-gate approach, mobile handling. Component markup itself need not be unit-tested beyond action wiring.

Dependencies

task-10, task-11.