verstak-official-plugins/AGENTS.md

2.3 KiB
Raw Permalink Blame History

AGENTS.md — Verstak Official Plugins

Назначение

Монорепозиторий официальных плагинов Верстака. Каждый плагин — полноценный динамический плагин, проходящий тот же lifecycle, что и сторонние.

Состав

verstak-official-plugins/
  AGENTS.md
  plugins/
    platform-test/      — тестовый плагин для проверки runtime
    files/
    notes/
    markdown-editor/
    markdown-preview/
    file-preview/
    activity/
    journal/
    browser-inbox/
    search/
    secrets/
    templates/
  packages/
    shared-ui/
    test-harness/
    plugin-sdk/         — временно, пока SDK не выделен
  package.json
  tsconfig.json

Правила для всех плагинов

  1. Каждый плагин имеет plugin.json с полным manifest.
  2. Плагины зависят от capabilities, а не от plugin ID.
  3. Нет скрытого privileged path для official плагинов.
  4. disable не удаляет пользовательские данные.
  5. Отсутствие optional capability — degraded mode, не ошибка.
  6. Plugin Manager показывает статус каждого плагина.

Первый минимальный набор

  • platform-test — для отладки runtime
  • official.files — файловый менеджер
  • official.notes — заметки
  • official.markdown-editor — редактор
  • official.markdown-preview — предпросмотр
  • official.activity — активность
  • official.browser-inbox — браузерный inbox

Все они должны быть настоящими динамическими плагинами, даже если поставляются вместе с приложением.

Структура плагина

plugin-id/
  plugin.json           — обязательный manifest
  frontend/
    index.js            — entry point
    style.css
  backend/              — опционально
    plugin-linux-amd64
    plugin-windows-amd64.exe
  migrations/           — опционально
    001_init.sql
  assets/
  README.md