v4.2.1

TARPED 4.2.1 · X-LATCH — agent recovery and atomic switching

English

This patch release closes two upgrade-path gaps: compatible devices now have
an install action beside each release in the catalogue, legacy devices have a
visible owner-only recovery route, and Windows staged installation no longer
relies on recursive moves while agent processes may still hold files open.

• X-LEDGER install action: Compatible agents show an install button beside
  each release in the catalogue; selecting one still requires confirmation and
  the agent verifies the signed release before replacing files.
• X-LATCH recovery: The catalogue and version details for an old, frozen,
  untrusted, or offline agent now offer the owner a signed one-line bootstrap command. The
  command must be run in a terminal on that device; it is local bootstrap, not
  remote installation. The screen explicitly says it installs the latest
  signed release, not the historical version currently being viewed. After the
  agent reconnects, the owner can return to X-LEDGER and choose a compatible tag.
• Windows atomic switch: The installer waits for scheduled tasks, detects
  only the managed XGENT-WDS executable or the two agent scripts under the
  installation directory, and stops only those remaining processes. It then
  uses same-volume directory renames for activation and rollback.
• Version identity: Bot, Windows agent, macOS agent, and Windows PE metadata
  are aligned at 4.2.1.

Automated checks cover legacy-catalog recovery and Windows install/rollback
fixtures. Activation and rollback are two atomic directory renames with a brief
gap; if interrupted between them, the previous checkout remains in its backup
directory. These checks do not prove Telegram operation or physical-device
acceptance.

Русский

Патч закрывает два провала в обновлении: у совместимого агента появляется
кнопка установки рядом с каждым релизом, у старого устройства — понятный
владельцу путь восстановления, а Windows-установщик перестаёт рекурсивно
переносить папку, пока процессы агента держат файлы открытыми.

• Установка из X-LEDGER: Рядом с каждым релизом для совместимого агента
  есть кнопка установки. Перед отправкой команды бот просит подтверждение, а
  агент проверяет подпись релиза до замены файлов.
• Восстановление X-LATCH: В каталоге и карточке старого, замороженного,
  недоверенного или офлайн-агента владелец получает короткую команду подписанного
  установщика. Её нужно выполнить в терминале именно на этом устройстве: это
  локальная установка, а не удалённая команда из Telegram. Текст уточняет, что
  ставится последний подписанный выпуск, а не исторический тег, открытый в
  каталоге. После подключения через X-LEDGER можно выбрать совместимый тег.
• Атомарное переключение Windows: Установщик дожидается остановки задач,
  находит только XGENT-WDS.exe или два скрипта агента внутри управляемого
  каталога и останавливает только найденные процессы. Установка и откат
  используют атомарное переименование папок на том же диске.
• Версия: исходники бота и обоих агентов, а также метаданные Windows PE
  согласованы на 4.2.1.

Автоматические проверки покрывают восстановление старого агента и фикстуры
установки/отката Windows. Две атомарные операции переименования разделены
коротким промежутком; при прерывании между ними прежняя версия остаётся в
резервной папке. Эти проверки не заменяют приёмку на физических устройствах.

What's Changed

• fix: legacy agent recovery and atomic Windows swap by @invinby in #12

Full Changelog: v4.2.0...v4.2.1

v4.2.0

TARPED 4.2.0 · X-ROUTE — exact link routing

English

This release adds an explicit, bounded URL workflow and finishes several
version-consistency/documentation fixes.

• X-ROUTE: Send an HTTP(S) URL to the selected authorized Windows/macOS
  device. The owner chooses 1, 2, 3, or 5 opens; the default browser decides
  whether they appear as tabs or windows. The owner can save named favorites.
• X-LEX handbook: Every chapter title and body now follows the selected
  interface voice. The X-PIKMI handbook and URL prompts are intentionally more
  feminine/playful without changing permissions or technical meaning.
• X-LEDGER: Keep selecting an exact GitHub release tag and inspect its notes.
  Agent updates still require confirmation, compatible signed-release support,
  the pinned publisher key, and a verified signed package.
• Release identity: Bot and agent versions now match at 4.2.0. The Windows
  executable and macOS app metadata are aligned with the agent version. The
  repository now has a complete Russian README paired with the English README.

Verification boundary

Automated/offline tests cover URL validation, the count contract, X-LEX handbook
rendering, release-tag dispatch, and platform packaging metadata. These checks
do not prove live Telegram/MQTT operation or physical-device acceptance on
Windows/macOS. The updater uses the transactional backup/install/health-check/
rollback flow; this is not a two-slot A/B deployment.

