mandochka 0.1.0__tar.gz

mandochka-0.1.0/LICENSE

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

mandochka-0.1.0/MANIFEST.in

@@ -0,0 +1,23 @@
+include LICENSE
+include README.md
+include pyproject.toml
+
+recursive-include src/mandochka *.json *.py
+recursive-include src/elyb *.json *.py
+recursive-include docs *
+
+exclude tests/*
+prune tests
+prune ElyxBuilder-main
+prune pluginmanager-canary
+
+global-exclude __pycache__
+global-exclude *.py[cod]
+global-exclude *.dex
+global-exclude *.jar
+global-exclude *.class
+global-exclude *.eaf
+global-exclude *.zip
+global-exclude .git*
+global-exclude .DS_Store
+global-exclude Thumbs.db

mandochka-0.1.0/PKG-INFO

@@ -0,0 +1,197 @@
+Metadata-Version: 2.4
+Name: mandochka
+Version: 0.1.0
+Summary: High-performance plugin builder for ElyxCore with native D8/Javac DEX compilation and incremental architecture
+Author: Mandochka Team
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/shareui/Mandochka
+Project-URL: Repository, https://github.com/shareui/Mandochka
+Project-URL: Issues, https://github.com/shareui/Mandochka/issues
+Project-URL: Documentation, https://github.com/shareui/Mandochka#readme
+Keywords: elyx,elyxbuilder,plugin,builder,d8,javac,dex,android,compiler,fast,exteragram,ayugram
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Compilers
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: orjson>=3.9.0
+Requires-Dist: xxhash>=3.3.0
+Requires-Dist: isal>=1.5.0
+Provides-Extra: crypto
+Requires-Dist: pyzipper>=0.3.6; extra == "crypto"
+Provides-Extra: all
+Requires-Dist: pyzipper>=0.3.6; extra == "all"
+Dynamic: license-file
+
+# Mandochka ⚡
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python: >=3.10](https://img.shields.io/badge/python-%3E%3D3.10-blue.svg)](pyproject.toml)
+
+**Mandochka** — высокопроизводительный инструмент сборки плагинов для **ElyxCore** (exteraGram, AyuGram, exteraless и др.), форк ElyxBuilder с полной переработкой под **максимальную производительность** и **нативную интеграцию с D8/Javac (DEX)** без необходимости писать костыльные скрипты-обёртки, как это приходилось делать в `pluginmanager-canary`.
+
+---
+
+## В чём проблема ElyxBuilder и почему появилась Mandochka?
+
+В оригинальном `ElyxBuilder`:
+1. **Полное отсутствие поддержки DEX/Java**: если плагину требовался нативный Java DEX мост (как в `pluginmanager-canary` для SIMD/DEX ускорения векторных моделей или хуков), разработчикам приходилось:
+   - Вручную писать сложные скрипты `build-dex.sh` и `build-dex.bat` на 130+ строк.
+   - Искать JDK, javac, Android SDK или писать скрипты скачивания `r8.jar` через PowerShell/curl.
+   - Компилировать стабы (`compile_stubs`) вручную в два этапа.
+   - Оборачивать `elyb build` во внешние скрипты `build-uv.sh` / `build-uv.bat`.
+   - Терпеть отсутствие инкрементального кэширования для Java/DEX (каждый запуск компилировал всё заново).
+2. **Экстремально медленная компиляция Python**:
+   - ElyxBuilder для каждого `.py` файла запускал отдельный процесс `python -c "import py_compile..."`. При 50–100 файлах это занимало **15–20 секунд**.
+3. **Недописанный интерпретатор DSL**:
+   - Команда `elyb script` падала с `ModuleNotFoundError: No module named 'elyb.elyxdsl.interpreter'`.
+
+---
+
+## Что даёт Mandochka?
+
+### 1. Нативная интеграция с D8 / Javac («без извращений»)
+- **Zero-config автоопределение**: если в проекте есть `dex_src/` или `java_src/`, Mandochka сама всё скомпилирует в `.dex`.
+- **Автопоиск компиляторов**: автоматически находит `javac` в PATH, `JAVA_HOME`, Scoop (`temurin17-jdk` и др.), Program Files и системных путях Linux/macOS.
+- **Автопоиск и автозагрузка D8/R8**: находит `d8` в Android SDK `build-tools`, либо **автоматически скачивает официальный `r8.jar`** с Google Maven в глобальный кэш `~/.mandochka/bin/r8.jar`. Больше никаких ручных скачиваний!
+- **Поддержка Stubs**: двухэтапная компиляция стабов (`compile_stubs/`) и внешних `.jar` библиотек из коробки.
+- **Инкрементальный кэш DEX**: если Java-файлы и стабы не менялись, проверка занимает **< 15 мс**.
+- **Команда `mandochka dex`**: отдельная удобная команда для прямой сборки DEX без упаковки всего плагина.
+
+### 2. Максимальная производительность
+- **Пакетная и многопоточная компиляция Python 3.11**:
+  - Нативная компиляция в памяти при запуске под Python 3.11.
+  - Высокоскоростной батч-воркер через потоки/процессы: **100+ файлов компилируются за ~150 мс** вместо 15 секунд.
+- **Многопоточная проверка AST (`-a`)** и параллельная обфускация (`-o`).
+- **Сверхбыстрая повторная сборка**: проект из 150 файлов пересобирается всего за **~170 миллисекунд**!
+- **Бенчмарк фаз (`-b` / `--benchmark`)**: детальный отчёт о времени каждой стадии (dex, ast, pyc, pack) в миллисекундах.
+
+### 3. Полная совместимость и сохранение возможностей
+- Псевдонимы команд: `mandochka`, `mando`, `elyb` (полная обратная совместимость со всеми существующими скриптами и CI!).
+- Поддержка `refmap.json`, `refmap.yml`, `config.yml`, `.mandochka/` и `.elyxbuilder/`.
+- Полный набор команд: `new`, `build`, `dex`, `doctor`, `cached`, `stats`, `watch`, `ignore`, `script`.
+- **Полнофункциональный интерпретатор `.edsl`** для автоматизации сборки.
+
+---
+
+## Сравнение производительности
+
+| Сценарий | ElyxBuilder | Mandochka | Ускорение |
+|---|---|---|---|
+| Сборка плагина (~150 файлов) без кэша | ~18.5 с | **~1.2 с** | **~15x быстрее** |
+| Инкрементальная пересборка (кэш hit) | ~3.2 с | **~0.17 с (170 мс)** | **~19x быстрее** |
+| Сборка Java в DEX (3 файла + стабы) | Вручную скриптами (~4.5 с) | **Нативно (~1.0 с)** | **Автоматически** |
+| Повторный DEX (кэш hit) | Перекомпиляция (~4.5 с) | **~0.01 с (10 мс)** | **Мгновенно** |
+
+---
+
+## Установка
+
+```bash
+git clone https://github.com/shareui/Mandochka.git
+cd Mandochka
+pip install -e .
+```
+
+Проверьте готовность системы:
+```bash
+mandochka doctor
+```
+
+---
+
+## Быстрый старт
+
+### Создание плагина с Java DEX мостом:
+```bash
+mandochka new -g -n "MyPlugin" -a "Nickname" --with-dex
+cd Myplugin
+```
+
+### Сборка плагина:
+```bash
+# Скомпилирует Python 3.11 bytecode + Java DEX + упакует в builds/MyPlugin-0.1.0-3.11.eaf
+mandochka build -c 2 -b
+```
+
+### Отдельная компиляция только DEX:
+```bash
+mandochka dex -v
+```
+
+### Просмотр статуса кэша:
+```bash
+mandochka cached
+```
+
+---
+
+## Конфигурация (`config.yml`)
+
+```yaml
+zipFormat: eaf
+source: myplugin/src
+buildNameUncompiled: "{name}-{version}"
+buildNameCompiled: "{name}-{version}-3.11"
+ignoreAll:
+  - myplugin/.mandochka/cache/*
+compilationIgnore:
+  - myplugin/src/main.py
+
+# Нативная интеграция DEX / Java
+dex:
+  enabled: true
+  source: myplugin/dex_src
+  stubs: myplugin/compile_stubs
+  output: myplugin/res/dex/classes.dex
+  minApi: 26
+  targetJava: 8
+  autoDownloadR8: true
+
+obfuscationConfig:
+  stripDocstrings: true
+  removeLogs: true
+  renameLocals: true
+  encodeStrings: true
+  encodeNumbers: true
+```
+
+---
+
+## CLI Справка
+
+- `mandochka build`: сборка плагина (`-c [0-2]`, `-a`, `-o`, `-p <method> <pass>`, `--dex`, `--skip-dex`, `-j <jobs>`, `-b`).
+- `mandochka dex`: прямая компиляция Java в Dalvik DEX (`--source`, `--output`, `--stubs`, `--min-api`, `--release`, `--d8`, `--javac`, `-f`, `-c`, `-v`).
+- `mandochka doctor`: диагностика компиляторов и инструментов окружения.
+- `mandochka cached`: статус файлов в кэше Python и DEX.
+- `mandochka stats`: статистика проекта (`builds`, `lines`, `size`, `files`).
+- `mandochka watch`: авто-пересборка при изменениях файлов.
+- `mandochka new`: мастер создания плагина (интерактивный или через `--gen`).
+- `mandochka script`: запуск `.edsl` скриптов автоматизации.
+- `mandochka add-ignore` / `del-ignore`: управление списками игнорирования.
+
+---
+
+## Документация
+
+- [Русская документация](docs/ru/)
+  - [Интеграция с D8 / Javac](docs/ru/dex.md)
+  - [Сборка плагинов](docs/ru/build.md)
+  - [Команды и утилиты](docs/ru/commands.md)
+- [English Documentation](docs/en/en.md)
+
+---
+
+## Лицензия
+
+MIT License. См. файл [LICENSE](LICENSE).

mandochka-0.1.0/README.md

@@ -0,0 +1,162 @@
+# Mandochka ⚡
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Python: >=3.10](https://img.shields.io/badge/python-%3E%3D3.10-blue.svg)](pyproject.toml)
+
+**Mandochka** — высокопроизводительный инструмент сборки плагинов для **ElyxCore** (exteraGram, AyuGram, exteraless и др.), форк ElyxBuilder с полной переработкой под **максимальную производительность** и **нативную интеграцию с D8/Javac (DEX)** без необходимости писать костыльные скрипты-обёртки, как это приходилось делать в `pluginmanager-canary`.
+
+---
+
+## В чём проблема ElyxBuilder и почему появилась Mandochka?
+
+В оригинальном `ElyxBuilder`:
+1. **Полное отсутствие поддержки DEX/Java**: если плагину требовался нативный Java DEX мост (как в `pluginmanager-canary` для SIMD/DEX ускорения векторных моделей или хуков), разработчикам приходилось:
+   - Вручную писать сложные скрипты `build-dex.sh` и `build-dex.bat` на 130+ строк.
+   - Искать JDK, javac, Android SDK или писать скрипты скачивания `r8.jar` через PowerShell/curl.
+   - Компилировать стабы (`compile_stubs`) вручную в два этапа.
+   - Оборачивать `elyb build` во внешние скрипты `build-uv.sh` / `build-uv.bat`.
+   - Терпеть отсутствие инкрементального кэширования для Java/DEX (каждый запуск компилировал всё заново).
+2. **Экстремально медленная компиляция Python**:
+   - ElyxBuilder для каждого `.py` файла запускал отдельный процесс `python -c "import py_compile..."`. При 50–100 файлах это занимало **15–20 секунд**.
+3. **Недописанный интерпретатор DSL**:
+   - Команда `elyb script` падала с `ModuleNotFoundError: No module named 'elyb.elyxdsl.interpreter'`.
+
+---
+
+## Что даёт Mandochka?
+
+### 1. Нативная интеграция с D8 / Javac («без извращений»)
+- **Zero-config автоопределение**: если в проекте есть `dex_src/` или `java_src/`, Mandochka сама всё скомпилирует в `.dex`.
+- **Автопоиск компиляторов**: автоматически находит `javac` в PATH, `JAVA_HOME`, Scoop (`temurin17-jdk` и др.), Program Files и системных путях Linux/macOS.
+- **Автопоиск и автозагрузка D8/R8**: находит `d8` в Android SDK `build-tools`, либо **автоматически скачивает официальный `r8.jar`** с Google Maven в глобальный кэш `~/.mandochka/bin/r8.jar`. Больше никаких ручных скачиваний!
+- **Поддержка Stubs**: двухэтапная компиляция стабов (`compile_stubs/`) и внешних `.jar` библиотек из коробки.
+- **Инкрементальный кэш DEX**: если Java-файлы и стабы не менялись, проверка занимает **< 15 мс**.
+- **Команда `mandochka dex`**: отдельная удобная команда для прямой сборки DEX без упаковки всего плагина.
+
+### 2. Максимальная производительность
+- **Пакетная и многопоточная компиляция Python 3.11**:
+  - Нативная компиляция в памяти при запуске под Python 3.11.
+  - Высокоскоростной батч-воркер через потоки/процессы: **100+ файлов компилируются за ~150 мс** вместо 15 секунд.
+- **Многопоточная проверка AST (`-a`)** и параллельная обфускация (`-o`).
+- **Сверхбыстрая повторная сборка**: проект из 150 файлов пересобирается всего за **~170 миллисекунд**!
+- **Бенчмарк фаз (`-b` / `--benchmark`)**: детальный отчёт о времени каждой стадии (dex, ast, pyc, pack) в миллисекундах.
+
+### 3. Полная совместимость и сохранение возможностей
+- Псевдонимы команд: `mandochka`, `mando`, `elyb` (полная обратная совместимость со всеми существующими скриптами и CI!).
+- Поддержка `refmap.json`, `refmap.yml`, `config.yml`, `.mandochka/` и `.elyxbuilder/`.
+- Полный набор команд: `new`, `build`, `dex`, `doctor`, `cached`, `stats`, `watch`, `ignore`, `script`.
+- **Полнофункциональный интерпретатор `.edsl`** для автоматизации сборки.
+
+---
+
+## Сравнение производительности
+
+| Сценарий | ElyxBuilder | Mandochka | Ускорение |
+|---|---|---|---|
+| Сборка плагина (~150 файлов) без кэша | ~18.5 с | **~1.2 с** | **~15x быстрее** |
+| Инкрементальная пересборка (кэш hit) | ~3.2 с | **~0.17 с (170 мс)** | **~19x быстрее** |
+| Сборка Java в DEX (3 файла + стабы) | Вручную скриптами (~4.5 с) | **Нативно (~1.0 с)** | **Автоматически** |
+| Повторный DEX (кэш hit) | Перекомпиляция (~4.5 с) | **~0.01 с (10 мс)** | **Мгновенно** |
+
+---
+
+## Установка
+
+```bash
+git clone https://github.com/shareui/Mandochka.git
+cd Mandochka
+pip install -e .
+```
+
+Проверьте готовность системы:
+```bash
+mandochka doctor
+```
+
+---
+
+## Быстрый старт
+
+### Создание плагина с Java DEX мостом:
+```bash
+mandochka new -g -n "MyPlugin" -a "Nickname" --with-dex
+cd Myplugin
+```
+
+### Сборка плагина:
+```bash
+# Скомпилирует Python 3.11 bytecode + Java DEX + упакует в builds/MyPlugin-0.1.0-3.11.eaf
+mandochka build -c 2 -b
+```
+
+### Отдельная компиляция только DEX:
+```bash
+mandochka dex -v
+```
+
+### Просмотр статуса кэша:
+```bash
+mandochka cached
+```
+
+---
+
+## Конфигурация (`config.yml`)
+
+```yaml
+zipFormat: eaf
+source: myplugin/src
+buildNameUncompiled: "{name}-{version}"
+buildNameCompiled: "{name}-{version}-3.11"
+ignoreAll:
+  - myplugin/.mandochka/cache/*
+compilationIgnore:
+  - myplugin/src/main.py
+
+# Нативная интеграция DEX / Java
+dex:
+  enabled: true
+  source: myplugin/dex_src
+  stubs: myplugin/compile_stubs
+  output: myplugin/res/dex/classes.dex
+  minApi: 26
+  targetJava: 8
+  autoDownloadR8: true
+
+obfuscationConfig:
+  stripDocstrings: true
+  removeLogs: true
+  renameLocals: true
+  encodeStrings: true
+  encodeNumbers: true
+```
+
+---
+
+## CLI Справка
+
+- `mandochka build`: сборка плагина (`-c [0-2]`, `-a`, `-o`, `-p <method> <pass>`, `--dex`, `--skip-dex`, `-j <jobs>`, `-b`).
+- `mandochka dex`: прямая компиляция Java в Dalvik DEX (`--source`, `--output`, `--stubs`, `--min-api`, `--release`, `--d8`, `--javac`, `-f`, `-c`, `-v`).
+- `mandochka doctor`: диагностика компиляторов и инструментов окружения.
+- `mandochka cached`: статус файлов в кэше Python и DEX.
+- `mandochka stats`: статистика проекта (`builds`, `lines`, `size`, `files`).
+- `mandochka watch`: авто-пересборка при изменениях файлов.
+- `mandochka new`: мастер создания плагина (интерактивный или через `--gen`).
+- `mandochka script`: запуск `.edsl` скриптов автоматизации.
+- `mandochka add-ignore` / `del-ignore`: управление списками игнорирования.
+
+---
+
+## Документация
+
+- [Русская документация](docs/ru/)
+  - [Интеграция с D8 / Javac](docs/ru/dex.md)
+  - [Сборка плагинов](docs/ru/build.md)
+  - [Команды и утилиты](docs/ru/commands.md)
+- [English Documentation](docs/en/en.md)
+
+---
+
+## Лицензия
+
+MIT License. См. файл [LICENSE](LICENSE).

mandochka-0.1.0/docs/en/en.md

@@ -0,0 +1,123 @@
+# Mandochka — Documentation
+
+**Mandochka** is a high-performance, next-generation plugin builder for **ElyxCore** (exteraGram, AyuGram, exteraless, etc.), forked from ElyxBuilder and rewritten for maximum speed and first-class native Android D8 & Javac DEX compilation.
+
+---
+
+## Why Mandochka?
+
+In standard ElyxBuilder:
+- DEX / Java compilation was completely unsupported. Complex plugins (such as `pluginmanager-canary`) had to invent custom multi-platform shell/batch scripts, download `r8.jar`, compile stubs, and wrap everything in brittle external scripts.
+- Python compilation spawned a new `python -c` process for every single file sequentially, taking 15–20 seconds on medium-sized plugins.
+- Script runner (`.edsl`) lacked an interpreter implementation.
+
+Mandochka solves all of these problems:
+1. **Zero-overhead native D8 / Javac integration**:
+   - Automatic discovery of JDK (`javac`, `java`) and Android SDK build-tools (`d8`).
+   - Automatic on-demand download and global caching of official `r8.jar` from Google Maven if Android SDK is absent.
+   - Automatic detection of `dex_src/` or `java_src/` and `compile_stubs/`.
+   - Dedicated standalone subcommand `mandochka dex` and unified `mandochka build`.
+   - Incremental caching for Java / DEX compilation (< 15 ms on cached runs).
+2. **Maximum Performance**:
+   - Batch & in-process Python 3.11 bytecode compilation using worker pools.
+   - Parallel AST syntax checking (`-a`) and parallel obfuscation.
+   - Complete project build in < 200 ms on cached runs and ~1.5s on clean runs.
+   - Benchmark profiling mode (`-b` / `--benchmark`).
+3. **100% Drop-in Compatibility**:
+   - Supports `refmap.json`, `refmap.yml`, `config.yml`, `.mandochka/`, `.elyxbuilder/`.
+   - CLI command aliases: `mandochka`, `mando`, and `elyb`.
+   - Complete feature parity: `new`, `build`, `cached`, `stats`, `watch`, `ignore`, `script`, `doctor`.
+   - Full working `.edsl` scripting engine interpreter.
+
+---
+
+## Installation
+
+```bash
+git clone https://github.com/shareui/Mandochka.git
+cd Mandochka
+pip install -e .
+```
+
+Verify your environment:
+```bash
+mandochka doctor
+```
+
+---
+
+## Quick Start
+
+### Create a new plugin with native Java DEX bridge:
+```bash
+mandochka new -g -n "MySuperPlugin" -a "Nickname" --with-dex
+cd Mysuperplugin
+```
+
+### Build plugin into `.eaf`:
+```bash
+mandochka build -c 2 -b
+```
+
+### Compile only the DEX binary:
+```bash
+mandochka dex
+```
+
+### Inspect cache status:
+```bash
+mandochka cached
+```
+
+---
+
+## Configuration (`config.yml`)
+
+```yaml
+zipFormat: eaf
+source: myplugin/src
+buildNameUncompiled: "{name}-{version}"
+buildNameCompiled: "{name}-{version}-3.11"
+ignoreAll:
+  - myplugin/.mandochka/cache/*
+compilationIgnore:
+  - myplugin/src/main.py
+
+# Native DEX / Java integration
+dex:
+  enabled: true
+  source: myplugin/dex_src
+  stubs: myplugin/compile_stubs
+  output: myplugin/res/dex/classes.dex
+  minApi: 26
+  targetJava: 8
+  autoDownloadR8: true
+
+obfuscationConfig:
+  stripDocstrings: true
+  removeLogs: true
+  renameLocals: true
+  encodeStrings: true
+  encodeNumbers: true
+```
+
+---
+
+## CLI Reference
+
+- `mandochka doctor`: diagnose compiler toolchains (JDK, Javac, D8, Python 3.11).
+- `mandochka build [options]`: build plugin into `.eaf` or `.zip`.
+  - `-c [0|1|2]`: Python 3.11 bytecode compilation.
+  - `-a`: parallel AST syntax validation.
+  - `-o [files...]`: AST obfuscation.
+  - `-p <method> <pass>`: encryption (`aes-256`, `aes-128`, `zipcrypto`).
+  - `--dex`: force DEX build.
+  - `--skip-dex`: skip DEX build.
+  - `-j N`: number of parallel workers (default: 8).
+  - `-b`: benchmark timing report.
+- `mandochka dex [options]`: standalone Java to DEX compilation.
+- `mandochka cached`: view status of cached Python and DEX files.
+- `mandochka stats [builds|lines|size|files]`: project statistics.
+- `mandochka watch [interval]`: watch filesystem and auto-rebuild.
+- `mandochka new`: interactive or non-interactive scaffolding wizard.
+- `mandochka script <name> [args...]`: execute `.edsl` automation scripts.

mandochka-0.1.0/docs/ru/build.md

@@ -0,0 +1,58 @@
+# Сборка плагинов в Mandochka (`mandochka build`)
+
+Команда `mandochka build` предназначена для высокопроизводительной сборки плагинов ElyxCore в архивы (`.eaf` или `.zip`).
+
+---
+
+## Ключевые оптимизации производительности
+
+1. **Пакетная и многопоточная компиляция Python 3.11**:
+   - В ElyxBuilder каждый `.py` файл компилировался через отдельный запуск процесса `python -c "..."`. При 50-100 файлах это занимало до 15–20 секунд.
+   - В Mandochka компиляция выполняется либо **нативно в памяти** (если запущен Python 3.11), либо через **высокоскоростной батч-воркер** с пулом потоков. 100 файлов компилируются за **~150 миллисекунд**!
+2. **Параллельная проверка AST**:
+   - Проверка синтаксиса выполняется параллельно всеми ядрами процессора (`--jobs`).
+3. **Параллельная обфускация**:
+   - Анализ символов и трансформация AST распараллелены.
+4. **Многоуровневый инкрементальный кэш**:
+   - Отслеживание mtime, размера и уровня оптимизации.
+   - Повторная сборка без изменений занимает **~150 мс** на крупном проекте.
+
+---
+
+## Флаги команды `build`
+
+| Флаг | Описание |
+|---|---|
+| `-c [LEVEL]`, `--compile [LEVEL]` | Компиляция `.py` в `.pyc` (уровень оптимизации 0, 1 или 2; по умолчанию 1) |
+| `-a`, `--ast` | Быстрая многопоточная проверка синтаксиса AST без компиляции |
+| `-v`, `--verbose` | Подробный лог сборки |
+| `-r`, `--reset` | Очистка кэша компиляции перед сборкой |
+| `-p METHOD PASS`, `--password` | Шифрование архива (`aes-128`, `aes-192`, `aes-256`, `zipcrypto`) |
+| `-o [FILES...]`, `--obfuscation` | Обфускация исходного кода (всего или указанных файлов) |
+| `--dex` | Принудительно скомпилировать DEX |
+| `--skip-dex`, `--no-dex` | Пропустить компиляцию DEX |
+| `-j N`, `--jobs N` | Количество параллельных воркеров (по умолчанию: 8) |
+| `-b`, `--benchmark` | Вывести точный тайминг фаз сборки в миллисекундах |
+| `--no-assets` | Исключить файлы из `optionalAssets` |
+| `-nf`, `--no-folder` | Исключить каталог builder из архива |
+| `-ni`, `--no-info` | Не внедрять блок метаинформации о сборке |
+| `-sv VER [APPEND]`, `--static-version` | Установить static_ver; если APPEND=true, версия добавится к имени архива |
+| `-sc PKG [NAME]`, `--static-client` | Установить целевой клиент в манифест |
+
+---
+
+## Примеры
+
+```bash
+# Стандартная быстрая сборка с байткодом
+mandochka build -c 2
+
+# С бенчмарком фаз (dex, pyc, pack)
+mandochka build -c 2 -b
+
+# С обфускацией и проверкой AST
+mandochka build -c 2 -o -b
+
+# Зашифрованный архив AES-256
+mandochka build -c 2 -p aes-256 MyPassword123
+```

mandochka-0.1.0/docs/ru/commands.md

@@ -0,0 +1,43 @@
+# Команды и возможности Mandochka
+
+## `mandochka doctor`
+Диагностическая утилита, которая проверяет готовность системы к сборке плагинов:
+- Версию и путь к интерпретатору Python 3.11.
+- Наличие компилятора Java (`javac`) и версии JDK.
+- Наличие среды исполнения Java (`java`).
+- Наличие утилиты Android D8 (в Android SDK или standalone `r8.jar`).
+- Доступность библиотек PyYAML и PyZipper.
+
+---
+
+## `mandochka cached`
+Отображает детальный статус кэша:
+- Для каждого `.py` файла: `[cached]` (актуален), `[changed]` (изменён, требует перекомпиляции), `[missing]` (отсутствует в кэше) или `[ignored]`.
+- Размер и время создания каждого файла.
+- Статус кэша DEX: отслеживаемые Java-исходники, стабы, целевые версии API.
+
+---
+
+## `mandochka stats`
+Статистика проекта:
+- `mandochka stats builds`: количество успешных, скомпилированных, нескомпилированных и упавших сборок.
+- `mandochka stats lines [-a]`: подсчёт строк кода по файлам.
+- `mandochka stats size [-a]`: размеры файлов.
+- `mandochka stats files [-a]`: распределение файлов по расширениям.
+
+---
+
+## `mandochka watch [interval]`
+Режим автоматической пересборки:
+- Отслеживает изменения в `.py`, `.java`, `.json`, `.yml`, `.dex`.
+- Мгновенно перезапускает `build` при сохранении файлов в IDE.
+- Горячие клавиши: `r` — принудительно пересобрать, `q` — выйти.
+
+---
+
+## `mandochka script <name> [args...]`
+Исполнение скриптов автоматизации на языке `.edsl`:
+- Встроенный полнофункциональный интерпретатор.
+- Поддержка функций `sh()`, `capture()`, `prompt()`, `confirm()`, `background()`, `wait()`, `pipe()`.
+- Доступ к переменным окружения, `meta()`, `config()`, `refmap()`.
+- Параллельное исполнение шагов (`parallel { ... }`), таймауты (`timeout(N) { ... }`) и перезапуски (`retry(N) { ... }`).