Разработка

Сверено с выпуском 0.36.0 и кодом main 2f45d8d9a, 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 недоступен или переменные ещё не заведены.

  1. Кто поднимает версию в package.json, тот тем же коммитом приносит запись в CHANGELOG.md (абзац «Коротко.» и рассказ с числом проверок) и статью в site/src/pages/changelog.html (правило версии — CLAUDE.md, «Выпуск»).
  2. npm run check:changelog --prefix site, затем npm run typecheck && npm test && npm run build.
  3. Сборки — в конвейере main, созданном под сборку (Run pipeline или API; с INSTALLERS=1 Windows, 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: «там Антон должен собирать для себя»).
  4. Тег и выпуск GitLab одним вызовом: POST /projects/2/releases (тег, ref, описание с таблицей сводки, ссылки на пакеты). После тега та же сводка — --tag vX.Y.Z.
  5. Облако — Антон или владелец, только если cloud/ менялся с прошлого выпуска: cd cloud && ./deploy.sh. В CI оно не уходит: выкат облака — SSH-ключ сервера, это отдельный секрет и отдельное решение.
  6. Выкладка в ленту обновлений — кнопка лента в конвейере сборки этого выпуска (задание 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). Резерв ключа подписи манифестов — инструкция.
  7. Сайт — после ленты: задание сайт в конвейере сборки этого выпуска (INSTALLERS=1) ждёт лента само (rules:needs), кнопка становится доступна, когда лента закончилась; в конвейере main, созданном Run pipeline или API без INSTALLERS, сайт ленту не ждёт (выкат текста сайта не требует выпуска; в конвейере вливания кнопки нет). Сборка страницы сверяет первую статью с CHANGELOG.md и версией приложения; блок скачивания берёт версию у сервера обновлений сам.
  8. На каждом 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 без версии и до часа после выката видят прежние файлы.

Три версии сайта, которые расходятся — главный источник путаницы. «Версия на сайте» — это три разных числа:

  1. бейдж в шапке и футере — 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.