// Preset plugins shipped with the repo (#1043 C-2 follow-up).
//
// Each entry is a published npm package that lives in mulmoclaude's
// `node_modules`; the boot loader registers it through the same path
// as a user-installed runtime plugin (workspace ledger), so the
// frontend dynamic-import + Vue View pipeline runs end-to-end on
// every fresh checkout — no manual `yarn plugin:install` needed for
// testing or for first-launch UX.
//
// Presets and user-installed plugins share the runtime registry. On
// tool-name collision the preset wins (loaded first; static MCP
// built-ins still win over both).
//
// Adding a preset:
//   1. `yarn add <package>` (or extend an existing dep)
//   2. Append a row below
//   3. Restart the server
//
// Removing a preset:
//   1. Remove the row
//   2. Optionally `yarn remove <package>`
//   3. Restart

export interface PresetPlugin {
  /** npm package name (the directory under `node_modules`). */
  packageName: string;
  /** True = NOT shipped in the published `mulmoclaude` tarball (only
   *  resolvable via the yarn-workspaces symlink in a dev checkout).
   *  Loader downgrades the "not resolvable" log to `debug` so a
   *  production `npx mulmoclaude` install doesn't surface warns for
   *  packages we knowingly excluded. */
  devOnly?: boolean;
}

export const PRESET_PLUGINS: readonly PresetPlugin[] = [
  // #1162 — Spotify integration (Liked Songs / playlists / recently
  // played). PR 1 ships OAuth + token persistence; PR 2 adds the
  // listening-data kinds and the Vue View. Loaded as a preset, resolved
  // via the workspace symlink at
  // `node_modules/@mulmoclaude/spotify-plugin/`.
  { packageName: "@mulmoclaude/spotify-plugin" },
  // #2114 — Google integration (Calendar list/create via the locally
  // linked account; Tasks / Drive ride the same grant later, #2115).
  // Server-only tool backed by @mulmoclaude/core/google.
  { packageName: "@mulmoclaude/google-plugin" },
  // #1175 / #1286 — `recipe-book-plugin` removed from the preset
  // list. The plugin source still ships at
  // `packages/plugins/recipe-book-plugin/` for re-enabling, but
  // recipe management has moved to the `mc-cooking-coach` preset
  // skill which drives `data/cooking/recipes/<slug>.md` via
  // Read/Write/Edit. Removing the entry unmounts the plugin's MCP
  // tool + Vue View, which the skill replaces with a markdown
  // README index in the recipes dir.
  // Encore plan PR 1 follow-up — dev-only debug playground plugin.
  // Owns the standalone `/debug` page; the toolbar entry is gated on
  // `VITE_DEV_MODE=1` so production builds hide the launcher button
  // (the page itself is still reachable by typing the URL).
  { packageName: "@mulmoclaude/debug-plugin", devOnly: true },
  // SEC EDGAR runtime plugin — wraps the public EDGAR API as one
  // tool with kind-discriminated dispatch. Server-only (no Vue).
  // Self-healing config flow: when the SEC-required contact info
  // is missing the dispatch returns a `config_required` payload
  // that instructs the LLM to ask the user, write the JSON file
  // at `~/mulmoclaude/config/plugins/<encoded-pkg>/config.json`,
  // and retry. Opt-in per role like every other runtime plugin.
  // Not published yet — kept dev-only until distribution is decided.
  { packageName: "@mulmoclaude/edgar-plugin", devOnly: true },
  // Generic IMAP/SMTP email runtime plugin (#1542). Gmail-default
  // provider presets; App Password auth (no OAuth in v1). v1
  // scaffold returns stubs for list/read/search/send so the
  // config + send-confirmation flow can be exercised end-to-end;
  // real IMAP/SMTP wiring lands in follow-up PRs. devOnly until
  // the surface stabilises + we decide on npm publish.
  { packageName: "@mulmoclaude/email-plugin", devOnly: true },
];