package plugins import ( "fmt" "path/filepath" "github.com/kandev/kandev/internal/common/config" "github.com/kandev/kandev/internal/common/logger" "github.com/kandev/kandev/internal/db" "github.com/kandev/kandev/internal/events/bus" "github.com/kandev/kandev/internal/plugins/runtime" "github.com/kandev/kandev/internal/plugins/state" "github.com/kandev/kandev/internal/plugins/store" ) // pluginsSubdir is the directory name under the Kandev home dir plugins // live under: records (".yml"/".config.yml"), extracted packages // ("//..."), and per-plugin writable data // ("/data", KANDEV_PLUGIN_DATA_DIR) all share this one root, per // docs/plans/plugins/GRPC-CONTRACT.md §6. const pluginsSubdir = "plugins" // Provide builds the plugin Service, following the repo's provider pattern // (see apps/backend/AGENTS.md "Provider Pattern" and internal/jira/provider.go): // // - An FS-backed installation store rooted at /plugins. // - The SQLite-backed plugin_state store (internal/plugins/state), built // from dbPool and wired onto the Service (see StateStore()). // - An in-memory Registry, loaded from the FS store so existing // installations survive a backend restart. // - A runtime.Manager rooted at the same plugins directory, wired with // svc.handleStatusChange as its OnStatusChange callback so the // supervision loop's health transitions drive Service's state machine. // // secrets is passed straight through to Service.RevealSecret — callers pass // secretadapter.New(secretsStore) in production (see internal/backendapp // initPluginsService for the equivalent pattern); tests can pass a fake. // // eventBus may be nil (tests, or during early boot before the bus is ready). // // Event delivery (internal/plugins/delivery) and spawning already-active // plugins (Service.StartActivePlugins) are NOT started by Provide — see the // "Extension points" doc comment on Service for how backendapp attaches // them after calling Provide. cleanup stops the runtime manager (kills any // spawned processes); callers should register it with addCleanup. func Provide(cfg *config.Config, dbPool *db.Pool, secrets SecretRevealer, eventBus bus.EventBus, log *logger.Logger) (*Service, func() error, error) { dir := filepath.Join(cfg.ResolvedHomeDir(), pluginsSubdir) pluginStore := store.NewFSStore(dir) pluginStore.SetLogger(log) stateStore, err := state.NewStore(dbPool) if err != nil { return nil, nil, fmt.Errorf("plugins: init state store: %w", err) } registry := NewRegistry() if err := registry.Load(pluginStore); err != nil { return nil, nil, fmt.Errorf("plugins: load registry: %w", err) } svc := NewService(pluginStore, registry, eventBus, log) svc.SetState(stateStore) svc.SetSecrets(secrets) svc.SetPluginsDir(dir) rt := runtime.NewManager(dir, svc.handleStatusChange, log) svc.SetRuntime(rt) cleanup := func() error { rt.StopAll() return nil } return svc, cleanup, nil }