Files
kandev/docs/plans/plugins/task-16-manifest-bundle.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

1.5 KiB

id, title, status, wave, depends_on, plan
id title status wave depends_on plan
task-16 Manifest ui.bundle / ui.styles fields done A
task-01
docs/plans/plugins/plan.md

Manifest ui.bundle / ui.styles fields

Title

Extend the plugin manifest to declare a frontend JS bundle for native UI plugins.

Inputs

  • Existing internal/plugins/manifest/ (task-01): Manifest, UISection, UIPage.
  • PLUGIN-API.md loading model: bundle served at /api/plugins/{id}/bundle, proxied to the plugin's declared bundle path.

Acceptance

  1. UISection gains Bundle string (yaml bundle, json bundle) — a path on the plugin process serving an ES module, e.g. /ui/bundle.js; and Styles []string (optional CSS paths).
  2. Validate: if ui.bundle is set it must be a root-relative path (starts /). ui.pages remain valid but are now optional/secondary (native routes come from the bundle at runtime).
  3. Helper (*Manifest) HasUIBundle() bool.
  4. Tests cover: valid bundle path, invalid (non-root-relative) bundle path, manifest with bundle + no pages passes.

Files

  • edit apps/backend/internal/plugins/manifest/manifest.go, validate.go
  • apps/backend/internal/plugins/manifest/manifest_test.go (extend)

Verification

  • go test ./internal/plugins/manifest/...; golangci-lint run ./internal/plugins/manifest/... (apps/backend)

Output contract

Report the added fields + validation rule + helper. Stay within internal/plugins/manifest/.

Dependencies

task-01 (done).