codex-bot 0.1.0__tar.gz → 0.1.1__tar.gz

codex_bot-0.1.1/.github/workflows/publish.yml

@@ -0,0 +1,34 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build-n-publish:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/codex-bot
+    permissions:
+      id-token: write
+      contents: read
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: "3.11"
+
+    - name: Install build dependencies
+      run: python -m pip install build
+
+    - name: Build package
+      run: python -m build
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

{codex_bot-0.1.0 → codex_bot-0.1.1}/.pre-commit-config.yaml

@@ -1,38 +1,38 @@
-repos:
-  - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
-    hooks:
-      - id: trailing-whitespace
-      - id: end-of-file-fixer
-      - id: check-yaml
-      - id: check-json
-      - id: check-added-large-files
-        args: ['--maxkb=2000']
-      - id: check-merge-conflict
-
-  - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.9.6
-    hooks:
-      - id: ruff
-        args: [--fix]
-      - id: ruff-format
-
-  - repo: https://github.com/igorshubovych/markdownlint-cli
-    rev: v0.44.0
-    hooks:
-      - id: markdownlint
-        args: ["--fix", "--disable", "MD013"]
-
-  - repo: https://github.com/PyCQA/bandit
-    rev: 1.8.2
-    hooks:
-      - id: bandit
-        args: ["-c", "pyproject.toml"]
-        additional_dependencies: ["bandit[toml]"]
-
-  # 2. Поиск "забытых" секретов и паролей (усиленный)
-  - repo: https://github.com/Yelp/detect-secrets
-    rev: v1.5.0
-    hooks:
-      - id: detect-secrets
-        # Baseline will be added after manual creation
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-json
+      - id: check-added-large-files
+        args: ['--maxkb=2000']
+      - id: check-merge-conflict
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.9.6
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/igorshubovych/markdownlint-cli
+    rev: v0.44.0
+    hooks:
+      - id: markdownlint
+        args: ["--fix", "--disable", "MD013"]
+
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.8.2
+    hooks:
+      - id: bandit
+        args: ["-c", "pyproject.toml"]
+        additional_dependencies: ["bandit[toml]"]
+
+  # 2. Поиск "забытых" секретов и паролей (усиленный)
+  - repo: https://github.com/Yelp/detect-secrets
+    rev: v1.5.0
+    hooks:
+      - id: detect-secrets
+        # Baseline will be added after manual creation

{codex_bot-0.1.0 → codex_bot-0.1.1}/CHANGELOG.md

