dsh-site-bridge 0.0.0-stage → 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 k4 (kesha4)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,242 @@
-# Temporary Holding Version
+# dsh-site-bridge
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**English** · [Русский](README.ru.md) · [中文](README.zh-CN.md)
+
+**Hands and eyes for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) in your own browser.**
+Capture a page's markup and its BFF traffic into files an agent can read, drive the page with trusted
+input, and verify the extension you just wrote — live, in the same tab.
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Two halves, one bridge:
+
+| Half | What it does |
+|---|---|
+| **DSH plugin** (`lib/`) | Owns the loopback bridge and exposes eight tools to the model. Writes the snapshot bundle into the session workspace. |
+| **MV3 extension** (`extension/`) | Lives in your Chrome/Edge profile, works with your cookies, captures markup and network over CDP, drives the page with real input events. Localized: English, Русский, 中文. |
+
+Neither half is useful alone: the plugin holds the model-facing surface and the files, the extension
+holds the browser session and the fidelity.
+
+---
+
+## Why
+
+Writing an extension that embeds into someone else's site is mostly archaeology: what the markup is
+actually made of, which selector survives the next deploy, and which BFF endpoint this button calls
+with which payload. By hand that means DevTools, copy-paste and guesses.
+
+This project turns the archaeology into a capture:
+
+```
+site_capture → captures/<host>/<timestamp>/
+  dom.html          serialized markup of the captured scope
+  dom.json          element tree: boxes, attributes, selector candidates
+  styles.json       computed styles of key nodes + CSS custom properties
+  selectors.md      shortlist of stable selectors, with why each is stable
+  network.jsonl     every captured xhr/fetch, one JSON object per line
+  api.md            endpoints grouped by method+path, with request/response contracts
+  screenshot.png    optional full-page render
+```
+
+The agent reads those files like any other source and writes the extension. Then `site_inject` runs
+that code in the live page, so "it should work" becomes "it works here".
+
+## Features
+
+- **Markup** — element tree with boxes and visibility, computed styles of interactive nodes, CSS
+  variables of the theme, and selector candidates ranked by stability (`data-testid` > `id` > `name` >
+  `aria-label` > class path > positional path), each checked for uniqueness against the live DOM.
+- **BFF traffic** — `xhr`/`fetch` with method, status, request headers, request body, response
+  headers and response body, scoped to the inspected site.
+- **Trusted input** — clicks, typing, select, key presses, scrolling and file uploads through CDP
+  `Input.*` / `DOM.setFileInputFiles`: events the page cannot tell apart from a human's.
+- **Virtual cursor** — a DOM overlay that moves to the target plus a real mouse event at those
+  coordinates, for controls that ignore synthetic `click()`.
+- **Deep selectors** — `host >>> inner` resolves through open shadow roots and same-origin iframes;
+  click coordinates are corrected for frame offsets.
+- **Works in background tabs** — reading, clicking, typing and screenshots work while the tab is not
+  focused (Chrome throttles only timers and animation there).
+- **No stored credentials** — see [Security](#security).
+
+### How this differs from browser automation plugins
+
+There are plugins that hand an agent `browser_*` tools: navigate, click, type, read the page. This is
+not one of them, even though it can do those things — input here is the instrument that verifies a
+capture, not the product.
+
+The product is the capture: the DOM with boxes and computed styles, theme CSS variables, selector
+candidates checked for uniqueness, and the site's own xhr/fetch calls with headers and bodies, all
+written to files an agent can read. Automation exists so that "this selector works" and "this BFF call
+passes with my cookies" are checked against the live page instead of assumed.
+
+The practical consequence: for generic web browsing, a dedicated automation plugin will have more
+tools than this one, and that is fine — it is solving a different problem. For writing an extension
+that embeds into one specific site, you need the capture, and the input comes with it.
+
+## Requirements
+
+- DeepSeek Harness with the `dsh` CLI and a profile (Desktop or Web).
+- Chrome or Edge 125+ (the extension uses `chrome.debugger` and MV3 service workers).
+- Node.js 22+ for the tooling in `tools/` and for the tests.
+
+## Install
+
+### 1. Host half
+
+```powershell
+dsh plugin --profile desktop add dsh-site-bridge
+```
+
+That pulls the published package. From a local checkout instead:
+
+```powershell
+# from the repository root
+powershell -NoProfile -ExecutionPolicy Bypass -File scripts\install.ps1
+```
+
+The script links the plugin into your profile, adds it to `dsh.profile.bundles`, and stages the
+extension into `%USERPROFILE%\.dsh\site-bridge\extension`. Manual equivalent:
+
+```powershell
+dsh plugin --profile desktop add <path-to-this-repo>
+```
+
+Add `"dsh-site-bridge"` to `dsh.profile.bundles` in `%USERPROFILE%\.dsh\profiles\desktop\package.json`
+if the CLI did not, then restart DSH — the host half loads at profile start.
+
+### 2. Browser half
+
+1. `chrome://extensions` → enable **Developer mode** → **Load unpacked** →
+   `%USERPROFILE%\.dsh\site-bridge\extension`.
+2. Open the popup. It shows the port and the path to `bridge.json` (the same is printed by
+   `site_status`).
+3. Click **Import bridge.json** (`Импорт bridge.json` / `导入 bridge.json`) and pick that file, or
+   paste the token — it saves itself, no button.
+4. Open the page you want to work on and click **Connect this tab**.
+
+Chrome shows the "started debugging this browser" banner: that is the CDP session everything runs
+on. It disappears when you press **Disconnect**.
+
+The popup UI follows the browser language: English, Russian and Simplified Chinese ship in
+`extension/_locales`.
+
+## Usage
+
+```text
+site_status                     → bridge state, pairing path, current tab
+site_tabs {action:"list"}       → tabs; {action:"claim", tabId} binds one
+site_network {action:"start"}   → begin recording, then act on the page
+site_capture {screenshot:true}  → write the bundle into the workspace
+site_act {steps:"[...]"}        → click/fill/type/select/press/scroll/upload/wait/eval
+site_cursor {x,y,click:true}    → virtual cursor, real mouse event
+site_shot {fullPage:true}       → screenshot to captures/shots/*.png
+site_inject {js:"..."}          → run your script in the page to verify it
+```
+
+A typical loop for writing a page-embedded extension:
+
+1. `site_tabs` → bind the page.
+2. `site_capture` → read `selectors.md`, `styles.json`, `api.md`.
+3. Write the userscript / content script in your own repository.
+4. `site_inject` with the script body → check that the anchor is found and the BFF call passes with
+   the browser's cookies.
+5. Iterate on the selectors the capture marked as fragile.
+
+## Architecture
+
+```
+┌──────────────────────────── DSH host ────────────────────────────┐
+│  tools (site_*)  ──►  bridge: 127.0.0.1, token, long-poll queue    │
+│  redaction on ingest ──► in-memory buffer ──► artifacts writer     │
+└───────────────────────────────┬───────────────────────────────────┘
+                                │ HTTP long-poll (no websocket)
+┌───────────────────────────────┴───────────────────────────────────┐
+│  MV3 service worker: chrome.debugger ──► CDP                        │
+│    Network domain  → requests with headers and bodies              │
+│    Input domain    → trusted mouse/keyboard, file uploads          │
+│    Runtime domain  → DOM snapshot, selectors, injected scripts     │
+│  popup: pairing, target tab, capture toggle (ru / en / zh)         │
+└────────────────────────────────────────────────────────────────────┘
+```
+
+The wire protocol is small and documented in [docs/protocol.md](docs/protocol.md).
+
+## Security
+
+- **Credentials never leave the browser.** The extension does not read cookies or tokens: the page
+  makes its own requests and the browser attaches them. The bridge sees them in flight, but values of
+  `cookie`, `authorization`, `x-csrf-token`, `x-api-key`, `set-cookie` and similar headers,
+  credential-shaped query parameters and credential-shaped JSON/form fields are replaced with
+  `«redacted»` **on ingest** — before anything is stored.
+- **Nothing credential-shaped is written to disk.** Header *names* are kept, because "this endpoint
+  needs `x-csrf-token`" is part of the contract; the value is not.
+- **Capture is site-scoped.** Only the inspected site's own `xhr`/`fetch` (same host, same
+  registrable domain, or third-party JSON) is recorded. Telemetry and security agents that POST a full
+  page dump to their servers are filtered out — otherwise page source with inline tokens would land in
+  the bundle.
+- **Loopback only.** The bridge binds `127.0.0.1` and rejects any request without the 32-byte pairing
+  token. `site_status` prints the path to the token file, not the token.
+- **Residual risk.** Header values and bodies still pass through the DSH process in memory. If a site
+  puts a secret under an unusual key, redaction will not recognise it. Treat a capture bundle as
+  sensitive, exactly like any traffic dump.
+
+### Position on trust
+
+This is a deliberate trade-off, not a claim of superiority. The bridge requires a token and the
+extension asks for `debugger` rather than `<all_urls>`, which costs convenience — a pairing step and
+the Chrome debugging banner — and buys a smaller blast radius. Plugins that skip the token or take
+host permissions are not doing it wrong; they optimise for a different thing.
+
+## Limitations
+
+Cross-origin iframes, closed shadow roots and body size caps are analysed in
+[docs/limitations.md](docs/limitations.md) — with the exact code location, the plan to remove each and
+the expected cost.
+
+## Tests
+
+```powershell
+node test\redact.test.mjs     #  8 — redaction rules
+node test\bridge.test.mjs     #  8 — wire protocol, token, liveness
+node test\artifacts.test.mjs  #  5 — bundle layout and large-body spill
+node test\plugin.test.mjs     #  2 — tool registration and the full tool path
+node test\e2e.mjs             # 31 — real Chrome through the wire protocol
+node test\tools-chrome.mjs    # 19 — real Chrome through the tools
+```
+
+`e2e.mjs` and `tools-chrome.mjs` launch a throwaway Chrome, load the extension with
+`Extensions.loadUnpacked`, and exercise capture, trusted input, the virtual cursor, upload, injection
+and screenshots against a local page with a working BFF endpoint.
+
+## Repository layout
+
+```
+lib/            DSH plugin: tools, bridge, redaction, artifact writer
+extension/      MV3: service worker (CDP), popup, icons, locales
+docs/           protocol, limitations, detailed guide
+scripts/        install.ps1
+tools/          icon rasteriser, popup/icon previews, asar reader (dev only)
+test/           unit, integration, end-to-end
+```
+
+
+
+MIT — see [LICENSE](LICENSE).
+
+## Versioning
+
+The version lives in `package.json` and is mirrored into `extension/manifest.json`; `CHANGELOG.md`
+holds the history. Every commit that changes shipped code bumps the version, docs-only commits do not:
+
+```powershell
+node tools\version.mjs check                  # fail if the three files disagree
+node tools\version.mjs bump minor             # bump package.json + manifest.json + CHANGELOG stub
+```
+
+Releases are tagged `vX.Y.Z`. Versions below 0.3.0 were assigned retroactively from the commit
+history, so an old tag may pin commit content that still carried the 0.1.0 stamp.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/README.ru.md

