revdeck 0.1.0 → 0.2.1

package/CHANGELOG.md

@@ -6,6 +6,40 @@ All notable changes to this project are documented here. The format is based on
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-11-12
+
+### Fixed
+
+- `revdeck devcontainer --write` no longer writes absolute host paths into the shared
+  `devcontainer.json`: mounts use `${localEnv:HOME}${localEnv:USERPROFILE}` and a stable
+  `~/.local/state/revdeck/devcontainer/{run,state}` bridge. The daemon listens on a second RPC socket
+  there for containers. Comments and formatting in an existing JSONC file are preserved.
+
+## [0.2.0] - 2026-11-12
+
+### Added
+
+- Reactions on platform comments: thread cards in the UI, `revdeck react --note <id> --emoji <name>`,
+  and the `reactions.list` / `reactions.toggle` RPC methods. Existing reactions and the current user's
+  choice are shown for GitLab and GitHub.
+- `revdeck eject`: removes the config, installed skills and command files, the `revdeck` MCP entry and
+  the local cache from a repository. It is preview-only without `--yes` and leaves foreign files and
+  other MCP servers intact.
+- Attachments for comments: the UI **Attach** button and `revdeck attach` upload images and videos
+  through the host daemon. GitLab project uploads return absolute URLs, relative `/uploads/` links are
+  normalized to the platform host during publish, and the sanitizer allows images only from that host.
+  Only raster images and videos with matching extension, MIME and file signature are accepted.
+- Devcontainer support: `revdeck devcontainer --write` mounts the host runtime and state directories,
+  sets `REVDECK_*` variables and marks the container, so revdeck reuses the host daemon and never runs
+  `gh`/`glab` inside. `revdeck doctor` checks the host daemon in this mode; `revdeck daemon start
+  --host` exposes the HTTP UI, and `revdeck eject` removes the generated mounts/env.
+
+### Fixed
+
+- `revdeck init` keeps one canonical skill in `.agents/skills/revdeck` (now including
+  `agents/openai.yaml`) and links `.claude/skills/revdeck` to it instead of copying the procedure files.
+  A copy is used only on platforms without symlink support.
+
 ## [0.1.0] - 2026-11-11
 
 First public release.

package/CONTRIBUTING.md

@@ -56,8 +56,9 @@ Rules of thumb:
 
 ## Adding a harness adapter
 
-Add a `SPECS` entry in `src/cli/init.ts` with the skill target, MCP config path or command file, then
-document it in `docs/integrations.md`. `init` must never overwrite files it does not own.
+Add a `SPECS` entry in `src/cli/init.ts` with the MCP config path, command file or `linkSkill` flag, then
+document it in `docs/integrations.md`. The canonical skill is always `.agents/skills/revdeck`; adapters
+link to it instead of copying the procedure files. `init` must never overwrite files it does not own.
 
 ## Translations
 
