verstak-docs/05_Official_Plugins.md

# Official Plugins

Официальные плагины — базовый набор инструментов Верстака. Они используют тот же
plugin runtime, что и сторонние. Их задача — показать, что платформа работает
через capabilities и contribution points.

Все официальные плагины используют префикс `verstak.*` в id.

## 1. `verstak.files`

Назначение:

- дерево/список файлов внутри дела;
- добавление файлов и папок;
- перемещение/переименование;
- открытие через Workbench (openProvider routing);
- trash/restore (через `verstak.trash`);
- file metadata.

Provides:

```
workspace.files
vault.files
entity.file
file.browser
```

Optional requires:

```
editor.text
viewer.file
preview.file
search.provider
```

Текущий статус: реализован. Открывает файлы через `api.workbench.openResource()`,
не импортирует редактор напрямую. Корзина выделена в отдельный плагин `verstak.trash`.

## 2. `verstak.notes`

Назначение:

- markdown notes как UI-слой над обычными `.md` файлами;
- каноническая папка `Notes/` внутри дела;
- `Overview.md` — обычное markdown-имя файла, не специальная UI-сущность;
- note metadata;
- rename с синхронизацией title/filename;
- conflict dialog при конфликте имён.

Provides:

```
workspace.notes
note.registry
```

Requires:

```
verstak/core/files/v1
```

Optional requires:

```
editor.text.markdown
search.provider
```

Текущий статус: реализован. Title и filename синхронизированы. При конфликте
имени показывается conflict dialog.

## 3. `verstak.default-editor`

Назначение:

- редактирование текста и markdown;
- toolbar;
- save flow;
- dirty state;
- markdown preview (встроен, не отдельный плагин);
- keyboard shortcuts (Ctrl+S).

Provides:

```
editor.text
editor.text.markdown
editor.note.markdown
```

Optional requires:

```
link.resolver
```

Текущий статус: реализован как единый плагин с тремя openProviders
(`text`, `generic-markdown`, `notes-markdown`). Использует `api.files.readText` /
`api.files.writeText`. Markdown preview — часть редактора, без отдельного
плагина предпросмотра.

## 4. `verstak.file-preview`

Назначение:

- inline preview для изображений через `api.files.readBytes`;
- metadata view;
- `Open External` через `api.files.openExternal`.

Provides:

```
viewer.file
viewer.image
preview.file
```

Текущий статус: базовый рендеринг изображений через публичный Files API,
плюс metadata файла. Текстовые файлы, код и markdown остаются за
editor-плагинами.

## 5. `verstak.activity`

Назначение:

- сбор activity events;
- отображение истории активности;
- реконструкция работы;
- worklog suggestions для Journal.

Provides:

```
activity.log
activity.provider
activity.reconstruction
```

Subscribes:

```
file.opened
file.changed
note.saved
action.started
browser.capture.received
case.selected
```

Текущий статус: реализован как глобальный sidebar view и workspace item.
Workspace tabs хранят свою activity stream; глобальный view агрегирует все
workspace streams. Предоставляет `activityProviders`; desktop runtime записывает
события в plugin storage даже когда Activity view не смонтирован. Реконструирует
worklog suggestions через контракт `verstak.activity.suggestWorklog`.

## 6. `verstak.journal`

Назначение:

- ручной журнал работ;
- billable/non-billable;
- приём suggested time из activity;
- создание записи из завершённого todo.

Provides:

```
worklog
journal
report.worklog
```

Optional requires:

```
activity.reconstruction
```

Текущий статус: реализован как глобальный sidebar view и workspace item.
Хранит записи в plugin settings namespace, импортирует не-billable записи
из `verstak.activity.suggestWorklog`, дедуплицирует по Activity suggestion id.

## 7. `verstak.browser-inbox`

Назначение:

- приём страниц, ссылок, выделенного текста и файлов из browser extension;
- pending queue с scoping по workspace;
- domain bindings;
- конвертация inbox entry в note/link/file;
- запись конвертаций в Activity.

Provides:

```
capture.browser
browser.inbox
domain.binding
```

Requires:

```
network.local
```

Optional requires:

```
workspace.notes
activity.log
search.provider
```

Текущий статус: реализован как глобальный sidebar view и workspace item.
Local receiver в paired mode с токеном. Поддерживает конвертацию в note
(через публичный Files API), link (`.url` файлы), text file attachments
и bounded binary attachments. Конвертации записываются в Activity.

## 8. `verstak.search`

Назначение:

- workspace-scoped search;
- поиск по мере ввода;
- поиск по именам файлов/папок и содержимому текстовых файлов;
- persistent search index;
- cross-provider runtime hosting.

Provides:

```
search
search.provider
search.indexer
```

Текущий статус: реализован как workspace item и `searchProviders` contribution.
Ищет по мере ввода, индексирует vault, обновляет индекс по файловым событиям,
поддерживает других search providers через runtime.

## 9. `verstak.secrets`

Назначение:

- защищённое хранилище доступов;
- workspace-scoped secrets;
- master password (AES-GCM).

Provides:

```
secret-store
secrets.read-ui
secrets.write-ui
```

Текущий статус: реализован. Desktop core имеет AES-GCM secret store,
разблокируемый один раз за сессию. Плагин показывает global и workspace-scoped
секреты, поддерживает редактирование, удаление, копирование markdown secret links.
Рендерит `verstak-secret://...` ссылки.

## 10. `verstak.todo`

Назначение:

- списки задач внутри дел и глобально;
- статусы: open, done, cancelled;
- приоритеты, due date, reminders;
- создание Journal записи из завершённого todo.

Provides:

```
workspace.todo
```

Текущий статус: реализован. Reminders с нативными desktop-уведомлениями
(при наличии capability `verstak/core/notifications/v1`). Поддерживает
создание Journal записи из todo с копированием фактических данных.

## 11. `verstak.trash`

Назначение:

- глобальный просмотр удалённых файлов;
- восстановление из корзины;
- перманентное удаление.

Provides:

```
trash.management
```

Текущий статус: реализован как глобальный sidebar view. Работает
с internal trash storage (`.verstak/trash/files/`).

## 12. `verstak.sync`

Назначение:

- ручная синхронизация vault;
- отображение статуса и конфликтов;
- настройки подключения к sync server.

Provides:

```
sync.ui
```

Requires:

```
network.remote
```

Текущий статус: реализован как глобальный sidebar view и settings panel.
Показывает vaultId, статус, unpushed count, ошибки и конфликты.
Не делает auto-resolve конфликтов.

## 13. `verstak.templates`

Назначение:

- шаблоны дел при создании;
- предопределённые наборы workspace tools;
- one-time применение (шаблон не привязан к делу после создания).

Provides:

```
case.templates
```

Текущий статус: реализован через built-in templates в desktop core
(General, Project, Writing, Admin, Minimal). Модальное окно создания
дела показывает описание шаблона и его вкладки.

## 14. `verstak.platform-test`

Назначение:

- тестовый плагин для отладки runtime;
- диагностические панели для проверки API;
- не для конечных пользователей.

Текущий статус: используется только при разработке.