Skip to main content

Task Breakdown: Plugin System

Feature ID: plugin-system Status: Done (Retrospective; ongoing as new plugins ship) Last updated: 2026-05-01

Phase 1 — SDK foundation​

  • T1. @ever-works/plugin package skeleton.
  • T2. IPlugin + BasePlugin abstract.
  • T3. Capability interfaces under src/<capability>/.
  • T4. JSON Schema extensions: x-secret, x-widget, x-envVar.
  • T5. AiOperations LangChain wrapper.

Phase 2 — Discovery + registry​

  • T6. Static plugin discovery at boot (packages/plugins/*).
  • T7. Plugin registry service with capability index.
  • T8. Per-plugin settings schema validator.

Phase 3 — Settings store + cascade​

  • T9. plugin_settings table + encryption.
  • T10. Three-tier resolver: work → user → admin.
  • T11. Secret redaction helpers + tests.

Phase 4 — Facades​

  • T12. AiFacadeService, GitFacadeService, SearchFacadeService, DeployFacadeService, ScreenshotFacadeService, ContentExtractorFacadeService.

Phase 5 — First-party plugins​

  • T13. Ship 39 first-party plugins under packages/plugins/<id>/.
  • T14. Each plugin has everworks.plugin metadata, JSON Schema settings, and at least one test.
  • T15. Each plugin is documented in docs/plugin-system/<id>-plugin.md and listed in built-in-plugins.md.

Phase 6 — API + UI​

  • T16. /api/plugins/* REST endpoints.
  • T17. Plugin settings UI rendered from JSON Schema.
  • T18. CLI plugin commands.

Phase 7 — Docs​

  • T19. docs/plugin-system/ architecture guide.
  • T20. Per-plugin individual doc pages.
  • T21. Retrospective spec/plan/tasks.

Ongoing​

  • New plugin → follow the creating-a-plugin guide, add to canonical built-in-plugins.md, add sidebar entry.

Definition of Done​

  • All 39 first-party plugins discovered and operational.
  • Three-tier cascade verified by tests.
  • Secret hygiene verified by redaction integration tests.
  • Constitution Principles I, II, VII, VIII, X all satisfied.