@@ -87,11 +88,20 @@ npm version minor
 git push --follow-tags
 ```
 
-The `release` workflow publishes to npm with provenance and creates a GitHub release. It needs an
-`NPM_TOKEN` repository secret: a granular npm token with read/write access to `revdeck` and
-**Bypass 2FA** enabled (or a classic Automation token). Without it the publish step fails with
-`ENEEDAUTH`; the workflow now reports that explicitly before publishing. The version in
-`src/version.ts` must match `package.json`. `prepublishOnly` re-runs build, typecheck and tests.
+The `release` workflow publishes to npm with provenance and creates a GitHub release. It uses
+[trusted publishing](https://docs.npmjs.com/trusted-publishers): GitHub Actions gets a short-lived
+OIDC token, so no npm token is stored in the repository and provenance is generated automatically.
+
+Requirements, all configured once on npmjs.com (package `revdeck` → Settings → Trusted publishing):
+
+- publisher `katrov/revdeck`, workflow file `release.yml`, environment left empty;
+- "stage only" disabled, so tagged releases publish straight away.
+
+The workflow runs on Node 24 and installs npm >= 11.15 because trusted publishing requires npm
+11.5.1 or newer. If `id-token` is not writable the "Verify OIDC permissions" step fails with a
+clear error; `ENEEDAUTH` from npm means the trusted publisher entry does not match the repo,
+workflow file or environment. The version in `src/version.ts` must match `package.json`.
+`prepublishOnly` re-runs build, typecheck and tests.
 
 ## Security
 

package/README.md

@@ -24,7 +24,7 @@ and a web UI. Platform tokens stay on the host.
   bound to a hash of the plan and is idempotent. There is no “agent approved its own comment” path.
 - **Tokens never reach the agent.** The daemon calls `glab`/`gh` on the host and scrubs platform tokens
   from child environments. A sandboxed agent only gets an RPC.
-- **GitLab and GitHub.** One model: MR/PR, threads, diff, resolve, reactions, line comments.
+- **GitLab and GitHub.** One model: MR/PR, threads, diff, resolve, reactions, line comments, attachments.
 - **Many reviews.** The daemon keeps them in SQLite; the UI is a triage queue with keyboard shortcuts.
 - **Any harness.** MCP tools for MCP clients, the same capabilities over CLI, and a skill that carries
   the review procedure.
@@ -62,8 +62,11 @@ revdeck ui            # open the local UI
 ```
 
 `init` never overwrites an existing config without `--force`, and it merges `.mcp.json` instead of
-replacing it. Auto-start on login: `revdeck daemon install` (systemd user unit on Linux, launchd plist
-on macOS). Use a global install for this — an `npx` cache path can be evicted.
+replacing it. `revdeck eject` is the inverse: it removes the config, installed skills and command files,
+the `revdeck` MCP entry and the local `.revdeck/` cache, leaving foreign files and other MCP servers
+untouched. It only shows the plan by default; add `--yes` to apply (`--keep-config` keeps
+`.revdeck.yml`). Auto-start on login: `revdeck daemon install` (systemd user unit on Linux, launchd
+plist on macOS). Use a global install for this — an `npx` cache path can be evicted.
 
 ## Languages
 
@@ -91,6 +94,8 @@ Russian READMEs live in this repository; translation fixes are welcome.
 | Command | What it does |
 |---|---|
 | `revdeck init` | config, harness adapters, MCP |
+| `revdeck eject [--yes]` | remove revdeck-owned config, adapters and MCP entry |
+| `revdeck devcontainer [--write]` | mount the host daemon socket/state into a devcontainer |
 | `revdeck doctor` | environment, `glab`/`gh` auth, daemon, adapters |
 | `revdeck list [--remote]` | tracked reviews or open ones from the platform |
 | `revdeck open <N\|URL>` | load a review |
@@ -101,6 +106,8 @@ Russian READMEs live in this repository; translation fixes are welcome.
 | `revdeck reply <N> --thread <id> --body …` | draft a reply |
 | `revdeck publish <N> [--yes]` | preview or publish after confirmation |
 | `revdeck notes <N> …` | line comments from the human |
+| `revdeck react <N> --note <id> --emoji <name>` | toggle a reaction on a platform comment |
+| `revdeck attach <N> --file <image-or-video>` | upload an attachment and print its markdown link |
 | `revdeck rules [--explain <path>]` | effective rules |
 | `revdeck checks <N> [--run --yes]` | project checks |
 | `revdeck export/import <N>` | legacy file exchange |
@@ -110,6 +117,41 @@ Russian READMEs live in this repository; translation fixes are welcome.
 
 Common flags: `--json`, `--root`, `--review`, `--platform`, `--project`, `--host`, `--lang ru|en`.
 