@@ -1,29 +1,38 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [0.1.0] - 2025-03-09
-
-### Added
-- **Initial Library Release**: Migration and adaptation of core infrastructure from production projects into a reusable feature-based framework.
-- **Feature-based Architecture**: Implementation of `BaseBotOrchestrator` and `Director` for stateless UI management.
-- **Redis Integration**: Stream processing, consumer groups support, and Redis-based dispatching.
-- **FSM Enhancements**: `GarbageStateRegistry` for automatic UI cleanup and advanced state management.
-- **Unified View System**: `ViewSender` and `UnifiedViewDTO` for consistent message rendering across different platforms.
-- **I18n Engine**: Custom Fluent-based locales compiler with isolation support.
-- **CLI Tools**: Scaffolding templates for rapid feature development.
-- **Multi-language Documentation**: Comprehensive guides and API references in English and Russian.
-- **DevOps Infrastructure**: Pre-commit hooks, Ruff/Mypy configurations, and GitHub Actions for docs.
-- **Final Polish**: Refined `Director` logic, `BotBuilder` factory, and `RouterBuilder` for better stability.
-- **Enhanced State Management**: Improved `StateManager` and `FSM` handlers for more robust session control.
-- **Redis Dispatcher Optimization**: Fine-tuned stream processing and error handling in `RedisDispatcher`.
-- **Test Coverage**: Added comprehensive unit tests for all core modules.
-
-### Changed
-- Refactored production code into a modular library structure.
-- Standardized DTOs and protocols for better extensibility.
-- Optimized Redis Stream processing for high-load scenarios.
-- Improved type safety across the entire codebase (Mypy strict mode).
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.1] - 2025-03-09
+
+### Added
+- **CI/CD Automation**: Integrated GitHub Actions for automated publishing to PyPI using Trusted Publishers (OIDC).
+- **Project Metadata**: Added comprehensive project URLs (Documentation, Repository, Issues, Changelog) to `pyproject.toml` for better PyPI presentation.
+
+### Fixed
+- **Documentation Links**: Corrected broken documentation links in `README.md` to point to the actual GitHub Pages site.
+
+## [0.1.0] - 2025-03-09
+
+### Added
+- **Initial Library Release**: Migration and adaptation of core infrastructure from production projects into a reusable feature-based framework.
+- **Feature-based Architecture**: Implementation of `BaseBotOrchestrator` and `Director` for stateless UI management.
+- **Redis Integration**: Stream processing, consumer groups support, and Redis-based dispatching.
+- **FSM Enhancements**: `GarbageStateRegistry` for automatic UI cleanup and advanced state management.
+- **Unified View System**: `ViewSender` and `UnifiedViewDTO` for consistent message rendering across different platforms.
+- **I18n Engine**: Custom Fluent-based locales compiler with isolation support.
+- **CLI Tools**: Scaffolding templates for rapid feature development.
+- **Multi-language Documentation**: Comprehensive guides and API references in English and Russian.
+- **DevOps Infrastructure**: Pre-commit hooks, Ruff/Mypy configurations, and GitHub Actions for docs.
+- **Final Polish**: Refined `Director` logic, `BotBuilder` factory, and `RouterBuilder` for better stability.
+- **Enhanced State Management**: Improved `StateManager` and `FSM` handlers for more robust session control.
+- **Redis Dispatcher Optimization**: Fine-tuned stream processing and error handling in `RedisDispatcher`.
+- **Test Coverage**: Added comprehensive unit tests for all core modules.
+
+### Changed
+- Refactored production code into a modular library structure.
+- Standardized DTOs and protocols for better extensibility.
+- Optimized Redis Stream processing for high-load scenarios.
+- Improved type safety across the entire codebase (Mypy strict mode).

{codex_bot-0.1.0 → codex_bot-0.1.1}/CLAUDE.md