@@ -0,0 +1,241 @@
+# dsh-site-bridge
+
+[English](README.md) · **Русский** · [中文](README.zh-CN.md)
+
+**Глаза и руки [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) в вашем браузере.**
+Снимает разметку страницы и её BFF-трафик в файлы, понятные агенту, управляет страницей доверенным
+вводом и проверяет расширение, которое вы только что написали, — сразу в той же вкладке.
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Две половины, один мост:
+
+| Половина | Что делает |
+|---|---|
+| **Плагин DSH** (`lib/`) | Держит loopback-мост и даёт модели восемь инструментов. Пишет пакет снимка в рабочее пространство сессии. |
+| **Расширение MV3** (`extension/`) | Живёт в вашем профиле Chrome/Edge, работает с вашими куками, снимает разметку и сеть через CDP, управляет страницей настоящими событиями ввода. Локализовано: English, Русский, 中文. |
+
+По отдельности ни одна половина не решает задачу: плагин держит модель и файлы, расширение — сессию
+браузера и точность.
+
+---
+
+## Зачем
+
+Писать расширение, которое встраивается в чужой сайт, — это в основном археология: из чего на самом
+деле сделана разметка, какой селектор переживёт следующий деплой и какой BFF-эндпоинт вызывает эта
+кнопка и с каким телом. Вручную это DevTools, копипаст и догадки.
+
+Проект превращает археологию в снимок:
+
+```
+site_capture → captures/<host>/<timestamp>/
+  dom.html          сериализованная разметка снятой области
+  dom.json          дерево элементов: боксы, атрибуты, кандидаты селекторов
+  styles.json       computed-стили ключевых узлов + CSS-переменные темы
+  selectors.md      шорт-лист устойчивых селекторов с объяснением, почему они устойчивы
+  network.jsonl     каждый снятый xhr/fetch, один JSON на строку
+  api.md            эндпоинты, сгруппированные по method+path, с контрактами запроса/ответа
+  screenshot.png    опциональный рендер всей страницы
+```
+
+Агент читает эти файлы как обычный исходник и пишет расширение. Затем `site_inject` выполняет этот
+код в живой странице, и «должно работать» превращается в «работает здесь».
+
+## Возможности
+
+- **Разметка** — дерево элементов с боксами и видимостью, computed-стили интерактивных узлов,
+  CSS-переменные темы и кандидаты селекторов по устойчивости (`data-testid` > `id` > `name` >
+  `aria-label` > путь по классам > позиционный путь), каждый проверен на уникальность по живому DOM.
+- **BFF-трафик** — `xhr`/`fetch` с методом, статусом, заголовками запроса, телом запроса,
+  заголовками ответа и телом ответа, только для проверяемого сайта.
+- **Доверенный ввод** — клики, ввод, select, клавиши, прокрутка и загрузка файлов через CDP
+  `Input.*` / `DOM.setFileInputFiles`: события, которые страница не отличает от действий человека.
+- **Виртуальный курсор** — DOM-оверлей, который едет к цели, плюс настоящее событие мыши в этих
+  координатах — для контролов, игнорирующих программный `click()`.
+- **Глубокие селекторы** — `host >>> inner` проходит сквозь открытые shadow-корни и same-origin
+  iframe; координаты клика пересчитываются с учётом смещения фрейма.
+- **Работает в фоновых вкладках** — чтение, клики, ввод и скриншоты работают, когда вкладка не в
+  фокусе (Chrome тротлит там только таймеры и анимации).
+- **Ничего не хранится из авторизации** — см. [Безопасность](#безопасность).
+
+### Чем это отличается от плагинов автоматизации браузера
+
+Есть плагины, которые дают агенту инструменты `browser_*`: навигация, клик, ввод, чтение страницы.
+Это не один из них, хотя всё перечисленное умеет: ввод здесь — инструмент проверки снимка, а не
+продукт.
+
+Продукт — снимок: DOM с боксами и computed-стилями, CSS-переменные темы, кандидаты селекторов с
+проверкой уникальности и собственные xhr/fetch сайта с заголовками и телами, разложенные по файлам,
+которые агент читает. Автоматизация нужна, чтобы «этот селектор работает» и «этот вызов BFF проходит
+с моими куками» проверялись на живой странице, а не предполагались.
+
+Практическое следствие: для обычного браузинга специализированный плагин автоматизации даст больше
+инструментов, и это нормально — он решает другую задачу. Для написания расширения, встраивающегося в
+конкретный сайт, нужен снимок, а ввод идёт в комплекте.
+
+## Требования
+
+- DeepSeek Harness с CLI `dsh` и профилем (Desktop или Web).
+- Chrome или Edge 125+ (расширение использует `chrome.debugger` и MV3 service worker).
+- Node.js 22+ для инструментов в `tools/` и для тестов.
+
+## Установка
+
+### 1. Host-половина
+
+```powershell
+dsh plugin --profile desktop add dsh-site-bridge
+```
+
+Это ставит опубликованный пакет. Из локального клона вместо этого:
+
+```powershell
+# из корня репозитория
+powershell -NoProfile -ExecutionPolicy Bypass -File scripts\install.ps1
+```
+
+Скрипт линкует плагин в ваш профиль, добавляет его в `dsh.profile.bundles` и раскладывает расширение
+в `%USERPROFILE%\.dsh\site-bridge\extension`. Вручную то же самое:
+
+```powershell
+dsh plugin --profile desktop add <путь-к-этому-репозиторию>
+```
+
+Если CLI не сделал этого сам, добавьте `"dsh-site-bridge"` в `dsh.profile.bundles` в
+`%USERPROFILE%\.dsh\profiles\desktop\package.json`, затем перезапустите DSH — host-половина
+загружается при старте профиля.
+
+### 2. Браузерная половина
+
+1. `chrome://extensions` → включите **Режим разработчика** → **Загрузить распакованное** →
+   `%USERPROFILE%\.dsh\site-bridge\extension`.
+2. Откройте попап. Он покажет порт и путь к `bridge.json` (то же печатает `site_status`).
+3. Нажмите **Импорт bridge.json** и выберите этот файл — или вставьте токен: он сохранится сам,
+   кнопки нет.
+4. Откройте нужную страницу и нажмите **Подключить эту вкладку**.
+
+Chrome покажет плашку «началась отладка этого браузера»: это и есть CDP-сессия, на которой всё
+работает. Она исчезнет после **Отключить**.
+
+Интерфейс попапа следует языку браузера: английский, русский и упрощённый китайский лежат в
+`extension/_locales`.
+
+## Использование
+
+```text
+site_status                     → состояние моста, путь к токену, текущая вкладка
+site_tabs {action:"list"}       → вкладки; {action:"claim", tabId} привязывает одну
+site_network {action:"start"}   → начать запись, затем действуйте на странице
+site_capture {screenshot:true}  → записать пакет в рабочее пространство
+site_act {steps:"[...]"}        → click/fill/type/select/press/scroll/upload/wait/eval
+site_cursor {x,y,click:true}    → виртуальный курсор, настоящее событие мыши
+site_shot {fullPage:true}       → скриншот в captures/shots/*.png
+site_inject {js:"..."}          → выполнить ваш скрипт в странице для проверки
+```
+
+Типичный цикл написания встраиваемого расширения:
+
+1. `site_tabs` → привязать страницу.
+2. `site_capture` → прочитать `selectors.md`, `styles.json`, `api.md`.
+3. Написать userscript / content script в своём репозитории.
+4. `site_inject` с телом скрипта → проверить, что якорь найден и вызов BFF проходит с куками
+   браузера.
+5. Доработать селекторы, которые снимок пометил как хрупкие.
+
+## Архитектура
+
+```
+┌──────────────────────────── DSH host ────────────────────────────┐
+│  инструменты (site_*) ──► мост: 127.0.0.1, токен, очередь long-poll│
+│  редакция на приёме ──► буфер в памяти ──► запись артефактов       │
+└───────────────────────────────┬───────────────────────────────────┘
+                                │ HTTP long-poll (без websocket)
+┌───────────────────────────────┴───────────────────────────────────┐
+│  MV3 service worker: chrome.debugger ──► CDP                        │
+│    Network domain  → запросы с заголовками и телами                │
+│    Input domain    → доверенные мышь/клавиатура, загрузка файлов   │
+│    Runtime domain  → снимок DOM, селекторы, внедрённые скрипты     │
+│  popup: подключение, вкладка, запись (ru / en / zh)                │
+└────────────────────────────────────────────────────────────────────┘
+```
+
+Протокол небольшой и описан в [docs/protocol.md](docs/protocol.md).
+
+## Безопасность
+
+- **Авторизация не покидает браузер.** Расширение не читает куки и токены: запросы делает сама
+  страница, браузер прикладывает их. Мост видит их в полёте, но значения `cookie`, `authorization`,
+  `x-csrf-token`, `x-api-key`, `set-cookie` и подобных заголовков, credential-подобные query-параметры
+  и поля JSON/форм заменяются на `«redacted»` **на приёме** — до того, как что-то сохранено.
+- **На диск не попадает ничего авторизационного.** Имена заголовков сохраняются, потому что «этому
+  эндпоинту нужен `x-csrf-token`» — часть контракта; значения — нет.
+- **Захват ограничен сайтом.** Пишутся только свои `xhr`/`fetch` проверяемого сайта (тот же хост, тот
+  же домен второго уровня или сторонний JSON). Телеметрия и агенты безопасности, которые отправляют
+  дамп HTML страницы на свой сервер, отфильтровываются — иначе исходник с инлайн-токенами попадал бы
+  в пакет.
+- **Только loopback.** Мост слушает `127.0.0.1` и отклоняет любой запрос без 32-байтного токена
+  сопряжения. `site_status` печатает путь к файлу с токеном, а не сам токен.
+- **Остаточный риск.** Значения заголовков и тела всё равно проходят через процесс DSH в памяти. Если
+  сайт кладёт секрет под нестандартным ключом, редакция его не узнает. Считайте пакет снимка
+  чувствительным, как и любой дамп трафика.
+
+### Позиция по доверию
+
+Это осознанный трейд-офф, а не заявка на превосходство. Мост требует токен, а расширение просит
+`debugger` вместо `<all_urls>`: теряется удобство — шаг сопряжения и плашка отладки Chrome — и
+уменьшается радиус поражения. Плагины, которые обходятся без токена или берут права на все сайты, не
+делают что-то неправильно; они оптимизируют другое.
+
+## Ограничения
+
+Кросс-доменные iframe, закрытые shadow-корни и лимиты тела разобраны в
+[docs/limitations.md](docs/limitations.md) — с точным местом в коде, планом снятия каждого и оценкой
+стоимости.
+
+## Тесты
+
+```powershell
+node test\redact.test.mjs     #  8 — правила редакции
+node test\bridge.test.mjs     #  8 — протокол, токен, живость
+node test\artifacts.test.mjs  #  5 — раскладка пакета и вынос больших тел
+node test\plugin.test.mjs     #  2 — регистрация инструментов и сквозной путь
+node test\e2e.mjs             # 31 — реальный Chrome через протокол
+node test\tools-chrome.mjs    # 19 — реальный Chrome через инструменты
+```
+
+`e2e.mjs` и `tools-chrome.mjs` поднимают одноразовый Chrome, загружают расширение через
+`Extensions.loadUnpacked` и проверяют захват, доверенный ввод, виртуальный курсор, загрузку файла,
+инъекцию и скриншоты на локальной странице с рабочим BFF-эндпоинтом.
+
+## Структура репозитория
+
+```
+lib/            плагин DSH: инструменты, мост, редакция, запись артефактов
+extension/      MV3: service worker (CDP), popup, иконки, локали
+docs/           протокол, ограничения, подробное руководство
+scripts/        install.ps1
+tools/          растеризация иконок, превью попапа/иконок, чтение asar (только для разработки)
+test/           юнит, интеграционные, end-to-end
+```
+
+
+
+MIT — см. [LICENSE](LICENSE).
+
+## Версионирование
+
+Версия живёт в `package.json` и зеркалится в `extension/manifest.json`; история — в `CHANGELOG.md`.
+Каждый коммит, меняющий поставляемый код, поднимает версию; коммиты только с документацией — нет:
+
+```powershell
+node tools\version.mjs check                  # упадёт, если три файла расходятся
+node tools\version.mjs bump minor             # поднимет package.json + manifest.json + заготовку в CHANGELOG
+```
+
+Релизы помечаются тегами `vX.Y.Z`. Версии ниже 0.3.0 проставлены задним числом по истории коммитов,
+поэтому старый тег может указывать на содержимое, где ещё стояла 0.1.0.
+
+## Лицензия
+
+MIT — см. [LICENSE](LICENSE).