> For the complete documentation index, see [llms.txt](https://raito-kyokai.gitbook.io/catalib/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://raito-kyokai.gitbook.io/catalib/kontribyutoram/changelog.md).

# История изменений

Полная история ведётся в `CHANGELOG.md` в корне репозитория по формату [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/); проект следует [Semantic Versioning](https://semver.org/lang/ru/).

Актуальная версия: [CHANGELOG.md на GitHub](https://github.com/cataIystdev/catalib/blob/main/CHANGELOG.md).

## Заметные вехи

* Сборка модульного дерева в один самодостаточный `<plugin_id>.py` (CLI `build`), плюс идентичная копия `<plugin_id>.plugin`.
* Встроенный загрузчик на `sys.meta_path`: относительные импорты, пакеты, трейсбеки на исходники; очистка устаревших вендоренных `catalib.*` между деплоями.
* Мини-фреймворк `catalib.support`: авто-регистрация хуков и пунктов меню, типизированные настройки, безопасные импорты SDK.
* CLI `watch` с автодеплоем через dev server, `init` с шаблоном.
* Корректный API меню SDK (`MenuItemData(menu_type=..., on_click=...)`), отказ от нестандартного `__min_version__`.
* Пример `exteraToolbox` (44 модуля) и полная документация (эта книга).
* **0.2.0**: `watchfiles` опционален (`pip install "catalib[watch]"`, работает на телефоне); паритет support-слоя с SDK — полные настройки, кликабельная строка (`settings.text(on_click=)`), поля меню `item_id`/`condition`/`priority`, `@hook.app_event`, декларативные Xposed-хуки `@xposed` (ADR-0005, ADR-0006).
* **0.3.0**: полный паритет `catalib.support` со **всем** публичным SDK exteraGram — модули `android`/`client`/`files`/`reflection`/ `formatting`/`dialogs`/`bulletins`/`proxy` (class proxy)/`classes`, карта хук-методов `pre_request`/`post_request`/`on_update`/ `on_updates`, довод настроек и ядра до полноты; всё строго аддитивно (ADR-0007).
* **0.3.1**: помодульный tree-shaking вендоренного `catalib` — в сборку попадает только используемое (≈ −34% объёма `catalib`-части), опция `[build] vendor = auto|full`, консервативный fallback (ADR-0008).
* **0.3.2**: комфорт разработки — типизация PEP 561 + поставка SDK-стабов и `catalib stubs` (ADR-0009); `catalib doctor` (префлайт-диагностика); шаблоны `catalib init -t` и модуль `catalib.testing`; `catalib logs`; решение по `intents` подтверждено эмпирически (ADR-0010).
* **0.3.3**: запуск CLI на самом устройстве (Termux/Pydroid) — деплой без `adb` (прямой dev server), `watch` без `watchfiles` (stdlib-поллинг), `doctor`/`logs` под Android, детект среды `catalib.platforms` (ADR-0011).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://raito-kyokai.gitbook.io/catalib/kontribyutoram/changelog.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.