Русский

Этот выпуск добавляет явный ограниченный сценарий открытия ссылок и чинит
согласованность версий и документации.

• X-ROUTE: Отправь HTTP(S)-ссылку выбранному устройству Windows/macOS, на
  которое у владельца есть право. Владелец выбирает 1, 2, 3 или 5 открытий;
  вкладки или окна создаёт браузер по умолчанию. Именованные ссылки можно
  сохранять в избранное владельца.
• Справочник X-LEX: Названия и текст глав теперь соответствуют выбранному
  стилю интерфейса. X-PIKMI в справке и подсказках ссылок стал заметно более
  девчачьим и игривым; права и технический смысл от этого не меняются.
• X-LEDGER: По-прежнему можно открыть конкретный GitHub-тег и прочитать
  заметки к нему. Установка агента требует подтверждения, совместимой поддержки
  подписанного релиза, закреплённого ключа издателя и проверенного пакета.
• Идентичность релиза: Версии бота и агентов синхронизированы на 4.2.0.
  Метаданные исполняемого файла Windows и приложения macOS согласованы с версией
  агента. Добавлен полный русский README к английскому.

Граница проверки

Автотесты проверяют валидацию URL, допустимое число открытий, рендеринг справки,
передачу выбранного GitHub-тега и метаданные сборок. Они не доказывают работу
живого Telegram/MQTT или приёмку на физических Windows/macOS. Обновлятор
использует транзакцию «резервная копия → установка → health-check → откат»;
это не двухслотовое A/B-развёртывание.

What's Changed

• feat: X-ROUTE and TARPED 4.2.0 by @invinby in #11

Full Changelog: v4.1.7...v4.2.0

v4.1.7

TARPED 4.1.7 · X-ALIVE: подтверждённый запуск

Русский

Patch 4.1.7 устраняет ситуации, когда процесс уже запущен, но агент ещё не
подключился к брокеру — а установщик уже объявил обновление успешным.

• Windows-установщик теперь ждёт свежего подтверждения MQTT отдельно от Agent
  и Guard Keeper, проверяет их версии и живые PID, требует два последовательных
  успешных измерения. Если подтверждений нет, выполняется откат предыдущей
  версии и задач.
• Установщики Agent и Guard Keeper прекращают установку, если Windows отказала
  в настройке ACL для файлов запуска.
• Статус macOS больше не объявляет остановку только потому, что LaunchAgent
  загружен в состояние ожидания; проверяется живой процесс агента.
• Геолокация на macOS и Windows ограничена общим тайм-аутом и выдаёт один
  результат, не дублируя его в другом MQTT-топике.
• Владелец по-прежнему может открыть «Устройства → Установка · одна команда»,
  выбрать Windows/macOS и скопировать короткую команду установки.

Проверка релиза выполняется CI на Windows PowerShell 5.1/7 и Unix. Тесты
подтверждают логику установки и отката в изолированных фикстурах; это не
заменяет проверку живого Telegram/MQTT и физических Mac/Windows.

English

Patch 4.1.7 fixes cases where a process has started but the agent has not yet
connected to the broker, while the installer already reports success.

• The Windows installer now requires fresh MQTT confirmations from both the
  Agent and Guard Keeper, verifies their versions and live PIDs, and requires
  two consecutive healthy samples. Missing confirmation triggers rollback to
  the previous version and scheduled tasks.
• Agent and Guard Keeper installers stop if Windows rejects launch-file ACL
  configuration.
• macOS status no longer reports a false stop merely because a loaded
  LaunchAgent is waiting; it checks for a live agent process.
• macOS and Windows geolocation has a shared timeout and emits one result rather
  than duplicating it on a second MQTT topic.
• The owner can still open “Devices → One-command install”, choose Windows or
  macOS, and copy its short installation command.

Release checks run in CI on Windows PowerShell 5.1/7 and Unix. Tests exercise
installer and rollback logic in isolated fixtures; they do not replace live
Telegram/MQTT or physical Mac/Windows acceptance.

What's Changed

• fix: verify endpoint health before update by @invinby in #10

Full Changelog: v4.1.6...v4.1.7

v4.1.6

TARPED 4.1.6 · X-STAB: one card, one command

Русский

Patch 4.1.6 не даёт разным долгим командам одновременно менять одну карточку Telegram.

