Разработка
Сверено с выпуском 0.36.0 и кодом
main2f45d8d9a, 14.11.2026.
Единственное место для стека, команд, дерева кода, хранилищ, тестов, сборки и порядка выпуска (решение 0044: один вопрос — одно место). README, CONTRIBUTING и CLAUDE.md ссылаются сюда, а не повторяют. Правила работы — CONTRIBUTING.md, договорённости — CLAUDE.md.
Стек
Electron 44 · electron-vite 5 · React 19 · zustand 5 · TypeScript strict · vitest · Node 24, npm.
Вёрстка — обычный CSS с токенами в oklch, без UI-библиотек (цветовая система —
design/colors.md). Внешние агенты подключаются по
ACP (@agentclientprotocol/*), встроенный — своим клиентом к OpenAI-совместимому API.
Хранилища главного процесса — JSON-файлы в userData и SQLite через встроенный node:sqlite
(без нативных модулей), см. «Хранилища» ниже. Терминал — node-pty в отдельном процессе и
xterm.js в окне (docs/terminal/). Версии всего стека — versions.md.
Команды
npm ci
node -e "require('electron')" # Electron 44 качает бинарник при первом require, иначе pack падает на «Electron uninstall»
npm run dev # окно с горячей перезагрузкой
npm run typecheck # tsc по четырём конфигам: node, web, mobile, swarm
npm run lint # ESLint по src, packages, apps (входит в checks:full)
npm test # vitest; число тестов зависит от платформы, последний выпуск — в CHANGELOG.md
npm run check:budget # пороги времени (*.budget.test.ts) — не в npm test, а ночью и в check:release
npm run build # electron-vite build → out/ + мобильный бандл
npm run pack # DMG: dist/Pulse-<version>-arm64.dmg (pack:mac-intel / pack:win / pack:linux — остальные)
npm run smoke # smoke-тест графа и слияния ACP-событий
npm run rules:check # правила репозитория: битые ссылки, сироты, карта документов, версии, типы Diátaxis
npm run modules:versions # версии модулей от последнего тега: файлов изменено → была → стала → вердикт (-- --check — код 1; решение 0042)
npm run checks:full # всё, что гоняет полный конвейер, одной командой — перед пушем
npm run impeccable -- ratchet # храповик качества интерфейса (решение 0047)
npm run glossary -- find <слово> # глоссарий: как Pulse называет вещи
Терминал и агент доказывают качество уровнями check:fast / check:terminal / check:e2e:terminal /
check:release (контракт качества).
Облако и сайт — свои lock-файлы: npm ci --prefix cloud, npm ci --prefix site; проверки npm run typecheck --prefix cloud,
npm test --prefix cloud, npm run build --prefix cloud, npm run build --prefix site, node site/tools/mobile.mjs,
npx --prefix site playwright install chromium, npm test --prefix site (последняя поднимает временное облако и сайт на
loopback-портах 44100/44173, проверяет вход, обновление токенов между вкладками, доступность и ссылки, затем всё удаляет;
рабочий сервер не затрагивается).
Из-под другого Electron-процесса окно запускается со снятой переменной; отдельный профиль данных не трогает ваш рабочий:
env -u ELECTRON_RUN_AS_NODE npm start
env -u ELECTRON_RUN_AS_NODE npx electron . --user-data-dir=/tmp/pulse-test
Структура
src/main/ Electron main: IPC (ipc.ts), живые сессии агентов, git, транскрипты, настройки, журнал
db.ts SQLite приложения: открытие базы, WAL, миграции (node:sqlite)
terminal/ менеджер сессий, транспорты (свой процесс pty-host.cjs, демон, SSH), разбор блоков,
запуск команд агентов (run.ts), история команд (history.ts — SQLite)
tasks/ свои задачи: хранилище taskDb.ts (SQLite), доска, синхронизация с трекерами
agents/ реестр агентов, ACP-сессия, встроенный API-агент, хуки CLI, песочница
git/ движок Git окна, отдельный процесс git-host.cjs, журнал операций oplog.ts (SQLite)
swarm/ рой: координатор, worktree участников и слияние, учёт и журнал запусков (swarm-v2.sqlite)
schedules/ автоматизации: расписания и их запуск (runner.ts)
integrations/ трекеры и хостинги: GitLab, GitHub, Bitbucket, Azure DevOps, YouTrack, Яндекс Трекер, Linear…
cloud/ вход, лицензия, обновления по ленте, синхронизация настроек и истории
gateway/ сопряжение Pulse Mobile по QR, ключи машины, снимок графа для телефона
remote/ SSH: проверка хоста, клон, исполнитель (кладёт src/remote-worker на хост)
files/, lsp/, notes/ файлы и поиск в рабочем потоке, языковые серверы, заметки
mcp/ клиент stdio для внешних MCP-серверов
memory/ память репозитория и карта кода
ai/, models/, voice/ AI-сервис приложения (имена задач, сообщения коммитов), точки подключения моделей, расшифровка речи
src/shared/ чистая логика и типы для четырёх процессов (граф, сводки, политики, бюджеты,
контекст, версии инструкций, отчёты) — покрыта тестами
src/renderer/ React: доска, граф, транскрипт, дифф, терминал, настройки
src/preload/ мост IPC (window.pulse)
src/mobile/ Pulse Mobile — мобильное приложение (снято из работы до готового десктопа, слово владельца 21.10.2026; возврат — 0.50 по 0056, номер — дорожная карта)
src/remote-worker/ исполнитель на удалённом POSIX-хосте по SSH, без Electron и зависимостей
src/shared-ui/ компоненты, общие для окна и Pulse Mobile
cloud/ Pulse Cloud: вход, кабинет, лицензии, лента обновлений, ретранслятор, отчёты (Fastify + SQLite)
site/ сайт pulse.avacloude.ru (статика, свой билдер)
library/ каталог скиллов и ролей
mcp/ MCP-сервер Pulse для внешних агентов (.cjs и команда pulse; своего package.json нет)
android/, ios/ обёртки Capacitor для Pulse Mobile
packages/, apps/, services/ рой 24/7 — частично заготовка, в продукт не подключён (README пакетов)
scripts/ сборка, подпись, скриншоты, стенд e2e, вспомогательные скрипты
Правила кода: комментарии по-русски и по делу (зачем, а не что), файлы до ~800 строк,
никакой мутации общих структур, вся чистая логика — в shared/ с тестами (.claude/rules/shared.md,
main-process.md, ui.md). Контейнеры и их связи — architecture.md; устройство каждой части,
границы и контракты — документ модуля (modules/).
Хранилища
Два вида, и выбор между ними — по форме данных, а не по вкусу:
| Вид | Чем | Для чего |
|---|---|---|
| JSON-снимок | persistence.ts: writeJsonAtomic (запись во временный файл, .bak прошлой версии, rename) и readJsonRecover |
состояние, которое читается целиком и меняется редко; файл переписывается весь при каждом изменении |
| SQLite | db.ts: openAppDatabase(file, migrations) — встроенный node:sqlite (Electron 44, DatabaseSync, есть FTS5), WAL, таблица migrations с идентификаторами |
журналы, которые растут по строке на событие и читаются выборкой: переписывать весь файл ради одной строки нельзя |
Правила для каждой базы: свой файл в userData (в репозиторий и worktree — никогда),
миграции списком и только вперёд, всё, что может содержать секреты, — под safeStorage
как в secrets.ts, с честным флагом «без шифрования», где связки ключей нет. Нативные
SQLite-модули (better-sqlite3) в приложение не берутся: npmRebuild: false, под ABI
Electron они не пересобираются; better-sqlite3 живёт только в cloud/.
Общей базы журналов pulse.db из решения 0054 в коде ещё нет — журналы лежат в базах ниже (сверка 13.11, решение
0054, «Дополнение 13.11.2026»).
Все хранилища в userData (SQLite — 4, JSON-снимок — 29, папка — 2; реестр — src/shared/storageRegistry.ts, тест сверяет его с кодом):
| Файл | Вид | Что лежит | Код (src/main/) |
Модуль |
|---|---|---|---|---|
pulse-tasks.db |
SQLite | свои задачи: проекты задач, номера KEY-N, состояния (решение 0034) | store.ts, tasks/taskDb.ts |
tasks |
pulse-terminal-history.db |
SQLite | история команд терминала | terminal/history.ts |
terminal |
git-oplog.sqlite |
SQLite | журнал операций Git для отмены | git/oplog.ts |
git |
swarm-v2.sqlite |
SQLite | состояние роя и журнал запусков (миграции runs_*, решение 0063) |
ipc.ts, swarm/runtimeStore.ts, swarm/runStore.ts |
swarm |
pulse-settings.json |
JSON-снимок | настройки приложения | settings.ts, index.ts, windowChrome.ts |
settings |
secrets.json |
JSON-снимок | ключи и токены под safeStorage (флаг «без шифрования», где связки ключей нет) |
secrets.ts |
settings |
pulse-sessions.json |
JSON-снимок | сессии агентов | sessions/sessionStore.ts |
agents |
pulse-tasks.json |
JSON-снимок | задачи, у которых есть Worktree | store.ts, runner/snapshot.ts, tasks/migrate0034.ts |
tasks |
pulse-workspaces.json |
JSON-снимок | рабочие области | workspaces.ts, store.ts |
projects |
pulse-project-identities.json |
JSON-снимок | опознание проектов по репозиторию | ipc.ts |
projects |
pulse-windows.json |
JSON-снимок | состояние окон | windowManager.ts |
shell |
pulse-notices.json |
JSON-снимок | уведомления колокольчика | notices.ts |
shell |
pulse-notices-dismissed.json |
JSON-снимок | что человек убрал из колокольчика | notices.ts |
shell |
pulse-startup-check.json |
JSON-снимок | отметка полной проверки при запуске | notices.ts |
shell |
pulse-activity.json |
JSON-снимок | лента активности | activity.ts, runner/snapshot.ts |
overview |
pulse-runner.json |
JSON-снимок | работа без окна: что продолжать после закрытия | runner/windowlessHost.ts |
core |
pulse-schedules.json |
JSON-снимок | автоматизации (расписания) | schedules/store.ts |
tasks |
pulse-requests.json |
JSON-снимок | реестр запросов с квитанциями и исходом | requests/registry.ts |
tasks |
pulse-reviews.json |
JSON-снимок | ревью: замечания и пакеты автору | review/store.ts |
tasks |
pulse-quality.json |
JSON-снимок | оценки инспекторов качества | quality/store.ts |
agents |
pulse-memory-projects.json |
JSON-снимок | память репозитория: какие проекты | memory/repoMemory.ts |
agents |
pulse-memory-repo-file.json |
JSON-снимок | согласия на файл памяти в репозитории | memory/repoMemoryFile.ts |
agents |
pulse-memory-sharing.json |
JSON-снимок | общая память команды | memory/teamMemory.ts |
team |
pulse-skill-ratings.json |
JSON-снимок | оценки skills библиотеки | libraryRatings.ts |
hub |
pulse-user-skills.json |
JSON-снимок | свои skills | libraryUserSkills.ts |
hub |
pulse-org.json |
JSON-снимок | подписанный файл организации: офлайн-лицензия и политики | orgBundle.ts |
cloud |
pulse-project-bindings.json |
JSON-снимок | привязки проектов к командным | team/teamIpc.ts |
team |
pulse-project-removals.json |
JSON-снимок | намерения снять карточку проекта до ответа сервера | team/teamIpc.ts |
team |
pulse-team-snapshot.json |
JSON-снимок | снимок командного проекта | team/teamIpc.ts |
team |
pulse-team-outbox.json |
JSON-снимок | исходящие команды | team/teamIpc.ts |
team |
pulse-parcel-outbox.json |
JSON-снимок | исходящие посылки | team/cloudParcels.ts |
team |
pulse-parcel-declined.json |
JSON-снимок | отклонённые посылки | team/cloudParcels.ts |
team |
pulse-parcel-notified.json |
JSON-снимок | о каких посылках уже сказали | team/cloudParcels.ts |
team |
metrics/ |
папка | расход и метрики: файл на задачу | metrics/ledger.ts |
overview |
memory/ |
папка | память репозитория <ключ>.md |
memory/repoMemory.ts |
agents |
Кандидаты на перевод в SQLite, если JSON станет тесен: лента активности (pulse-activity.json растёт без предела),
транскрипты сессий (сейчас JSONL с чтением страницами), метрики времени и расходов. Где лежат данные человека
(«Папка Pulse» ~/Pulse) и что остаётся во внутренней папке — решение 0054.
Области репозитория
Дерево выше — для человека. Для агента та же структура записана машинно: карта областей
в src/shared/areas.ts. Из неё собирается корневой CODEOWNERS, из неё же берутся имена
меток area:*, и по ней область правки считается по путям, а не угадывается по названию ветки.
ветки. Разбор организаций warpdotdev и unslothai (план доработки 22.09, снят 05.11) показал, что
контекст агенту экономит не граница между репозиториями, а карта внутри одного.
| Область | Что это | Пути | Владелец |
|---|---|---|---|
core |
общая логика и типы для четырёх процессов | src/shared/ |
владелец |
app-main |
главный процесс и мост IPC | src/main/, src/preload/ |
владелец |
app-ui |
окно приложения | src/renderer/ |
владелец |
mobile |
Pulse Mobile (веб-сборка) и обёртка Android | src/mobile/, android/, capacitor.config.ts |
владелец |
cloud |
сервер: вход, лицензии, обновления, отчёты | cloud/ |
владелец |
site |
сайт и его проверки | site/ |
владелец |
library |
каталог скиллов, ролей и блоков интерфейса | library/ |
владелец |
mcp |
MCP-сервер Pulse для внешних агентов | mcp/ |
владелец |
build |
сборка, подпись, установщики, корневая конфигурация | scripts/, build/, resources/, корень |
владелец |
qa |
сквозные прогоны и скиллы агента | scripts/e2e/, .claude/ |
владелец |
ci |
конвейер GitLab (и отключённые workflow GitHub) | .github/, .gitlab-ci.yml |
владелец |
docs |
документация, README, CHANGELOG | docs/, корневые *.md |
владелец |
swarm |
рой 24/7: оркестратор, исполнители, память; apps/pulse-server пока не подключён (см. его README) |
packages/, apps/, services/ |
владелец |
Границы не выдуманы. Каждая область названа модулями docs/codemap/codemap.json —
теми, что посчитаны по коду. src/shared/areas.test.ts проверяет обе стороны: область
без модуля — выдумка, модуль без области — дыра, и то и другое красит тест. Поэтому новый
каталог верхнего уровня нельзя завести молча: он останется без области, и это будет видно.
Все области за владельцем: QA_OWNER в src/shared/areas.ts — тоже @avigdorsky (модули и области ведёт он сам,
слово 20.10.2026). Области репозитория — карта кода; модули продукта — другое деление (modules/).
CODEOWNERS
Лежит в корне (GitLab ищет CODEOWNERS в корне, docs/ и .gitlab/), собирается из карты и руками не правится:
node --experimental-transform-types --import ./scripts/ts-loader.mjs scripts/labels/codeowners.mjs
node --experimental-transform-types --import ./scripts/ts-loader.mjs scripts/labels/codeowners.mjs --check
Служит картой репозитория для человека и агента; ничего не блокирует и ревью не просит: на нашем GitLab (редакция Free)
владельцы кода — возможность платных тарифов, main защищён только от push --force и от пуша ниже роли Developer.
Включать ли защиту — решение владельца (03.11.2026: «не перебезопашиваться», CLAUDE.md, «Безопасность»), а не
следствие появления файла. @-имена совпадают с учётками GitLab (NameLucky2205, avigdorsky).
Метки областей
Метки area:* называются по областям один в один, их тринадцать, цвет у всех один. Какие подходят MR, считает скрипт по
путям правки; заводит их он же, по умолчанию только печатает план (--apply — создать), чужие метки перечисляет и не
трогает; метки agent:* описаны, но не заводятся — агента, который их ставит, нет:
GITLAB_TOKEN=… node --experimental-transform-types --import ./scripts/ts-loader.mjs scripts/labels/sync.mjs areas --pr=<MR>
GITLAB_TOKEN=… … scripts/labels/sync.mjs labels [--apply]
Метки module:* ставит scripts/gitlab/mr-create.py; статусы, приоритеты, размеры, выпуски и доски — tracker.md.
выходит; создаёт только с --apply:
GITLAB_TOKEN=… … scripts/labels/sync.mjs labels # план
GITLAB_TOKEN=… … scripts/labels/sync.mjs labels --apply # завести
GH_TOKEN=$(gh auth token) … scripts/labels/sync.mjs labels --host=github # зеркало GitHub
Метки status: …, priority: … и size: … (доска «Задачи», см. docs/tracker.md) в карту
областей не входят: скрипт перечисляет их как чужие и не трогает.
Удалять метки скрипт не умеет намеренно: на хостинге уже лежат pilot, blocked,
promised от прошлой волны, карта про них не знает, и снести чужую разметку заодно —
потеря, а не уборка. Чужие метки он только перечисляет.
Агентские метки (agent:reviewed, agent:stale-rebase, agent:duplicate,
agent:draft, agent:blocked) в карте описаны, но помечены неготовыми и по умолчанию не
заводятся. Причина одна и она важнее удобства: агента, который их проставляет, ещё нет —
это этапы 1–3 плана доработки 22.09 (снят 05.11). Заведённая заранее agent:reviewed означала бы «ревью
агентом бывает», а его не бывает. Завести их всё равно можно флагом --all, и скрипт
скажет, кого не хватает.
Ритм
Недельная веха вида «2026 неделя 39 (21–25 сентября)» — ритм Warp: неделя с датами, без закрытия. Скрипт умеет их считать и заводить, но по умолчанию только показывает план:
GITLAB_TOKEN=… … scripts/labels/sync.mjs milestones --weeks=4
Заводить их сейчас не за что, и скрипт говорит это вслух. В трекере уже десять выпусков
по версиям (0.31 — выпуск не расходится … 1.0 — есть что продать; перенесены с GitHub в
GitLab 24.09.2026), и задачи раскладываются по ним. Веха у задачи одна, поэтому недельные
вехи не добавятся к версионным, а поспорят с ними: придётся держать в голове правило, какую
ставить. Ритм имеет смысл заводить вместе с агентом этапа 2, который начнёт раскладывать
план по неделям, — и тогда же выбрать один из двух.
Скиллы агента
Сессии Claude Code и меню «/» в композере Pulse читают одни и те же файлы — .claude/skills/<имя>/SKILL.md (формат
Agent Skills: name равен имени папки, description говорит, что скилл делает и когда его читать, тело не длиннее
500 строк; проверяет src/shared/repoSkills.test.ts). Список скиллов, команд и субагентов — claude-code.md;
скиллы из открытых наборов — .claude/skills/vendor/ с закреплённым коммитом и sha256 (.claude/vendor.lock.json,
лицензии). Правило для новых скиллов — ловушка, а не карта: скилл записывает
то, на что сессии наступали дважды, и ссылается на файл, который делает утверждение верным; описание кода устаревает
первым — его место в docs/, не в скилле.
Интерфейс — по дизайн-системе
Любая правка в src/renderer, src/mobile, site/styles — по Pulse DS (design/README.md; компонент
из components/ui/, цвет — токен, отступ и радиус — --sp-*/--r-*, значки — свой набор); перед правкой вида —
/impeccable, перед MR — npm run impeccable -- ratchet (решение 0047). Стражи в npm test
(cssVars, cssDebt, dsCodemod) валят отступление; починка — node scripts/ds-codemod.mjs <файл>. Полные правила и как
развивать систему — скилл .claude/skills/pulse-ds.
(critique/audit), перед MR — npm run impeccable -- ratchet (решение 0047). Нет компонента — сначала гид в docs/design/system/components/, потом компонент, потом
использование. Стражи в npm test (cssVars, cssDebt, dsCodemod) валят отступление; починка —
node scripts/ds-codemod.mjs <файл>. Полные правила и как развивать систему — скилл .claude/skills/pulse-ds.
Тесты
- Юнит и интеграция —
vitestрядом с кодом (*.test.ts); тесты не запускают настоящие CLI и не ходят в сеть; git в тестах — с личностью внутри тестового репозитория (на раннере её нет) —.claude/rules/shared.md. - Сквозной прогон
npm run e2e(послеnpm run build) — настоящее приложение изout/с отдельным профилем, локальным облаком изcloud/и поддельным OpenAI-совместимым сервером модели; без экрана сам перезапускается под Xvfb (заданиеe2eв GitLab ручное). Скрипты —scripts/e2e/, снимки и журнал —PULSE_E2E_OUTPUT,PULSE_E2E_VERBOSE=1печатает журнал по ходу; Playwright — изsite/node_modules; граница чтения агента на стенде выключена (launchApp()ставитPULSE_AGENT_READ_BOUNDARY=0; CLAUDE.md, «Стенд и граница чтения агента»). Состав сценариев — один списокscripts/e2e/scenarios.json(его исполняетscripts/e2e/suite.mjs:npm run e2e— вся цепочка, заданиеe2e— сценарии сci: true; стражsrc/shared/e2eScenarios.test.ts), как запускать и писать — скилл.claude/skills/e2e, что покрыто — qa/README.md. Настоящих учётных данных прогону не нужно и класть их туда нельзя. - Живые прогоны (рой, политики, MCP, песочница) — сценарии на Playwright + Electron в scratchpad-папке сессии с отдельным профилем и мок-сервером модели. Снимки для README и документов — screenshots/README.md.
- Перед выпуском:
npm run typecheck && npm test && npm run build.
Проверки
Проверки идут в GitLab на своём раннере (.gitlab-ci.yml); GitHub — только зеркало кода, его workflow в .github/
лежат, но Actions отключены. Раннер один на всех, поэтому режимы разные (договорённость 22.10.2026, CLAUDE.md):
- MR — лёгкий набор: правила репозитория, typecheck, vitest; что именно — решает карта путей
src/shared/testImpact.ts(таблица «Вид правки → что гоняется» ниже); MR из одних документов — послеrules:check(фильтр путейsrc/shared/ciPaths.ts). - Вливание в
main— только правила репозитория. - Полный набор (lint, сборка, дымовые, evals, «интерфейс linux») — ночью по расписанию № 2 (03:13 по Якутску), на
кандидате с
INSTALLERS=1и по кнопке или API сFULL_CHECKS=1.
Поэтому пуш — по коду выхода npm run checks:full после догона main: поломку, которую ловит только сборка,
иначе увидит ночной прогон, а не MR. Ветке, где выбор карты не полный (одни документы, только текст и статика сайта,
только тексты и CSS окна), хватает npm run checks:changed: он гоняет то же, что раннер, и ставит отметку, которую
принимает хук пуша; на ветке с кодом он сам запускает checks:full.
Кэши раннера (задача 2124, порция 4; журнал). Общий кэш шаблона .node —
.npm, .cache/electron, .cache/electron-builder, .cache/ms-playwright, ключ постоянный, рост держит
scripts/ci/cache-limit.sh. Бинарник Electron попадает в .cache/electron только через electron_config_cache (его
читает загрузчик Electron 44; ELECTRON_CACHE — только electron-builder). У «приложения» второй кэш — .cache/tsc:
npm run typecheck идёт с --incremental, ключ по ветке, запасной — основная ветка; tsc сверяет хэши файлов, поэтому
чужой или устаревший кэш даёт только перепроверку, а не пропуск ошибки. Библиотеки Electron (GTK, NSS, mesa) «приложение»
ставит только в полном режиме — vitest бинарник Electron не запускает. Первая строка каждого задания .node — ядра,
память и пределы cgroup (scripts/ci/runner-resources.sh): по ней решается число потоков vitest (сейчас по умолчанию
vitest — ядра − 1).
Контекст каждой сессии (задача 2128). Правка одного CLAUDE.md и памяти субагента vitest не будит, поэтому их стражи
идут в rules:check (scripts/docs/claude-md-check.mjs, логика — src/shared/claudeMd.ts): храповик байт CLAUDE.md и
описаний Skills и агентов (docs/.claude-md-budget, только вниз), форма пункта договорённости (дата, кто, не больше 4
строк и 700 байт, ссылка «где подробно»), дубли заголовков, запрет «[Заменена…]», память .claude/agent-memory/*/MEMORY.md
не больше 200 строк и 25 КБ, номер выпуска руками в README.md и docs/README.md вне блоков генератора. Пункт «Свежего»
старше 7 дней — предупреждение, старше 14 — красный; на воротах выпуска (recheck.mjs зовёт скрипт с --release) —
красный с 8-го дня. Сколько всего грузится в сессию — раздел «Контекст сессии» в Версиях всего.
Вид правки → что гоняется
Карта src/shared/testImpact.ts (задача 2124; исследование —
research/2026-11-14-runner/README.md) — одна для раннера (scripts/ci/test-impact.mjs)
и для npm run checks:changed. Правило одно: выбор не пропускает регрессию — любая неясность (нет базы, путь
неизвестен карте, ошибка) даёт полный набор. «Правила» идут всегда. Ночь, сборка и FULL_CHECKS=1 гоняют всё, как раньше.
| Вид правки | Было в MR | Стало в MR |
|---|---|---|
| Документы, которых не читают тесты | «правила» | то же |
Текст и статика сайта (site/src/pages, site/src/en, site/src/strings, site/src/data, site/src/partials, site/assets, site/styles, site/docs, собранные site/*.html) |
«приложение»: typecheck ×4, весь vitest (1 686 файлов), проверки сайта без браузера | «проверки сайта»: проверки сайта, сборка сайта, vitest — читатели site/ (около 30 файлов, vitest related) и тесты, сканирующие весь репозиторий; «приложение» выходит по карте |
Кабинет, вход, маршруты и выкат сайта (site/scripts/{auth,app-login,cabinet*,recover,config}.js, страницы входа и кабинета, site/nginx, deploy.sh) |
«приложение» целиком | зона риска: «приложение» целиком, «проверки сайта», «облако» |
Сборщик, проверки и скрипты сайта (site/tools, site/checks, прочие site/scripts) |
«приложение» целиком | «приложение» целиком и «проверки сайта» |
Рой (packages/, apps/, services/, .pulse/) |
«приложение» целиком с тестами роя | «рой» (свой Postgres, tsconfig.swarm.json, все тесты роя) и «приложение» без тестов роя, кроме сканирующих репозиторий |
Только тексты окна (src/shared/i18n/strings/*.ts, нормы стражей src/shared/*.norms.json) и CSS окна (src/renderer/**/*.css, src/mobile/**/*.css; CSS терминала — зона риска), с документами |
«приложение»: typecheck ×4, весь vitest (1 687 файлов) | «приложение» с выбором (порция 3, windowSelection): typecheck — тексты node, web, mobile, CSS — без typecheck; vitest — объявленные стражи WINDOW_GUARDS, тесты, читающие файлы или запускающие процесс, связанные по импортам и тесты кода, читающего окно (WINDOW_READER_SOURCES): CSS — 728 файлов, тексты — 1 171; в журнале выбор: N из M файлов (тексты/CSS окна), причины…. Удалённый или переименованный файл окна — полный набор. Страховка выбора — ночной полный набор; задания на main после вливания нет (очередь pulse-app, журнал порции) |
Код окна, src/shared, src/main; тексты или CSS вместе с кодом |
«приложение» целиком | то же; в журнале задания — тень выбора: тень: выбрал бы N из M файлов… и тень: ПРОПУСК <файл> (ci-shadow.txt) |
Зоны риска: вход, IPC и preload, хранилища, граница чтения, секреты и redact, обновление, терминал, шлюзы |
«приложение» целиком | то же; тень тоже полная |
Облако (cloud/) |
«приложение» и «облако» | то же |
Конфиги и сам выбор (package.json, package-lock.json, vitest.*, tsconfig*, .gitlab-ci.yml, scripts/ci, scripts/git-hooks, src/shared/testImpact.ts, testImpactGuards.ts, ciPaths.ts) |
«приложение» целиком | всё: «приложение», «рой», «проверки сайта», «облако» |
Списки путей заданий «облако», «рой» и «проверки сайта» (rules:changes) — те же, что в карте, один в один (страж
src/shared/testImpact.test.ts); тот же тест держит объявленными тесты роя, читающие файлы вне своих каталогов, и
читателей site/, а src/shared/testImpactGuards.ts — стражей и код, читающий тексты и CSS окна по пути, — новый такой
тест или файл без строки в карте красный. Выбор окна проверен обратно: трасса чтений всего vitest (какие тесты открывают
файлы окна, листают каталоги над ними или запускают процессы в репозитории) — 0 пропусков на 186 файлах окна; 207 MR и
их падения «приложения» — 0 пропусков (журнал). База MR — CI_MERGE_REQUEST_DIFF_BASE_SHA на глубину 1
(scripts/ci/changed-paths.mjs): «приложение» больше не тянет 1 000 коммитов ради решения «только документы».
Цвет значит одно (задача 2013, 12.11.2026): зелёный — прошло всё, что этот конвейер обязан проверить; красный —
сломано, чинить; жёлтый — только пока идёт. Заданий, которые падают по замыслу, нет; ручные задания создаются только
там, где их запускают. «Отменён» у конвейера MR значит «заменён новым пушем в ту же ветку»; конвейеры main и
расписания следующим коммитом не отменяются.
| Конвейер | Идёт само | Кнопки (конвейер не держат) | Зачем такой состав |
|---|---|---|---|
| MR | «правила», «приложение» (typecheck, vitest; выходит сразу, если по карте не нужно); «облако» — при правке cloud/, файлов, которые читают его тесты, и кабинета сайта; «рой» — при правке роя; «проверки сайта» — при правке сайта и того, что читает его сборка; «вендор» — при правке .claude/vendor.lock.json |
e2e, macos arm64, «лаборатория linux» |
ворота вливания: всё, что читает код и тесты; кнопки — для правки, которой нужен стенд или Mac |
main после вливания |
«правила» (против первого родителя), «облако», «статусы задач», wiki при правке документов, «рой» — когда вливание принесло пути роя |
нет | код уже проверил MR; два вливания вместе сверяют правила; итог — success за 1–3 минуты; выбор «тексты и CSS окна» страхует ночь, не вливание |
MR из ветки docs/* |
«правила» (сверяют правила и подтверждают, что в ветке только документы; с кодом в ветке — красные) | как в MR | документный MR не встаёт в очередь pulse-app: итог за 2–3 минуты вместо ожидания до 51 (задача 2020) |
| Ветка без MR | конвейера нет | нет | проверки ветки — конвейер MR; он создаётся при открытии MR и на каждый пуш в его ветку |
| Ночь (расписание № 2) | «приложение» целиком, «рой», «проверки сайта», «интерфейс linux», e2e, «стенд терминала», «бюджеты тестов», «замеры git», «статусы задач» |
нет | полный набор, который MR не гоняет; утром первым делом смотреть его |
По «собирай» (INSTALLERS=1, API) |
полный набор, windows x64, linux x64, macos arm64 (конвейер не держит: раннер — ноутбук) |
macos x64, сайт, mcp-preset-sha256, e2e, лаборатория |
сборка кандидата — только по слову владельца |
main, запущенный руками (Run pipeline или API без переменных; FULL_CHECKS=1) |
полный набор | те же и windows x64, linux x64 |
место, где нажимают сайт и macos arm64, когда сборка Windows и Linux не нужна |
Чего конвейер не проверяет, печатает задание «правила»: артефакт ci-unverified.txt (в MR — ссылка «Not verified by
this pipeline» в виджете), текст строится по режиму конвейера (src/shared/ciUnverified.ts). Состав по видам держит
страж src/shared/ciRules.test.ts: новое задание встаёт в таблицу осознанно. Опись заданий против продукта на
12.11.2026 — qa/ci-audit-2026-11-12.md.
Задания «терминал windows» и «граница чтения linux» не создаются нигде: раннеров с тегами windows и linux-userns
нет. Вернуть — переменной проекта WINDOWS_RUNNER_READY=1 или LINUX_USERNS_RUNNER_READY=1, когда раннер появится.
Фильтр путей и CLAUDE.md. MR из одних документов тяжёлый набор не гоняет (src/shared/ciPaths.ts). Файлы,
которые читают тесты, в фильтр включены, кроме одного: CLAUDE.md исключён осознанно (в него пишут договорённости
почти каждый день), поэтому правка одного CLAUDE.md не прогоняет claudeConfig.test.ts — он пойдёт со следующим MR
с кодом.
Чего ждут сборки и кнопки выпуска (задача 2124). сайт — «правила» и «облако» (needs), полный набор его не
держит; mcp-preset-sha256 — ничего. windows x64 и linux x64 — «правила» и «приложение», а не всю стадию: в полном
режиме «приложение» — это typecheck, весь vitest, lint, сборка и дымовые, поэтому установщик из непроверенного кода не
собирается, а красный «интерфейс linux» больше не делает сборки skipped (так было в конвейере 5815). macos arm64 и
macos x64 ждут «приложение» с артефактами: оно пишет отметку VITEST_PASSED_SHA (только в полном режиме), и с ней Mac
гоняет платформенный набор scripts/ci/platform-tests.mjs, а не весь vitest. Ни одна кнопка конвейер не держит
(allow_failure). При INSTALLERS=1 сборки Windows и Linux идут сами и обязательны; macos arm64 идёт сам, но с
allow_failure: раннер macos — ноутбук владельца, и спящий Mac не должен красить остальные платформы. Не собрался
DMG — конвейер жёлтый, а какая платформа и почему, говорит сводка выпуска (ниже). В расписании Mac-заданий нет: ночью
ноутбук спит, ночной сборки установщиков нет вовсе (19.10.2026).
Документы — веткой docs/*. MR из одних документов называйте docs/<дата>-<тема>: тогда «приложение» в нём не
создаётся. MR из документов в ветке с другим именем тоже пройдёт, но встанет в очередь pulse-app за MR с кодом.
Чего этот порядок не закрывает: ночной полный набор красный с 06.11 (задачи 2016, 2017, 2018); выбор тестов по графу импортов в MR не включён — только тень в журнале «приложения» (исследование 14.11, §7, порция 4: две недели и не меньше 100 MR без настоящего пропуска до включения); прошлый вывод «пропусков шесть» опись 14.11 не подтвердила (опись, раздел 9.1; исследование, §5.3).
Сборка и подпись
- Конфиг — блок
buildвpackage.json. В asar толькоout/**иpackage.json,node_modulesраспакованы: ACP-адаптеры запускаются дочерними процессами. scripts/after-pack.cjsподписывает приложение локальным сертификатом «Pulse Dev» (создаётся один разscripts/make-signing-cert.sh), иначе ad-hoc. Постоянная подпись нужна, чтобы macOS запомнила «Разрешать всегда» для связки ключей.scripts/pack-cleanup.cjsубирает распакованную копию приложения, чтобы в Launchpad не появлялся второй Pulse.- Готовый DMG — порядка полугигабайта (внутри Electron и адаптеры); точный размер — у пакета в Package Registry.
- Фон окна установщика рисует
node docs/brand/tools/dmg-background.cjs(Chromium через Playwright, работает и на Linux): пишетbuild/dmg-background.pngи@2x.png, TIFF из пары собирает сам electron-builder на Mac. Скрипт падает, еслиbuild.dmgвpackage.json(гнёзда, размер значков, путь фона) разошёлся с фоном или текст опустился под строку состояния Finder. Подробности — docs/brand/README.md.
Сборка под другие системы
npm run pack собирает macOS для Apple Silicon, локально Intel — pack:mac-intel, Linux — pack:linux. В GitLab
CI сборки запускаются только по слову владельца «собирай» (перед выпуском или для кандидата), сессии сами их не
запускают:
- Windows x64 и Linux x64 — задания
windows x64иlinux x64на Linux-раннере: конвейерmainс переменнойINSTALLERS=1(Build → Run pipeline или API) или кнопка ▶ у задания в конвейереmain, запущенном руками. Ночной сборки нет (выключена 19.10.2026). - macOS arm64 — задание
macos arm64на Mac-раннере владельца (тегmacos); наmain— подпись Developer ID и нотаризация. СINSTALLERS=1идёт само (конвейер не держит, раннер — ноутбук), иначе — кнопкой. Где кнопка: в конвейере вливания её нет (задача 2013) — кнопкиmacos arm64,сайт,windows x64,linux x64стоят в конвейереmain, созданном руками: Build → Run pipeline илиcurl -sS -X POST "$G/pipeline" -H 'Content-Type: application/json' -d '{"ref":"main"}'(G=https://git.avacloude.ru/api/v4/projects/2). Mac Intel (macos x64) — только с раннеромmacos-intel, сейчас его нет.PULSE_MAC_RUNNERS_READY=1не включают: Mac-задания стали бы обязательными для каждого MR.
EXE, ZIP, AppImage, deb и DMG лежат в GitLab Package Registry (pulse-windows / pulse-linux / pulse-macos
<версия>-<коммит>); артефакт содержит контрольные суммы и версию пакета. В реестр Windows попадает
только проверенный под Wine установщик: распакованная сборка доходит до строки старта
(scripts/ci/smoke-launch.sh), а установщик ставится тихо, установленная копия запускается,
ставится поверх и чисто удаляется (scripts/ci/smoke-install.sh). Окна и вопросы
деинсталлятора Wine не показывает — их проверяют руками на настоящей Windows.
Скрипт scripts/stage-windows-codex.mjs кладёт в пакет Windows-бинарник Codex из
зафиксированной версии и проверяет SHA-512. Скрипт упаковки другой платформы передаёт цель
(--mode <платформа>-<архитектура>): байткод V8 при кросс-сборке выключается.
Подробности по системам — в Платформах.
Выпуск версии
Версия выходит через кандидата: задачи закрыты, main зелёный, CHANGELOG написан → QA агентами → по «собирай» сборки
без тега → владелец проходит список случаев на Mac → его «да» → тег, выпуск, выкладка, сайт (дорожная карта,
«Как выходит версия»; решение 0051). Шаги сессии — скилл
/release, что делает владелец на своём Mac — release-mac.md.
Схема: кто что делает (с 14.11.2026 — выпуск без Mac владельца: ключ подписи ленты и ADMIN_TOKEN живут в CI,
слово владельца «Всё в CI»).
владелец: «собирай»
▼ сессия: POST /projects/2/pipeline ref=main, INSTALLERS=1 [сессия, API]
├─ «правила», «приложение» (полный набор) ─┬─▶ windows x64 (Linux-раннер, Wine) сами, обязательны
│ ├─▶ linux x64 (Linux-раннер) сами, обязательны
│ ├─▶ macos arm64 (ноутбук владельца) само, не держит конвейер
│ └─▶ macos x64 (раннер Антона) кнопка; вне выпуска — Антон для себя
▼ сессия: node --no-warnings scripts/release/summary.mjs --pipeline <N> [сессия, только чтение API]
│ таблица «платформа → задание → пакет → SHA коммита → SHA-256»; ОШИБКА — выпуск не собирать, НЕ СОБРАНО — решить:
│ пересобрать платформу (кнопка ▶ у задания) или выпустить без неё словом владельца (--platforms)
▼ «да» владельца → сессия: POST /projects/2/releases (тег, описание, таблица сводки, ссылки на пакеты)
▼ Антон или владелец: cd cloud && ./deploy.sh — только если cloud/ менялся [ключ сервера — не в CI]
▼ кнопка `лента` в этом же конвейере (POST /jobs/:id/play) [CI, окружение release-publish]
│ тег на этом коммите → сводка → пакеты из реестра со сверкой SHA-256 → проверка ключа → publish-release.sh
│ → /releases/latest по каждой выложенной платформе; артефакт release-feed/ (сводка, SHA256SUMS, ответ ленты)
▼ кнопка `сайт` в этом же конвейере — доступна после ленты (rules:needs) [site/deploy.sh: сборка, rsync, самопроверка]
Что делает владелец: говорит «собирай», «да» на кандидата и — сам или словом сессии — нажимает две кнопки: лента
после тега, сайт после ленты. Остальное идёт само; ▶ у упавшей сборки — повтор, если причина — раннер, а не код.
Выкладка с Mac (fetch-packages.mjs + publish-release.sh у владельца) — запасной путь
(release-mac.md, «Выкладка в ленту»): если CI недоступен или переменные ещё не заведены.
- Кто поднимает версию в
package.json, тот тем же коммитом приносит запись вCHANGELOG.md(абзац «Коротко.» и рассказ с числом проверок) и статью вsite/src/pages/changelog.html(правило версии — CLAUDE.md, «Выпуск»). npm run check:changelog --prefix site, затемnpm run typecheck && npm test && npm run build.- Сборки — в конвейере
main, созданном под сборку (Run pipeline или API; сINSTALLERS=1Windows, Linux иmacos arm64идут сами, Intel — кнопкой для раннера Антона). В конвейере вливания кнопок нет. Итог — сводкой:NODE_USE_ENV_PROXY=1 node --no-warnings scripts/release/summary.mjs --pipeline <N>(код 0 — собраны все обязательные платформыdarwin-arm64,win32-x64,linux-x64с одного коммита, 1 — не сходится, 2 — не все обязательные;--platformsзадаёт ожидаемое). Intel (darwin-x64) — «по желанию»: его нет — строка «ПО ЖЕЛАНИЮ», а не «НЕ СОБРАНО»; есть его пакет этого коммита — уходит в ленту вместе с остальными (владелец 14.11.2026: «там Антон должен собирать для себя»). - Тег и выпуск GitLab одним вызовом:
POST /projects/2/releases(тег, ref, описание с таблицей сводки, ссылки на пакеты). После тега та же сводка —--tag vX.Y.Z. - Облако — Антон или владелец, только если
cloud/менялся с прошлого выпуска:cd cloud && ./deploy.sh. В CI оно не уходит: выкат облака — SSH-ключ сервера, это отдельный секрет и отдельное решение. - Выкладка в ленту обновлений — кнопка
лентав конвейере сборки этого выпуска (задание CI,scripts/release/publish-ci.sh). Задание само проверяет, что тегvX.Y.Z(версия изpackage.json) стоит на коммите конвейера — до тега оно падает строкой «тега нет», ничего не выложив; качает пакеты токеном задания и сверяет SHA-256 с реестром; неполный выпуск (нет обязательной платформы) — падение до скачивания со строкой, как выложить часть осознанно: запуск кнопки с переменнойPULSE_RELEASE_PLATFORMS="darwin-arm64 linux-x64"(имя задания → «Run job» с переменной). Ключ проверяется против встроенного открытого до выкладки; в конце задание спрашивает/releases/latestсX-Pulse-Update-Protocol: signed-v1по каждой выложенной платформе — версия и подпись ответа. Итог — артефактrelease-feed/. Переменные — раздел ниже. Запасной путь — с Mac владельца (release-mac.md). Резерв ключа подписи манифестов — инструкция. - Сайт — после ленты: задание
сайтв конвейере сборки этого выпуска (INSTALLERS=1) ждётлентасамо (rules:needs), кнопка становится доступна, когда лента закончилась; в конвейереmain, созданном Run pipeline или API безINSTALLERS, сайт ленту не ждёт (выкат текста сайта не требует выпуска; в конвейере вливания кнопки нет). Сборка страницы сверяет первую статью сCHANGELOG.mdи версией приложения; блок скачивания берёт версию у сервера обновлений сам. - На каждом X.Y.0 — полная перепроверка и обновление под фактический продукт (слово владельца 05.11.2026, CLAUDE.md,
«Свежее»):
node scripts/release/recheck.mjs(шаг 3б/release), итог —docs/qa/runs/<дата>-audit-X.Y/README.md. В шаге 2 он зовётscripts/docs/claude-md-check.mjs --release: пункт «Свежего» CLAUDE.md старше 7 дней — красный (задача 2128).
Почему платформа не собралась
По аудиту сборок 30.09–14.11.2026 (159 стартовавших заданий сборки и сайта). Первое — строка «НЕ СОБРАНО» или «ОШИБКА» сводки выпуска: она называет платформу и статус задания.
| Причина | Как узнать | Что делать |
|---|---|---|
Кнопка не нажата (manual) |
сводка: «задание — кнопка, не нажата» | нажать ▶ у задания в конвейере сборки или выпустить без платформы словом владельца (--platforms) |
| Решение «пока только Mac» (03.11.2026) | Windows, Linux, Intel не запускались в 0.35.2 и 0.36.0 | не поломка: снимает только слово владельца |
skipped у Windows и Linux |
сводка: «задание пропущено»; в конвейере красное «приложение» | чинить «приложение»; с 14.11 сборки ждут только его и «правила», красный «интерфейс linux» их больше не снимает |
| Windows висит после «building block map» (31.10, задания 22533, 22560) | журнал: «ОШИБКА СБОРКИ WINDOWS: … не закончился за 25 минут», строки «Wine [после упаковки]: живые процессы» | процессы Wine из журнала — в задачу; повтор ▶; задание снимается за 50 минут, до предела раннера 60 |
Диск Linux-раннера кончился, ENOSPC (05.11, задание 27451) |
журнал: no space left on device; df -h перед упаковкой |
почистить кэш раннера (scripts/ci/cache-limit.sh) или диск; повтор ▶ |
| Реестр отвечает 500 при заливке (10–19.10, 21 падение) | журнал: curl: (22) … 500 на заливке |
диск сервера GitLab: убрать старые пакеты (npm run ci:packages), проверить место; повтор ▶ |
Ноутбук-раннер macos спит или без сети |
macos arm64 в pending/stuck, no_updates_running, обрыв get_sources |
открыть Mac, проверить, что раннер на связи; повтор ▶. Конвейер при этом жёлтый, не красный |
| Весь vitest красный на Mac (≈19 из 34 падений arm64: сокеты, окружение, пороги времени) | журнал macos arm64: «весь vitest этот коммит не проходил» |
в конвейере сборки отметка VITEST_PASSED_SHA даёт платформенный набор; без неё — сначала зелёное «приложение» |
| Первый запуск DMG, CDP не открылся (4 падения arm64) | scripts/e2e/first-run.mjs в журнале, кадры dist/first-run/ в артефакте |
разобрать кадры; это поломка продукта или стенда, не раннера |
Intel: раннер macos-intel не на связи (с 07.11) или байткод отвергнут под Rosetta (cachedDataRejected, задание 28097) |
сводка: «ПО ЖЕЛАНИЮ: macOS x64 (Intel) …»; 7 из 7 красные | не поломка выпуска: Intel вне общего выпуска, собирает Антон для себя (слово владельца 14.11.2026) |
лента упала «тега нет» или «тег указывает на …» |
журнал задания лента |
поставить тег (шаг 4) или нажать лента в конвейере коммита тега |
лента упала «нужна переменная …» или «ключ подписи не тот» |
журнал задания лента |
переменные — раздел «Переменные, которые заводит владелец» ниже |
| Зелёное задание, а пакета нет | сводка: «ОШИБКА: … зелёное, а пакета … нет» | пакет удалила чистка (cleanup-packages.mjs) — пересобрать ▶ |
| Пакеты с разных коммитов | сводка: «ПАКЕТЫ СОБРАНЫ С РАЗНЫХ КОММИТОВ» | пересобрать отставшие платформы в одном конвейере main с INSTALLERS=1 |
Сайт не выкатился (12 из 18 за окно — ключ SITE_DEPLOY_KEY, права на сервере, nginx) |
журнал задания сайт: Permission denied, libcrypto, mkdir … Permission denied |
доступы и сервер, не код сайта: ключ и права — владелец; с 12.11 nginx — предупреждение, не стоп |
Переменные, которые заводит владелец
Для задания лента (14.11.2026, «Всё в CI»). Секреты заводит только владелец; сессии их не читают, не создают и не
меняют. Обе переменные — с областью окружения release-publish: её объявляет только лента (страж
src/shared/ciParity.test.ts), без области переменная ушла бы во все задания всех конвейеров (CLAUDE.md, «Грабли»).
| Имя | Тип | Protected | Masked | Область окружения | Значение |
|---|---|---|---|---|---|
PULSE_ADMIN_TOKEN |
Variable | да | да (и Hidden, если предлагает) | release-publish |
токен админа облака обновлений — то же, что ADMIN_TOKEN в cloud/.deploy/admin.env на Mac |
PULSE_RELEASE_SIGNING_KEY_FILE |
File | да | нет (PEM многострочный, GitLab его не маскирует) | release-publish |
содержимое ~/.config/pulse/release-signing/release-ed25519.pem целиком |
Шаги в GitLab: проект avateam/pulse → Settings → CI/CD → Variables → Add variable. Для каждой строки таблицы: Type —
из колонки «Тип»; Environments — вписать release-publish (окружения ещё нет в списке — GitLab принимает имя текстом;
после первого запуска лента оно появится); Flags — Protect variable (переменная придёт только в конвейер защищённой
ветки main), для токена ещё Mask variable; Key — имя из таблицы; Value — значение. Ключ надёжнее завести из файла, а
не вставкой в поле (вставка теряет переводы строк — так ломался SITE_DEPLOY_KEY), через API с токеном, введённым в
терминал, как в release-signing-backup.md:
curl --header @- -X POST …/projects/2/variables --form key=PULSE_RELEASE_SIGNING_KEY_FILE --form variable_type=file --form protected=true --form environment_scope=release-publish --form "value=<$HOME/.config/pulse/release-signing/release-ed25519.pem".
Ошибиться ключом нельзя: задание сверяет открытую половину со встроенной в Pulse и иначе падает до выкладки.
Резерв PULSE_RELEASE_SIGNING_KEY_B64 (область pulse-release-key-backup) остаётся как есть: его не видит ни одно
задание, и область ему не менять. Задание понимает и вид base64 — если владелец предпочтёт завести копию
PULSE_RELEASE_SIGNING_KEY_B64 с областью release-publish (её GitLab маскирует), PULSE_RELEASE_SIGNING_KEY_FILE
тогда не нужен; почему главным выбран File — журнал 2026-11-14-release-ci.
Не включать CI_DEBUG_TRACE в конвейере выпуска: трассировка печатает окружение целиком.
Порядок шагов 5–7 обязателен: облако → пакеты → сайт. Платформу android знает только
новое облако (cloud/src/routes/releases.ts), и оно отвечает и скрипту выкладки, и карточке
на сайте. Выложить пакет раньше выката облака нельзя: /admin/releases ответит 400
invalid_platform. Выкатить сайт раньше облака — хуже: карточка «Android · пакет» уже лежит
в собранной site/download.html и спрашивает /releases/latest?platform=android при каждом
открытии страницы. Старое облако ответит 400, карточка скажет «пакет ещё не выкладывают» —
страница будет уверенно сообщать неправду про то, ради чего выпуск и делается. Обратный
порядок безвреден: облако с выложенным пакетом и старым сайтом ещё никто не спрашивает.
Выкат сайта не ждёт ни правки nginx, ни облака (с 12.11.2026). До этого скрипты сайта требовали заголовка
Cache-Control: no-cache: модули импортировали друг друга без версии, и при часовом кэше сервера свежий cabinet.js
встречал старый auth.js. Заголовок кладёт только root на сервере, поэтому выкат зависел от ручной правки nginx.
Теперь версию даёт сборка: site/tools/asset-versions.mjs считает хэш содержимого набора (скрипты русской версии,
скрипты английской, стили) и ставит его в ?v= каждому импорту между модулями и каждой ссылке из страниц. Часовой кэш
/scripts и /styles стал безвреден. site/deploy.sh до заливки сверяет версии по собранным файлам
(site/checks/asset-versions.test.mjs) и смотрит заголовок страниц; это предупреждения, выкат они не останавливают
(слово владельца 12.11).
site/nginx/pulse.avacloude.ru.conf по-прежнему кладут на сервер руками (nginx -t && systemctl reload nginx), но выкат
сайта от этого больше не зависит. Сайт можно выкатить и раньше облака: раздел кабинета, чьего маршрута на сервере ещё
нет (ответ 404), говорит «появится после обновления сервера», остальной сайт и вход работают как прежде.
Чего версии не дают, и почему no-cache для .js в конфиге nginx остаётся целевым состоянием сервера: сервер не
проверяет ?v=, это только ключ кэша, поэтому страница, взятая браузером из истории «назад / вперёд», может свести
старый модуль с новым соседом; страницы, которые рисует облако (/admin, страница входа, 404 в cloud/src/routes),
ссылаются на /scripts/main.js и /styles/tokens.css без версии и до часа после выката видят прежние файлы.
Три версии сайта, которые расходятся — главный источник путаницы. «Версия на сайте» — это три разных числа:
- бейдж в шапке и футере —
site/scripts/version.js, генерируется билдером сайта из корневогоpackage.json, обновляется только выкатом сайта; 2) карточки скачивания — берут версию у/releases/latestотдельно по каждой платформе, обновляются только выкладкой сборок, у каждой платформы своя; 3) текст страниц, включаяsite/changelog.htmlи запасные номера в разметке под выключенный JS, — пишется руками вsite/src/pages/, изCHANGELOG.mdне генерируется. Поднять версию вpackage.jsonнедостаточно ни для одного из трёх. План версий — решение 0037 и tracker.md, «Выпуски и версии».
Облако и сайт
cloud/ — Fastify + SQLite: авторизация (почта; OAuth — GitHub, Яндекс, VK, Discord), лицензии, сервер обновлений
(/releases/latest, /admin/releases) и приём отчётов об ошибках (/reports, /admin/reports). Деплой:
cd cloud && ./deploy.sh (сборка → rsync → рестарт → health). Сайт хранится в site/; документация собирается из
docs/, версия — из корневого package.json; site/deploy.sh собирает и публикует также веб-сборку Pulse Mobile по /mobile/
(приложение снято из работы, страница выкатывается). /login, /signup, /account обслуживает сайт; /auth/*,
/license*, /relay/* и административные API — облако; сайт и облако делят домен, адреса относительные
(.claude/rules/site.md). Облачные HTML-страницы остаются резервным интерфейсом для установки без сайта. Контракты —
документ модуля cloud.