@@ -1,48 +1,48 @@
-# codex-bot — AI Context
-
-Feature-based Aiogram framework library. MIT license, public GitHub.
-
----
-
-## Agent Memory
-
-> **Memory directory:** `C:\Users\prime\.claude\projects\C--install-progect-codex-bot\memory\`
->
-> Агент из любого проекта: читай `MEMORY.md` там — это индекс.
-> Детали в: `architecture.md`, `modules.md`, `fixes.md`
-
----
-
-## Структура пакета
-
-```
-src/codex_bot/
-├── base/               ← BaseBotOrchestrator[T] (ABC), UnifiedViewDTO, ViewResultDTO
-├── director/           ← Director, OrchestratorProtocol, ContainerProtocol, SceneConfig
-├── fsm/                ← BaseStateManager, GarbageStateRegistry, common_fsm_router
-├── sender/             ← ViewSender (stateless), SenderManager, SenderKeys
-├── redis/              ← RedisRouter, BotRedisDispatcher, RedisStreamProcessor
-├── animation/          ← UIAnimationService, AnimationType
-├── helper/             ← ContextHelper
-├── url_signer/         ← UrlSignerService
-└── engine/             ← инфраструктура "под капотом"
-    ├── middlewares/    ← ThrottlingMiddleware, ContainerMiddleware, UserValidationMiddleware
-    ├── discovery/      ← FeatureDiscoveryService (service.py)
-    ├── factory/        ← BotBuilder (bot_builder.py)
-    ├── router_builder/ ← collect_feature_routers, build_main_router (router_builder.py)
-    ├── http/           ← BaseApiClient, ApiClientError (api_client.py)
-    └── i18n/           ← compile_locales (locales_compiler.py)
-```
-
----
-
-## Стандарты (обязательно)
-
-- **Packaging**: Hatchling, PEP 621
-- **Docstrings**: Google style — Args / Returns / Example
-- **Docs**: MkDocs Material + mkdocstrings
-- **DTO**: `frozen=True, arbitrary_types_allowed=True`, мутации через `model_copy(update=...)`
-- **Оркестраторы**: stateless `Generic[PayloadT]`, `director` явный аргумент
-- **Fail Fast**: умный `except ImportError` (проверяем `e.name == module_path`)
-- **Redis**: SET NX вместо EXISTS + SET (атомарно, нет race condition)
-- **SecurityMiddleware**: удалён навсегда (иллюзорная защита + лишний HGETALL)
+# codex-bot — AI Context
+
+Feature-based Aiogram framework library. MIT license, public GitHub.
+
+---
+
+## Agent Memory
+
+> **Memory directory:** `C:\Users\prime\.claude\projects\C--install-progect-codex-bot\memory\`
+>
+> Агент из любого проекта: читай `MEMORY.md` там — это индекс.
+> Детали в: `architecture.md`, `modules.md`, `fixes.md`
+
+---
+
+## Структура пакета
+
+```
+src/codex_bot/
+├── base/               ← BaseBotOrchestrator[T] (ABC), UnifiedViewDTO, ViewResultDTO
+├── director/           ← Director, OrchestratorProtocol, ContainerProtocol, SceneConfig
+├── fsm/                ← BaseStateManager, GarbageStateRegistry, common_fsm_router
+├── sender/             ← ViewSender (stateless), SenderManager, SenderKeys
+├── redis/              ← RedisRouter, BotRedisDispatcher, RedisStreamProcessor
+├── animation/          ← UIAnimationService, AnimationType
+├── helper/             ← ContextHelper
+├── url_signer/         ← UrlSignerService
+└── engine/             ← инфраструктура "под капотом"
+    ├── middlewares/    ← ThrottlingMiddleware, ContainerMiddleware, UserValidationMiddleware
+    ├── discovery/      ← FeatureDiscoveryService (service.py)
+    ├── factory/        ← BotBuilder (bot_builder.py)
+    ├── router_builder/ ← collect_feature_routers, build_main_router (router_builder.py)
+    ├── http/           ← BaseApiClient, ApiClientError (api_client.py)
+    └── i18n/           ← compile_locales (locales_compiler.py)
+```
+
+---
+
+## Стандарты (обязательно)
+
+- **Packaging**: Hatchling, PEP 621
+- **Docstrings**: Google style — Args / Returns / Example
+- **Docs**: MkDocs Material + mkdocstrings
+- **DTO**: `frozen=True, arbitrary_types_allowed=True`, мутации через `model_copy(update=...)`
+- **Оркестраторы**: stateless `Generic[PayloadT]`, `director` явный аргумент
+- **Fail Fast**: умный `except ImportError` (проверяем `e.name == module_path`)
+- **Redis**: SET NX вместо EXISTS + SET (атомарно, нет race condition)
+- **SecurityMiddleware**: удалён навсегда (иллюзорная защита + лишний HGETALL)

{codex_bot-0.1.0 → codex_bot-0.1.1}/PKG-INFO

@@ -1,7 +1,12 @@
 Metadata-Version: 2.4
 Name: codex-bot
-Version: 0.1.0
+Version: 0.1.1
 Summary: Feature-based Aiogram framework library — reusable infrastructure for Telegram bots
+Project-URL: Homepage, https://github.com/codexdlc/codex-bot
+Project-URL: Documentation, https://codexdlc.github.io/codex-bot/
+Project-URL: Repository, https://github.com/codexdlc/codex-bot
+Project-URL: Changelog, https://github.com/codexdlc/codex-bot/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/codexdlc/codex-bot/issues
 Author: Codex Team
 License: MIT
 License-File: LICENSE
@@ -100,8 +105,8 @@ builder.run_polling()
 
 ## 📚 Documentation
 
-- [English Documentation](https://codex-team.github.io/codex_bot/en_EN/)
-- [Русская документация](https://codex-team.github.io/codex_bot/ru_RU/)
+- [English Documentation](https://codexdlc.github.io/codex-bot/en_EN/)
+- [Русская документация](https://codexdlc.github.io/codex-bot/ru_RU/)
 - [**Changelog**](CHANGELOG.md) — see what's new in the latest versions.
 
 ---

{codex_bot-0.1.0 → codex_bot-0.1.1}/README.md

@@ -55,8 +55,8 @@ builder.run_polling()
 
 ## 📚 Documentation
 
-- [English Documentation](https://codex-team.github.io/codex_bot/en_EN/)
-- [Русская документация](https://codex-team.github.io/codex_bot/ru_RU/)
+- [English Documentation](https://codexdlc.github.io/codex-bot/en_EN/)
+- [Русская документация](https://codexdlc.github.io/codex-bot/ru_RU/)
 - [**Changelog**](CHANGELOG.md) — see what's new in the latest versions.
 
 ---

{codex_bot-0.1.0 → codex_bot-0.1.1}/docs/DOCUMENTATION_STANDARD.md

@@ -1,142 +1,142 @@
-# 🧭 Documentation Standard for codex-bot
-
-> **AUTHORITY:** This document defines how documentation is written, structured, and maintained in the `codex-bot` library.
-
----
-
-## 1. 📜 Core Philosophy
-
-We maintain documentation in **two languages** to ensure international accessibility while keeping the local community engaged.
-
-### 🇬🇧 English (Primary / Technical Truth)
-
-- **Mandatory for:** All Pull Requests and technical specifications.
-- **Location:**
-  - `docs/api/` — Technical API reference (auto-generated from docstrings).
-  - `docs/en_EN/` — Conceptual guides and architectural mirroring.
-- **Content:**
-  - Full technical specifications.
-  - API documentation (via `docs/api/`).
-  - Code examples and integration guides.
-- **Goal:** Single source of truth. If code contradicts EN docs, it is a bug.
-
-### 🇷🇺 Russian (Secondary / Conceptual Hub)
-
-- **Optional for Contributors:** If you don't speak Russian, write EN docs. Maintainers will add RU translation.
-- **Location:** `docs/ru_RU/` (mirrors folder structure).
-- **Content:**
-  - Conceptual translation (the "why" and "how").
-  - Links to `docs/api/` for technical details instead of duplication.
-  - Architect's mental model and design decision explanations.
-- **Goal:** Help Russian-speaking developers understand the "why" behind the framework's architecture.
-
----
-
-## 2. ☯️ Twin Realms Principle
-
-Documentation languages serve different purposes:
-
-### 🇬🇧 EN = Technical Truth
-
-- **For:** AI generators, external libraries, standards compliance.
-- **Format:** Granular (mirrors `src/codex_bot/` structure).
-- **Contains:**
-  - API Reference (in `docs/api/`).
-  - Mermaid Diagrams (Sequence, Class, ER).
-  - Integration patterns.
-
-### 🇷🇺 RU = Architect's Mind
-
-- **For:** Human developers, system understanding.
-- **Format:** Aggregated (1 folder = 1 README).
-- **Contains:**
-  - **The Why:** Why this solution (e.g., why Stateless Orchestrators) was chosen.
-  - **The Flow:** How data flows through the system (simplified).
-  - **Links:** References to `docs/api/` files for technical details.
-
----
-
-## 3. 🗂️ Structure Mirroring Rule
-
-Documentation structure **MUST** mirror the code structure in `src/codex_bot/`.
-
-### Mapping Example
-
-| Code Location | Documentation Location (EN/RU) |
-|:---|:---|
-| `src/codex_bot/base/` | `docs/[lang]/architecture/base/` |
-| `src/codex_bot/engine/router_builder/` | `docs/[lang]/architecture/engine/router_builder/` |
-| `src/codex_bot/redis/` | `docs/[lang]/architecture/redis/` |
-
-### Why?
-
-- **1:1 Mapping:** Easy to find docs for any code module.
-- **No Orphans:** Prevents documentation from getting lost.
-- **Refactoring Safety:** When code moves, docs move with it.
-
----
-
-## 4. 🧭 Navigation Standard
-
-Every documentation file must be easily navigable.
-
-### Breadcrumbs (Mandatory)
-
-Every file **MUST** start with a navigation header:
-
-```markdown
-[⬅️ Back](../README.md) | [🏠 Docs Root](../../README.md)
-```
-
-- **Back:** Links to the current directory's `README.md`.
-- **Docs Root:** Links to the documentation root (`docs/README.md`).
-
-### Index Files (README.md)
-
-Every directory **MUST** have a `README.md` acting as a navigation hub.
-
-**Required Structure:**
-
-1. **Header:** Emoji 📂 + Section Name.
-2. **Navigation:** Breadcrumbs.
-3. **Description:** Short summary (2-3 sentences).
-4. **Map:** Table or list of files in **logical reading order** (not alphabetical).
-
----
-
-## 5. 📝 File Naming & Organization
-
-### Naming Conventions
-
-- **Format:** `snake_case.md` (e.g., `orchestrator_logic.md`).
-- **No Prefixes:** Do NOT use `01_`, `02_` prefixes in filenames.
-- **Reading Order:** Defined in `README.md` map.
-
-### Language Folders
-
-All documents **MUST** reside in:
-
-- `docs/api/` (Technical EN)
-- `docs/en_EN/` (Conceptual EN)
-- `docs/ru_RU/` (Conceptual RU)
-
----
-
-## 6. ✅ Markdown Linting Rules (Strict)
-
-1. **MD047 (End with Newline):** Every file must end with exactly **one newline** (`\n`).
-2. **MD032 (List Spacing):** Blank line before and after any list.
-3. **MD007 (Indentation):** Use **2 spaces** for nested lists.
-
----
-
-## 7. 🚫 Common Mistakes
-
-- **❌ Duplicating Code in RU Docs:** Link to `docs/api/` instead.
-- **❌ Numbered Prefixes:** Use `README.md` map for order.
-- **❌ Missing Breadcrumbs:** Always add the navigation header.
-- **❌ Language-neutral folders:** Use `en_EN` or `ru_RU`.
-
----
-
-**Last Updated:** 2025-02-07
+# 🧭 Documentation Standard for codex-bot
+
+> **AUTHORITY:** This document defines how documentation is written, structured, and maintained in the `codex-bot` library.
+
+---
+
+## 1. 📜 Core Philosophy
+
+We maintain documentation in **two languages** to ensure international accessibility while keeping the local community engaged.
+
+### 🇬🇧 English (Primary / Technical Truth)
+
+- **Mandatory for:** All Pull Requests and technical specifications.
+- **Location:**
+  - `docs/api/` — Technical API reference (auto-generated from docstrings).
+  - `docs/en_EN/` — Conceptual guides and architectural mirroring.
+- **Content:**
+  - Full technical specifications.
+  - API documentation (via `docs/api/`).
+  - Code examples and integration guides.
+- **Goal:** Single source of truth. If code contradicts EN docs, it is a bug.
+
+### 🇷🇺 Russian (Secondary / Conceptual Hub)
+
+- **Optional for Contributors:** If you don't speak Russian, write EN docs. Maintainers will add RU translation.
+- **Location:** `docs/ru_RU/` (mirrors folder structure).
+- **Content:**
+  - Conceptual translation (the "why" and "how").
+  - Links to `docs/api/` for technical details instead of duplication.
+  - Architect's mental model and design decision explanations.
+- **Goal:** Help Russian-speaking developers understand the "why" behind the framework's architecture.
+
+---
+
+## 2. ☯️ Twin Realms Principle
+
+Documentation languages serve different purposes:
+
+### 🇬🇧 EN = Technical Truth
+
+- **For:** AI generators, external libraries, standards compliance.
+- **Format:** Granular (mirrors `src/codex_bot/` structure).
+- **Contains:**
+  - API Reference (in `docs/api/`).
+  - Mermaid Diagrams (Sequence, Class, ER).
+  - Integration patterns.
+
+### 🇷🇺 RU = Architect's Mind
+
+- **For:** Human developers, system understanding.
+- **Format:** Aggregated (1 folder = 1 README).
+- **Contains:**
+  - **The Why:** Why this solution (e.g., why Stateless Orchestrators) was chosen.
+  - **The Flow:** How data flows through the system (simplified).
+  - **Links:** References to `docs/api/` files for technical details.
+
+---
+
+## 3. 🗂️ Structure Mirroring Rule
+
+Documentation structure **MUST** mirror the code structure in `src/codex_bot/`.
+
+### Mapping Example
+
+| Code Location | Documentation Location (EN/RU) |
+|:---|:---|
+| `src/codex_bot/base/` | `docs/[lang]/architecture/base/` |
+| `src/codex_bot/engine/router_builder/` | `docs/[lang]/architecture/engine/router_builder/` |
+| `src/codex_bot/redis/` | `docs/[lang]/architecture/redis/` |
+
+### Why?
+
+- **1:1 Mapping:** Easy to find docs for any code module.
+- **No Orphans:** Prevents documentation from getting lost.
+- **Refactoring Safety:** When code moves, docs move with it.
+
+---
+
+## 4. 🧭 Navigation Standard
+
+Every documentation file must be easily navigable.
+
+### Breadcrumbs (Mandatory)
+
+Every file **MUST** start with a navigation header:
+
+```markdown
+[⬅️ Back](../README.md) | [🏠 Docs Root](../../README.md)
+```
+
+- **Back:** Links to the current directory's `README.md`.
+- **Docs Root:** Links to the documentation root (`docs/README.md`).
+
+### Index Files (README.md)
+
+Every directory **MUST** have a `README.md` acting as a navigation hub.
+
+**Required Structure:**
+
+1. **Header:** Emoji 📂 + Section Name.
+2. **Navigation:** Breadcrumbs.
+3. **Description:** Short summary (2-3 sentences).
+4. **Map:** Table or list of files in **logical reading order** (not alphabetical).
+
+---
+
+## 5. 📝 File Naming & Organization
+
+### Naming Conventions
+
+- **Format:** `snake_case.md` (e.g., `orchestrator_logic.md`).
+- **No Prefixes:** Do NOT use `01_`, `02_` prefixes in filenames.
+- **Reading Order:** Defined in `README.md` map.
+
+### Language Folders
+
+All documents **MUST** reside in:
+
+- `docs/api/` (Technical EN)
+- `docs/en_EN/` (Conceptual EN)
+- `docs/ru_RU/` (Conceptual RU)
+
+---
+
+## 6. ✅ Markdown Linting Rules (Strict)
+
+1. **MD047 (End with Newline):** Every file must end with exactly **one newline** (`\n`).
+2. **MD032 (List Spacing):** Blank line before and after any list.
+3. **MD007 (Indentation):** Use **2 spaces** for nested lists.
+
+---
+
+## 7. 🚫 Common Mistakes
+
+- **❌ Duplicating Code in RU Docs:** Link to `docs/api/` instead.
+- **❌ Numbered Prefixes:** Use `README.md` map for order.
+- **❌ Missing Breadcrumbs:** Always add the navigation header.
+- **❌ Language-neutral folders:** Use `en_EN` or `ru_RU`.
+
+---
+
+**Last Updated:** 2025-02-07