• Блокировка теперь привязана к пользователю, чату и сообщению, а не к названию
  команды. Пока на карточке идёт действие, другая кнопка получает понятный отказ.
• Владелец по-прежнему может открыть «Устройства → Установка · одна команда»,
  выбрать Windows/macOS и скопировать короткую команду для терминала.
• Версия бота, Windows-агента и macOS-агента синхронизирована на 4.1.6.

Проверка: полный локальный прогон tools/run_tests.py — 547 passed, 11 skipped;
включены регрессионный тест сериализации, тесты компонентов, подписи релизных
артефактов и Windows-фикстуры установки/отката. Это не заменяет проверку живого
Telegram/MQTT и физических Mac/Windows.

English

Patch 4.1.6 prevents different long-running actions from editing one Telegram card at once.

• The lock is now keyed by user, chat, and message rather than action name. While
  an operation is active on a card, a second button receives a clear rejection.
• The owner can still open “Devices → One-command install”, choose Windows or
  macOS, and copy the short terminal command.
• Bot, Windows-agent, and macOS-agent release identities are aligned at 4.1.6.

Verification: the full local tools/run_tests.py run reports 547 passed and 11
skipped, including the new serialization regression, component suites, release
signature tooling, and Windows install/rollback fixtures. This does not replace
live Telegram/MQTT or physical Mac/Windows acceptance.

What's Changed

• fix(bot): serialize actions per Telegram card by @invinby in #9

Full Changelog: v4.1.5...v4.1.6

v4.1.5

TARPED 4.1.5 · X-LEDGER: заметки до последней страницы

Русский

Патч 4.1.5 чинит просмотр длинных описаний GitHub-релизов в Telegram.

• X-LEDGER сохраняет полный текст release notes, а не обрезает его на 6 000 символах.
• Навигация по заметкам работает и после 21-й страницы; подготовка страниц не
  блокирует event loop бота.
• Кнопка «Установка · одна команда» уже доступна владельцу в разделе устройств.
  Она показывает короткую команду для запуска подписанного установщика выбранной ОС:
  irm https://invinby.github.io/XIDER/win.ps1 | iex или
  curl -fsSL https://invinby.github.io/XIDER/mac | bash.
• Windows/macOS компоненты получают новую общую версию для подписанного полного
  комплекта; функциональный код агента в этом patch-релизе не менялся.

Локальная проверка включает component suites, подписи релизных артефактов и
Windows fixtures staged install/full bootstrap rollback. Это не заменяет
проверку Telegram, MQTT и физических Mac/Windows устройств.

English

Patch 4.1.5 fixes Telegram browsing of long GitHub release notes.

• X-LEDGER retains complete release notes instead of truncating them at 6,000
  characters.
• Pagination continues beyond page 21, and preparing note pages no longer runs
  on the bot event loop.
• The owner-only one-command installer button is already available in the
  Devices section and provides the signed Windows or macOS entry point.
• Windows/macOS components receive the new shared version for the signed full
  release set; their functional agent code is unchanged in this patch release.

Local checks include component suites, release-signature tooling, and Windows
staged-install/full-bootstrap rollback fixtures. They do not replace live
Telegram, MQTT, or physical Windows/macOS acceptance.

What's Changed

• docs(ops): add X-MAP command support matrix by @invinby in #7
• fix(x-ledger): показывать заметки релизов целиком by @invinby in #8

Full Changelog: v4.1.4...v4.1.5

v4.1.4

What's Changed

• fix(bot): show recovery installer for legacy agents by @invinby in #6

Full Changelog: v4.1.3...v4.1.4

v4.1.3

What's Changed

• fix: explain rejected MQTT message reasons by @invinby in #5

Full Changelog: v4.1.2...v4.1.3

v4.1.2

What's Changed

• Fix VPS updater for signed GitHub source archives by @invinby in #4

Full Changelog: v4.1.1...v4.1.2

v4.1.1

What's Changed

• Stabilize Telegram callback cards and bootstrap verification by @invinby in #3
• fix: harden XIDER access and recovery flows by @invinby in #2

Full Changelog: v4.1.0...v4.1.1

v4.1.0

TARPED 4.1.0 · X-DOCK / Guard Keeper

Русский

4.1.0 — новая группа совместимых возможностей после 4.0.0: подписанная доставка
установщиков, локальное восстановление исходников и исправление перезапуска
macOS source-агента. Номер не является случайной датой или обещанием завершения
всего Mega-плана. Старые релизы сохраняются.

Установка

macOS:

curl -fsSL https://invinby.github.io/XIDER/mac | bash

Windows PowerShell:

irm https://invinby.github.io/XIDER/win.ps1 | iex

Короткие entrypoint требуют опубликованного GitHub Pages endpoint и файлов
этого релиза. Они проверяют подпись установщика; установщик проверяет подпись
bootstrap и полный commit. Windows-команда устанавливает Agent/Guardian,
не запускает деплой Telegram-сервера на VPS. Python/OpenSSH и первоначальный
SSH-доступ к серверу конфигурации обязательны. Разрешения ОС выдаются на устройстве.

Изменения

• Mac обновляется из списка опубликованных подписанных source-релизов в боте.
  Одновременные обновления отклоняются. Перезапуск через exec устраняет конфликт
  singleton-блокировки со старым ещё работающим процессом.
• Старый процесс не может подтвердить здоровье новой версии своим переподключением.
  Новый worker проверяет исходники перед выбором recovery cache; журнал позволяет
  откатить и исходники, и выбор cache после прерывания.
• Guard Keeper восстанавливает отсутствующие allowlisted файлы из подписанного
  локального пакета, проверяя подпись, размер, SHA-256 и соответствие версии.
  Явная остановка/удаление не отменяются. Секреты и runtime не пересоздаются.
  Потеря worker во время незавершённой транзакции обрабатывается под общей
  singleton-блокировкой: сначала проверка журнала и откат согласованной версии.
• Зависимости initial Mac install готовятся до остановки старого агента.
  Runtime получает стабильный абсолютный путь; исходники прежней версии сохраняются.
• После здорового обновления worker уже загруженный Guardian перезапускается
  отдельно. Отключённая или отсутствующая задача при этом не включается.
• Ответы сценариев обоев используют текущую Telegram-карточку и шесть голосов
  X-LEX. Таймаут больше не выдаётся за установленный фон.
• Ошибки и промежуточный результат удаления описываются точно: исходники,
  .env и agent.log могут остаться после снятия автозапуска и локальных данных.
• Поздние ошибки перезапуска и удаления приходят владельцу отдельно с защитой
  от повторов. Ответ «удаление подготовлено» больше не отзывает права устройства
  до подтверждённого результата. Шесть стилей X-LEX сохраняют эту разницу.

Ограничения

Это source-updater, не универсальное обновление PyInstaller-бинарников.
Изменение requirements.txt отклоняется до замены файлов; дистанционная
транзакционная замена Python runtime ещё не реализована. Рабочая MQTT-сессия —
не проверка камеры, экрана, геопозиции или каждого действия. Офлайн fixtures
не заменяют реальное испытание Mac/Windows и Telegram.

Guardian recovery требует живого Guardian и runtime. Полное удаление установки
не должно создавать скрытое восстановление. Имена safari и siri пока являются
предложениями ролей XIDER, не установленными службами Apple.

Подробности: подготовка Mac,
Mega-план.

English

4.1.0 is a compatible feature-group release after 4.0.0, not a random version
jump or a claim that the entire TARPED roadmap is finished. Previous releases
remain available.

• Short Windows/macOS entry points authenticate standalone installer hashes
  with the pinned publisher key. Each installer independently authenticates
  the bootstrap bound to the release tag and full source commit.
• Windows bootstrap is agent-only. macOS prepares dependencies before stopping
  the previous installation and keeps a stable runtime path and rollback copy.
• macOS source updates are serialized and restart via exec, avoiding the
  singleton race with a still-running parent. Only the new startup attempt can
  commit health; source files and recovery selection roll back together.
• Guard Keeper restores missing allowlisted files from a reverified signed
  local source package. Explicit stop/uninstall is respected; secrets and
  Python runtimes are not regenerated. A healthy worker update reloads only an
  already-loaded Guardian job, never enables an absent/disabled job.
• Wallpaper commands reuse one Telegram card, support six X-LEX voices and
  distinguish verified success from an unacknowledged request.
• Late restart/uninstall failures notify the owner with bounded duplicate
  suppression. A prepared uninstall reply no longer revokes device identity.
  A missing worker during a pending update triggers validated rollback under
  the shared singleton lock before the signed recovery cache is used.

Known limitations: changed dependencies require the installer; frozen packages
do not use the source updater; OS permissions require local consent; runtime,
Guardian removal and all-device deletion cannot be recovered by this cache.
Offline tests do not establish real-device camera, screen, location or power
functionality. See the roadmap for open acceptance checks.