+## Attachments
+
+The UI has an **Attach** button next to reply, finding and line-comment editors; the CLI equivalent is
+`revdeck attach <N> --file shot.png`. The file is uploaded by the daemon on the host, and the editor
+receives a markdown link with an absolute platform URL, so GitLab renders images and videos in the
+original MR. Relative GitLab `/uploads/...` links in existing drafts are rewritten to
+`https://<host>/uploads/...` during the publish preview.
+
+GitLab is supported through project uploads (requires a `glab` with `--form` support). GitHub has no
+public attachment API, so the button is disabled there and a link must be pasted manually. Only raster
+images and videos (PNG, JPEG, GIF, WebP, AVIF, MP4, WebM, OGV, MOV) are accepted; SVG and arbitrary
+files are rejected.
+
+## Devcontainer
+
+The daemon, `glab` and `gh` stay on the host. From the repository root:
+
+```bash
+revdeck devcontainer          # print the mounts and environment
+revdeck devcontainer --write  # merge them into .devcontainer/devcontainer.json
+```
+
+The command mounts the stable host bridge `~/.local/state/revdeck/devcontainer/run` at `/run/revdeck`
+(socket) and `~/.local/state/revdeck/devcontainer/state` at `/var/lib/revdeck` (read-only
+`daemon.json`), and sets `REVDECK_RUNTIME_DIR`, `REVDECK_STATE_DIR`, `REVDECK_DEV_CONTAINER=1` and
+`REVDECK_UI_HOST`. The JSON uses `${localEnv:HOME}${localEnv:USERPROFILE}` instead of an absolute
+home path, so the same `.devcontainer/devcontainer.json` works for every developer. Comments and
+foreign keys in an existing JSONC file are preserved.
+
+The daemon creates the bridge socket on startup, so on the host run `revdeck daemon restart`, then
+rebuild the container. Inside the container revdeck never starts a local daemon, so `gh`/`glab` are
+never invoked there; if the host socket is missing it fails with a clear `DEVCONTAINER` error.
+`revdeck doctor` is aware of this mode. For the UI from the container, start the host daemon with
+`revdeck daemon start --host 0.0.0.0`.
+
 ## MCP
 
 ```json
@@ -175,7 +217,7 @@ found. Full schema: [docs/configuration.md](docs/configuration.md).
 - `glab`/`gh` run without a shell, with `cwd` outside the working copy and a scrubbed environment;
   secrets are redacted from logs and errors.
 - Comments are checked for GitLab quick actions, HTML, hidden/bidi characters, mass mentions and
-  external images.
+  external images (only uploads from the platform host are allowed).
 - Review text is untrusted data; agent instructions say so explicitly.
 
 Details: [docs/threat-model.md](docs/threat-model.md). The guarantee is: the token does not cross the
@@ -192,7 +234,7 @@ read the CLI configuration — isolate the agent.
 | `src/cli` | commands, `init`, `doctor`, export/import |
 | `src/mcp` | MCP server over stdio |
 | `ui` | Svelte 5 + Vite |
-| `skills/revdeck` | review procedures (SKILL, Review, Feedback, Criteria, Rules, Sources) |
+| `skills/revdeck` | review procedures (SKILL, Review, Feedback, Criteria, Rules, Sources, `agents/openai.yaml`) |
 
 More: [docs/architecture.md](docs/architecture.md), [docs/protocol.md](docs/protocol.md),
 [ADR-0001](docs/adr/0001-daemon-first.md).
@@ -216,7 +258,9 @@ Provider tests use recorded CLI responses and need no network. See [CONTRIBUTING
   used yet, though the provider interface is ready.
 - Project checks are planned by the agent; running them requires `revdeck checks --run --yes`.
 - The UI does not open a new review by number; use the CLI and the review appears in the list.
-- Thread resolution is in the thread card; reactions exist in providers but are not exposed in the UI.
+- Thread resolution is in the thread card; reactions are available on thread notes in the UI and through
+  `revdeck react`.
+- GitHub has no public attachment API: the Attach button is disabled there; uploads work in GitLab.
 - Auto-start is supported on Linux and macOS; on Windows run the daemon manually.
 
 ## License

package/README.ru.md

@@ -25,7 +25,7 @@
 - **Токены не уезжают агенту.** Демон вызывает `glab`/`gh` на хосте и вычищает токены из окружения
   дочерних процессов. Агент в песочнице получает только RPC и не видит ни токена, ни конфигурации
   платформы.
-- **GitLab и GitHub.** Одна модель: MR/PR, треды, diff, резолв, реакции, комментарии к строкам.
+- **GitLab и GitHub.** Одна модель: MR/PR, треды, diff, резолв, реакции, комментарии к строкам, вложения.
 - **Несколько ревью.** Демон хранит открытые ревью в SQLite; UI — очередь с поиском и горячими
   клавишами.
 
@@ -51,7 +51,10 @@ revdeck ui            # ссылка на локальный интерфейс
 ```
 
 `revdeck init` не перезаписывает существующий конфиг без `--force` и не трогает чужие ключи в
-`.mcp.json`. Автозапуск демона при входе в систему — `revdeck daemon install`: создаёт systemd user unit
+`.mcp.json`. Обратная операция — `revdeck eject`: удаляет конфиг, установленные скиллы и файлы команд,
+запись `revdeck` в MCP и локальный кеш `.revdeck/`, не трогая чужие файлы и другие MCP-серверы. По
+умолчанию команда только показывает план; применить — с `--yes` (`--keep-config` оставляет
+`.revdeck.yml`). Автозапуск демона при входе в систему — `revdeck daemon install`: создаёт systemd user unit
 (Linux) или launchd plist (macOS) и печатает команду включения. Для автозапуска ставьте пакет глобально:
 путь в кеше `npx` может быть очищен.
 
@@ -77,6 +80,8 @@ revdeck ui            # ссылка на локальный интерфейс
 | Команда | Что делает |
 |---|---|
 | `revdeck init` | конфиг, адаптеры, MCP |
+| `revdeck eject [--yes]` | удалить конфиг, адаптеры и MCP-запись revdeck |
+| `revdeck devcontainer [--write]` | смонтировать сокет/state демона хоста в devcontainer |
 | `revdeck doctor` | окружение, `glab`/`gh`, демон, адаптеры |
 | `revdeck list [--remote]` | локальные или открытые на платформе ревью |
 | `revdeck open <N│URL>` | загрузить ревью |
@@ -87,6 +92,8 @@ revdeck ui            # ссылка на локальный интерфейс
 | `revdeck reply <N> --thread <id> --body …` | черновик ответа |
 | `revdeck publish <N> [--yes]` | план или публикация после подтверждения |
 | `revdeck notes <N> …` | комментарии человека к строкам |
+| `revdeck react <N> --note <id> --emoji <name>` | поставить или снять реакцию на комментарий платформы |
+| `revdeck attach <N> --file <картинка-или-видео>` | загрузить вложение и вывести markdown-ссылку |
 | `revdeck rules [--explain <path>]` | эффективные правила |
 | `revdeck checks <N> [--run --yes]` | проверки проекта |
 | `revdeck export/import <N>` | обмен с файловым форматом |
@@ -96,6 +103,41 @@ revdeck ui            # ссылка на локальный интерфейс
 
 Общие флаги: `--json`, `--root`, `--review`, `--platform`, `--project`, `--host`, `--lang ru|en`.
 
+## Вложения
+
+В UI рядом с редакторами ответа, замечания и комментария к строке есть кнопка **Прикрепить**; в CLI —
+`revdeck attach <N> --file shot.png`. Файл загружает демон на хосте, а в редактор попадает
+markdown-ссылка с абсолютным URL платформы, поэтому GitLab показывает картинки и видео в исходном MR.
+Относительные ссылки GitLab `/uploads/...` в уже написанных черновиках при предпросмотре публикации
+переписываются в `https://<host>/uploads/...`.
+
+GitLab поддержан через project uploads (нужен `glab` с поддержкой `--form`). У GitHub нет публичного
+API загрузки вложений, поэтому кнопка там отключена, а ссылку нужно вставить вручную. Принимаются
+только растровые картинки и видео (PNG, JPEG, GIF, WebP, AVIF, MP4, WebM, OGV, MOV); SVG и
+произвольные файлы отклоняются.
+
+## Devcontainer
+
+Демон, `glab` и `gh` остаются на хосте. Из корня репозитория:
+
+```bash
+revdeck devcontainer          # показать mounts и окружение
+revdeck devcontainer --write  # добавить их в .devcontainer/devcontainer.json
+```
+
+Команда монтирует стабильный мост хоста `~/.local/state/revdeck/devcontainer/run` в `/run/revdeck`
+(сокет) и `~/.local/state/revdeck/devcontainer/state` в `/var/lib/revdeck` (только чтение,
+`daemon.json`) и выставляет `REVDECK_RUNTIME_DIR`, `REVDECK_STATE_DIR`, `REVDECK_DEV_CONTAINER=1` и
+`REVDECK_UI_HOST`. В JSON пишется `${localEnv:HOME}${localEnv:USERPROFILE}`, а не абсолютный домашний
+путь, поэтому один `.devcontainer/devcontainer.json` работает у всех разработчиков. Комментарии и
+чужие ключи в существующем JSONC сохраняются.
+
+Демон создаёт сокет моста при старте: на хосте выполните `revdeck daemon restart`, затем пересоберите
+контейнер. В контейнере revdeck никогда не запускает свой демон, поэтому `gh`/`glab` там не
+вызываются; если сокет хоста недоступен, команда падает с понятной ошибкой `DEVCONTAINER`.
+`revdeck doctor` знает об этом режиме. Для UI из контейнера запустите демон на хосте с
+`revdeck daemon start --host 0.0.0.0`.
+
 ## MCP
 
 ```json
@@ -162,7 +204,7 @@ revdeck ищет `AGENTS.md`, `CLAUDE.md`, `CONTRIBUTING.md` и `docs/*` и пр
 - `glab`/`gh` вызываются без shell, с `cwd` вне рабочей копии и вычищенным окружением; секреты
   редактируются в логах и ошибках.
 - Комментарии проверяются на быстрые команды GitLab, HTML, скрытые/bidi-символы, `@all` и внешние
-  картинки.
+  внешние картинки (разрешены только загрузки с хоста платформы).
 - Текст MR — недоверенные данные; агентские инструкции это оговаривают.
 
 Подробно: [docs/ru/threat-model.md](docs/ru/threat-model.md). Гарантия формулируется так: токен не
@@ -179,7 +221,7 @@ revdeck ищет `AGENTS.md`, `CLAUDE.md`, `CONTRIBUTING.md` и `docs/*` и пр
 | `src/cli` | команды, `init`, `doctor`, экспорт/импорт |
 | `src/mcp` | MCP-сервер (stdio) |
 | `ui` | Svelte 5 + Vite |
-| `skills/revdeck` | процедуры ревью (SKILL, Review, Feedback, Criteria, Rules, Sources) |
+| `skills/revdeck` | процедуры ревью (SKILL, Review, Feedback, Criteria, Rules, Sources, `agents/openai.yaml`) |
 
 Подробно: [docs/ru/architecture.md](docs/ru/architecture.md), [docs/ru/protocol.md](docs/ru/protocol.md),
 [ADR-0001](docs/ru/adr/0001-daemon-first.md).
@@ -202,7 +244,10 @@ npm run build         # dist/cli.js, dist/daemon.js, dist/mcp.js, dist/ui
   ещё не используются, хотя провайдеры к этому готовы.
 - Проверки проекта агент только планирует; запуск — `revdeck checks --run --yes`.
 - UI не открывает новое ревью по номеру: это делает CLI, ревью появляется в списке.
-- Резолв тредов есть в карточке треда; реакции реализованы в провайдерах, но пока не выведены в UI.
+- Резолв тредов есть в карточке треда; реакции доступны на комментариях тредов в UI и через
+  `revdeck react`.
+- У GitHub нет публичного API загрузки вложений: кнопка «Прикрепить» там отключена; загрузка работает
+  в GitLab.
 - Поддержаны Linux и macOS для автозапуска; Windows — запуск вручную.
 
 ## Лицензия