codex-core 0.2.0__tar.gz → 0.2.2__tar.gz

codex_core-0.2.2/.github/workflows/ci.yml

@@ -0,0 +1,58 @@
+name: CI Pipeline
+
+on:
+  push:
+    branches: [main, develop]
+    paths-ignore: ["**.md", "docs/**", ".gitignore"]
+  pull_request:
+    branches: [main]
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  quality-gate:
+    name: Quality Gate
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.7"
+
+      - name: Sync dev environment
+        run: uv sync --locked --extra dev
+
+      - name: Run pre-commit
+        run: uv run python tools/dev/check.py --lint
+
+      - name: Run pip-audit
+        run: uv run python tools/dev/check.py --security
+
+      - name: Run mypy
+        run: uv run python tools/dev/check.py --types
+
+  unit-tests:
+    name: Unit Tests (Python ${{ matrix.python-version }})
+    needs: quality-gate
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.7"
+
+      - name: Sync dev environment
+        run: uv sync --locked --extra dev
+
+      - name: Run unit tests
+        run: uv run pytest tests/ -m "unit" -v --tb=short

{codex_core-0.2.0 → codex_core-0.2.2}/.github/workflows/docs.yml

@@ -3,16 +3,16 @@ name: Deploy Docs
 on:
   push:
     tags:
-      - 'v*'
+      - "v*"
   workflow_dispatch:
     inputs:
       version:
-        description: 'Version alias to deploy (e.g. 0.x, 1.x)'
+        description: "Version alias to deploy (e.g. 0.x, 1.x)"
         required: true
       alias:
-        description: 'Alias (latest, stable, or leave empty)'
+        description: "Alias (latest, stable, or leave empty)"
         required: false
-        default: 'latest'
+        default: "latest"
 
 env:
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
@@ -39,34 +39,33 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: "3.12"
-          cache: 'pip'
+      - uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.7"
 
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -e ".[docs]"
+      - name: Sync docs environment
+        run: uv sync --locked --extra docs
 
       - name: Resolve version alias (tag push)
         if: github.event_name == 'push'
         id: version
         run: |
-          TAG="${GITHUB_REF_NAME}"           # e.g. v1.2.3
+          TAG="${GITHUB_REF_NAME}"
           MAJOR=$(echo "$TAG" | sed 's/^v//' | cut -d. -f1)
-          MINOR=$(echo "$TAG" | sed 's/^v//' | cut -d. -f2)
           echo "alias=${MAJOR}.x" >> "$GITHUB_OUTPUT"
 
       - name: Deploy versioned docs (tag push)
         if: github.event_name == 'push'
         run: |
-          mike deploy --push --update-aliases "${{ steps.version.outputs.alias }}" latest
-          mike set-default --push latest
+          uv run mike deploy --push --update-aliases "${{ steps.version.outputs.alias }}" latest
+          uv run mike set-default --push latest
 
       - name: Deploy versioned docs (manual)
         if: github.event_name == 'workflow_dispatch'
         run: |
           if [ -n "${{ inputs.alias }}" ]; then
-            mike deploy --push --update-aliases "${{ inputs.version }}" "${{ inputs.alias }}"
+            uv run mike deploy --push --update-aliases "${{ inputs.version }}" "${{ inputs.alias }}"
           else
-            mike deploy --push "${{ inputs.version }}"
+            uv run mike deploy --push "${{ inputs.version }}"
           fi
-          mike set-default --push latest
+          uv run mike set-default --push latest

{codex_core-0.2.0 → codex_core-0.2.2}/.github/workflows/publish.yml

@@ -3,7 +3,7 @@ name: Publish to PyPI
 on:
   push:
     tags:
-      - 'v*'
+      - "v*"
 
 env:
   FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
@@ -29,18 +29,15 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: "3.12"
-          cache: 'pip'
-
-      - name: Install build tools
-        run: |
-          python -m pip install --upgrade pip
-          python -m pip install build twine hatchling
+      - uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.7"
 
       - name: Build sdist and wheel
-        run: python -m build
+        run: uv build --no-sources
 
       - name: Check artifacts
-        run: twine check dist/*
+        run: uvx twine check dist/*
 
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1

{codex_core-0.2.0 → codex_core-0.2.2}/.gitignore

@@ -183,6 +183,7 @@ gen/
 
 # Ruff stuff:
 .ruff_cache/
+.uv-cache/
 
 # PyPI configuration file
 .pypirc

codex_core-0.2.2/.python-version

@@ -0,0 +1 @@
+3.12

{codex_core-0.2.0 → codex_core-0.2.2}/CHANGELOG.md

@@ -5,6 +5,31 @@ 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.2.2] - 2026-03-29
+
+### Fixed
+- **CI Security Check Routing**: Updated `.github/workflows/ci.yml` to run lint, security, and type checks through `tools/dev/check.py` so GitHub Actions uses the same project-level check-runner policy as local development.
+- **pip-audit Policy Drift**: Restored `AUDIT_FLAGS` handling in CI, including `--skip-editable` and the project-specific ignore for `CVE-2026-4539`.
+
+## [0.2.1] - 2026-03-29
+
+### Added
+- **Locked UV Workflow**: Added `.python-version` and committed `uv.lock` so local development, CI, docs, and publish flows use a consistent locked dependency set.
+- **Configurable Check Runner Stages**: Added `RUN_LINT`, `RUN_TYPES`, `RUN_SECURITY`, `RUN_EXTRA_CHECKS`, `RUN_UNIT_TESTS`, and `RUN_INTEGRATION_TESTS` flags to `BaseCheckRunner` so each codex-* project can declare its quality-gate policy without replacing orchestration logic.
+- **Expanded Dev API Docs**: Split the Dev Tools API reference into separate pages for the check runner, project tree generator, and static compiler.
+
+### Changed
+- **Python Support Policy**: Raised the declared minimum Python version to 3.12 and aligned Ruff, Mypy, packaging metadata, and CI matrices with the supported runtime versions.
+- **UV-Based Automation**: Updated CI, docs deployment, and publish workflows to use `uv sync`, `uv run`, and `uv build` instead of ad-hoc pip installs.
+- **Documentation Structure**:
+  - Synchronized `tools/dev/README.md` and architecture guides with the real `BaseCheckRunner` CLI and extension model.
+  - Reorganized the Dev Tools API navigation into a nested expandable section under `API Reference`.
+  - Moved the Python-version planning note into `docs/planning/` as an internal draft instead of a public docs root page.
+
+### Fixed
+- **Optional Loguru Typing**: Fixed `mypy` failure in `src/codex_core/common/loguru_setup.py` by making the optional `loguru` import type-safe.
+- **Checker UX Consistency**: Added explicit skip messages when disabled check stages are not executed, improving both local and CI output clarity.
+
 ## [0.2.0] - 2025-02-13
 
 ### Added

{codex_core-0.2.0 → codex_core-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-core
-Version: 0.2.0
+Version: 0.2.2
 Summary: Core utilities, schemas and settings for Codex WaaS toolkit
 Project-URL: Homepage, https://github.com/codexdlc/codex-core
 Project-URL: Documentation, https://codexdlc.github.io/codex-core/
@@ -13,12 +13,10 @@ Keywords: core,pydantic,toolkit,waas
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
-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 :: Libraries :: Application Frameworks
-Requires-Python: >=3.10
+Requires-Python: >=3.12
 Requires-Dist: pydantic-settings>=2.0
 Requires-Dist: pydantic<3.0,>=2.0
 Provides-Extra: dev
@@ -64,6 +62,20 @@ pip install codex-core
 pip install "codex-core[loguru]"
 ```
 
+Requires Python 3.12 or newer.
+
+## Development
+
+```bash
+uv sync --extra dev
+uv run pytest
+uv run mypy src/codex_core/
+uv run pre-commit run --all-files
+uv build --no-sources
+```
+
+Requires Python 3.12 or newer.
+
 ## Quick Start
 
 ```python
@@ -99,8 +111,14 @@ Full docs with architecture, API reference, and data flow diagrams:
 
 ## Part of the Codex ecosystem
 
-- **[codex-core](https://github.com/codexdlc/codex-core)**: Foundational utilities and DTOs.
-- **[codex-platform](https://github.com/codexdlc/codex-platform)**: Core platform components and HTTP APIs.
-- **[codex-bot](https://github.com/codexdlc/codex-bot)**: Telegram AI-agent infrastructure.
-- **[codex-services](https://github.com/codexdlc/codex-services)**: Business logic engines (Booking, CRM).
-- **[codex-ai](https://github.com/codexdlc/codex-ai)**: LLM abstraction layer.
+| Package | Role |
+| :--- | :--- |
+| **codex-core** | Foundation — immutable DTOs, PII masking, env settings |
+| [codex-platform](https://github.com/codexdlc/codex-platform) | Infrastructure — Redis, Streams, ARQ workers, Notifications |
+| [codex-ai](https://github.com/codexdlc/codex-ai) | LLM layer — unified async interface for OpenAI, Gemini, Anthropic |
+| [codex-services](https://github.com/codexdlc/codex-services) | Business logic — Booking engine, CRM, Calendar |
+
+Each library is **fully standalone** — install only what your project needs.
+Together they form the backbone of **[codex-bot](https://github.com/codexdlc/codex-bot)**
+(Telegram AI-agent infrastructure built on aiogram) and
+**[codex-django](https://github.com/codexdlc/codex-django)** (Django integration layer).

{codex_core-0.2.0 → codex_core-0.2.2}/README.md

@@ -21,6 +21,20 @@ pip install codex-core
 pip install "codex-core[loguru]"
 ```
 
+Requires Python 3.12 or newer.
+
+## Development
+
+```bash
+uv sync --extra dev
+uv run pytest
+uv run mypy src/codex_core/
+uv run pre-commit run --all-files
+uv build --no-sources
+```
+
+Requires Python 3.12 or newer.
+
 ## Quick Start
 
 ```python
@@ -56,8 +70,14 @@ Full docs with architecture, API reference, and data flow diagrams:
 
 ## Part of the Codex ecosystem
 
-- **[codex-core](https://github.com/codexdlc/codex-core)**: Foundational utilities and DTOs.
-- **[codex-platform](https://github.com/codexdlc/codex-platform)**: Core platform components and HTTP APIs.
-- **[codex-bot](https://github.com/codexdlc/codex-bot)**: Telegram AI-agent infrastructure.
-- **[codex-services](https://github.com/codexdlc/codex-services)**: Business logic engines (Booking, CRM).
-- **[codex-ai](https://github.com/codexdlc/codex-ai)**: LLM abstraction layer.
+| Package | Role |
+| :--- | :--- |
+| **codex-core** | Foundation — immutable DTOs, PII masking, env settings |
+| [codex-platform](https://github.com/codexdlc/codex-platform) | Infrastructure — Redis, Streams, ARQ workers, Notifications |
+| [codex-ai](https://github.com/codexdlc/codex-ai) | LLM layer — unified async interface for OpenAI, Gemini, Anthropic |
+| [codex-services](https://github.com/codexdlc/codex-services) | Business logic — Booking engine, CRM, Calendar |
+
+Each library is **fully standalone** — install only what your project needs.
+Together they form the backbone of **[codex-bot](https://github.com/codexdlc/codex-bot)**
+(Telegram AI-agent infrastructure built on aiogram) and
+**[codex-django](https://github.com/codexdlc/codex-django)** (Django integration layer).

codex_core-0.2.2/docs/en/api/dev/check_runner.md

@@ -0,0 +1,10 @@
+<!-- Type: REFERENCE -->
+[🏠 Home](../../../index.md) | [⚙️ API Reference](../index.md) | [🛠️ Check Runner](check_runner.md)
+
+# Check Runner API
+
+Reference for the shared quality-gate runner used by project-level `tools/dev/check.py` scripts.
+
+## BaseCheckRunner
+
+::: codex_core.dev.check_runner.BaseCheckRunner

codex_core-0.2.2/docs/en/api/dev/index.md

@@ -0,0 +1,12 @@
+<!-- Type: REFERENCE -->
+[🏠 Home](../../../index.md) | [⚙️ API Reference](../index.md) | [🛠️ Dev Tools](index.md)
+
+# Dev Tools API
+
+This section documents the internal development utilities shipped with `codex-core`.
+
+## Modules
+
+- [Check Runner](check_runner.md): shared quality-gate orchestration for codex-* projects
+- [Project Tree](project_tree.md): project structure export for documentation and onboarding
+- [Static Compiler](static_compiler.md): pure-Python CSS and JS bundling helpers

codex_core-0.2.2/docs/en/api/dev/project_tree.md

@@ -0,0 +1,10 @@
+<!-- Type: REFERENCE -->
+[🏠 Home](../../../index.md) | [⚙️ API Reference](../index.md) | [🌳 Project Tree](project_tree.md)
+
+# Project Tree API
+
+Reference for the utility that exports a readable project tree for docs and onboarding flows.
+
+## ProjectTreeGenerator
+
+::: codex_core.dev.project_tree.ProjectTreeGenerator

codex_core-0.2.2/docs/en/api/dev/static_compiler.md

@@ -0,0 +1,18 @@
+<!-- Type: REFERENCE -->
+[🏠 Home](../../../index.md) | [⚙️ API Reference](../index.md) | [🧱 Static Compiler](static_compiler.md)
+
+# Static Compiler API
+
+Reference for the pure-Python asset compilation helpers in `codex_core.dev.static_compiler`.
+
+## StaticCompiler
+
+::: codex_core.dev.static_compiler.compiler.StaticCompiler
+
+## CSSCompiler
+
+::: codex_core.dev.static_compiler.css.CSSCompiler
+
+## JSCompiler
+
+::: codex_core.dev.static_compiler.js.JSCompiler

{codex_core-0.2.0 → codex_core-0.2.2}/docs/en/api/index.md

@@ -9,7 +9,7 @@ Welcome to the **codex-core** API Reference! This section provides detailed info
 - **[🛡️ Core (DTO & PII)](core.md)**: Base data models and PII protection utilities.
 - **[🛠️ Common (Utilities)](common.md)**: Phone, text, and logging helpers.
 - **[⚙️ Settings (Config)](settings.md)**: Base configuration patterns.
-- **[🛠️ Dev Tools](dev.md)**: Internal developer tools.
+- **[🛠️ Dev Tools](dev/index.md)**: Internal developer tools split by subsystem.
 
 ## Technical Details
 

{codex_core-0.2.0 → codex_core-0.2.2}/docs/en/architecture/README.md

@@ -1,4 +1,5 @@
-[🏠 Home](../../index.md) | [🧭 Guide (EN)](../README.md) | [🛡️ Architecture](../api/index.md)
+<!-- Type: CONCEPT -->
+[🏠 Home](../../index.md) | [🧭 Guide (EN)](../README.md) | [🛡️ Architecture](README.md)
 
 # 🛡️ Architecture & Platform Overview (EN)
 
@@ -12,6 +13,7 @@ We divide the platform into three main domains, each serving a specific purpose:
 | **[🛡️ Core](platform/core.md)** | Essential data models and security. | `BaseDTO`, PII Masking, `mask_value`. |
 | **[🛠️ Common](platform/common.md)** | Standardized utility functions. | `normalize_phone`, `normalize_name`, `TaskLogContext`. |
 | **[⚙️ Settings](platform/settings.md)** | Infrastructure configuration. | `BaseCommonSettings`, `redis_url`. |
+| **[🛠️ Dev Tools](platform/dev.md)** | Shared developer tooling. | `BaseCheckRunner`, `ProjectTreeGenerator`, `StaticCompiler`. |
 
 ## Core Principles
 1. **Security First**: PII protection is integrated at the base DTO level.
@@ -23,3 +25,4 @@ We divide the platform into three main domains, each serving a specific purpose:
 - Read about [🛡️ Core: PII & DTO](platform/core.md).
 - Explore [🛠️ Common Utilities](platform/common.md).
 - Understand [⚙️ Settings Architecture](platform/settings.md).
+- Review [🛠️ Dev Tools](platform/dev.md).

{codex_core-0.2.0 → codex_core-0.2.2}/docs/en/architecture/platform/dev.md

@@ -1,4 +1,5 @@
-[🏠 Home](../../../index.md) | [🧭 Guide (EN)](../../README.md) | [🛠️ Dev API](../../api/dev.md)
+<!-- Type: CONCEPT -->
+[🏠 Home](../../../index.md) | [🧭 Guide (EN)](../../README.md) | [🛠️ Dev API](../../api/dev/index.md)
 
 # Dev Tools (Architecture)
 
@@ -37,6 +38,24 @@ python tools/dev/check.py --all         # lint + types + security + unit, asks a
 python tools/dev/check.py --ci          # everything non-interactively (GitHub Actions)
 ```
 
+### Project switches
+
+Projects can keep the shared orchestration and declare their local policy with
+simple boolean attributes on `CheckRunner`:
+
+```python
+class CheckRunner(BaseCheckRunner):
+    RUN_LINT = True
+    RUN_TYPES = True
+    RUN_SECURITY = True
+    RUN_EXTRA_CHECKS = True
+    RUN_UNIT_TESTS = True
+    RUN_INTEGRATION_TESTS = False
+```
+
+This is the preferred extension point when a library does not need every stage.
+Use method overrides only when behavior itself must change.
+
 ### Usage in a project
 
 ```python

{codex_core-0.2.0 → codex_core-0.2.2}/docs/en/tasks/getting_started.md

@@ -1,3 +1,4 @@
+<!-- Type: GUIDE -->
 [🏠 Home](../../index.md) | [🧭 Guide (EN)](../README.md) | [🚀 Getting Started](getting_started.md)
 
 # Getting Started (EN)
@@ -20,10 +21,10 @@ pip install git+https://github.com/codexdlc/codex-core.git
 ```
 
 ### Optional Dependencies
-If you want to use the pre-configured Loguru setup, you'll need to install `loguru` manually:
+If you want to use the pre-configured Loguru setup, install the optional extra:
 
 ```bash
-pip install loguru
+pip install "codex-core[loguru]"
 ```
 
 ## First Steps

codex_core-0.2.2/docs/planning/python_version_policy.md

@@ -0,0 +1,35 @@
+<!-- Type: ISSUE/DRAFT -->
+# Python Version Policy Note
+
+Status: draft
+
+## Context
+
+`codex-core` currently declares `requires-python = ">=3.12"` in
+`pyproject.toml` and advertises Python 3.12 / 3.13 classifiers.
+
+This note exists as an internal planning record for future Python-version
+expansion work. It is intentionally kept outside the public navigation.
+
+## Current State
+
+- Runtime requirement: Python 3.12+
+- Declared classifiers: Python 3.12, Python 3.13
+- CI and publish workflows should stay aligned with the supported versions
+
+## When to update
+
+Update this note when one of the following changes is planned:
+
+1. Add a new officially supported Python version.
+2. Raise the minimum supported Python version.
+3. Expand CI, docs, or publish matrices to new versions.
+
+## Checklist
+
+- [ ] Update `project.requires-python` in `pyproject.toml` if support policy changes.
+- [ ] Update `classifiers` in `pyproject.toml`.
+- [ ] Update Python-version matrices in `.github/workflows/ci.yml`.
+- [ ] Update Python-version matrices in `.github/workflows/docs.yml`.
+- [ ] Update Python-version matrices in `.github/workflows/publish.yml`.
+- [ ] Reflect the new policy in user-facing docs only after CI is updated.

{codex_core-0.2.0 → codex_core-0.2.2}/docs/ru/architecture/README.md

@@ -1,4 +1,5 @@
-[🏠 На главную](../../index.md) | [🧭 Руководство (RU)](../README.md) | [🛡️ Архитектура](../../en/api/index.md)
+<!-- Type: CONCEPT -->
+[🏠 На главную](../../index.md) | [🧭 Руководство (RU)](../README.md) | [🛡️ Архитектура](README.md)
 
 # 🛡️ Обзор архитектуры и платформы (RU)
 
@@ -12,6 +13,7 @@
 | **[🛡️ Core](platform/core.md)** | Основные модели данных и безопасность. | `BaseDTO`, Маскировка PII, `mask_value`. |
 | **[🛠️ Common](platform/common.md)** | Стандартизированные функции-утилиты. | `normalize_phone`, `normalize_name`, `TaskLogContext`. |
 | **[⚙️ Settings](platform/settings.md)** | Конфигурация инфраструктуры. | `BaseCommonSettings`, `redis_url`. |
+| **[🛠️ Dev Tools](platform/dev.md)** | Общие инструменты разработки. | `BaseCheckRunner`, `ProjectTreeGenerator`, `StaticCompiler`. |
 
 ## Основные принципы
 1. **Безопасность прежде всего**: Защита PII интегрирована на уровне базового DTO.
@@ -23,3 +25,4 @@
 - Узнайте о [🛡️ Core: PII и DTO](platform/core.md).
 - Изучите [🛠️ Общие утилиты (Common)](platform/common.md).
 - Разберитесь в [⚙️ Архитектуре настроек (Settings)](platform/settings.md).
+- Посмотрите [🛠️ Dev Tools](platform/dev.md).

{codex_core-0.2.0 → codex_core-0.2.2}/docs/ru/architecture/platform/dev.md

@@ -1,4 +1,5 @@
-[🏠 Главная](../../../index.md) | [🧭 Руководство (RU)](../../README.md) | [🛠️ Dev API](../../../en/api/dev.md)
+<!-- Type: CONCEPT -->
+[🏠 Главная](../../../index.md) | [🧭 Руководство (RU)](../../README.md) | [🛠️ Dev API](../../../en/api/dev/index.md)
 
 # Dev Tools (Архитектура)
 
@@ -37,6 +38,24 @@ python tools/dev/check.py --all         # lint + types + security + unit, спр
 python tools/dev/check.py --ci          # всё без промптов (GitHub Actions)
 ```
 
+### Проектные переключатели
+
+Проект может оставить общую оркестрацию и задать свою локальную политику через
+булевы атрибуты в `CheckRunner`:
+
+```python
+class CheckRunner(BaseCheckRunner):
+    RUN_LINT = True
+    RUN_TYPES = True
+    RUN_SECURITY = True
+    RUN_EXTRA_CHECKS = True
+    RUN_UNIT_TESTS = True
+    RUN_INTEGRATION_TESTS = False
+```
+
+Это основной способ настройки, когда библиотеке не нужны все этапы проверки.
+Переопределяйте методы только тогда, когда нужно менять само поведение.
+
 ### Использование в проекте
 
 ```python

{codex_core-0.2.0 → codex_core-0.2.2}/docs/ru/tasks/getting_started.md

@@ -1,3 +1,4 @@
+<!-- Type: GUIDE -->
 [🏠 На главную](../../index.md) | [🧭 Руководство (RU)](../README.md) | [🚀 Начало работы](getting_started.md)
 
 # Начало работы (RU)
@@ -20,10 +21,10 @@ pip install git+https://github.com/codexdlc/codex-core.git
 ```
 
 ### Опциональные зависимости
-Если вы хотите использовать преднастроенный логгер `Loguru`, вам нужно будет установить `loguru` вручную:
+Если вы хотите использовать преднастроенный логгер `Loguru`, установите optional extra:
 
 ```bash
-pip install loguru
+pip install "codex-core[loguru]"
 ```
 
 ## Первые шаги

codex_core-0.2.2/docs/stylesheets/extra.css

@@ -0,0 +1,18 @@
+/* =============================================================
+   Codex DocSite Standard — extra.css
+   Navigation section/group headers — visually distinct
+   ============================================================= */
+
+.md-nav__item--section > .md-nav__link {
+  color: var(--md-typeset-a-color) !important;
+  font-weight: 700;
+  font-size: 0.72rem;
+  text-transform: uppercase;
+  letter-spacing: 0.09em;
+}
+
+.md-nav__item--section:not(:first-child) {
+  margin-top: 0.6em;
+  padding-top: 0.4em;
+  border-top: 1px solid var(--md-default-fg-color--lightest);
+}

{codex_core-0.2.0 → codex_core-0.2.2}/mkdocs.yml

@@ -7,23 +7,25 @@ theme:
   palette:
     - media: "(prefers-color-scheme: light)"
       scheme: default
-      primary: deep purple
-      accent: purple
+      primary: teal
+      accent: cyan
       toggle:
         icon: material/brightness-7
         name: Switch to dark mode
     - media: "(prefers-color-scheme: dark)"
       scheme: slate
-      primary: deep purple
-      accent: purple
+      primary: teal
+      accent: cyan
       toggle:
         icon: material/brightness-4
         name: Switch to light mode
   features:
     - navigation.tabs
+    - navigation.tabs.sticky
     - navigation.sections
     - navigation.expand
     - navigation.top
+    - navigation.breadcrumbs
     - search.suggest
     - search.highlight
     - content.code.copy
@@ -34,6 +36,9 @@ extra:
     provider: mike
     default: latest
 
+extra_css:
+  - stylesheets/extra.css
+
 plugins:
   - search
   - include-markdown
@@ -49,6 +54,7 @@ plugins:
             show_symbol_type_heading: true
             show_symbol_type_toc: true
             docstring_style: google
+            members_order: source
 
 nav:
   - Home: index.md
@@ -62,8 +68,6 @@ nav:
           - Common (Utils): en/architecture/platform/common.md
           - Settings (Config): en/architecture/platform/settings.md
           - Dev Tools: en/architecture/platform/dev.md
-      - Evolution:
-          - Roadmap: evolution/roadmap.md
   - Руководство (RU):
       - Обзор: ru/README.md
       - Задачи (Tasks):
@@ -79,5 +83,10 @@ nav:
       - Core (DTO & PII): en/api/core.md
       - Common (Utilities): en/api/common.md
       - Settings (Base): en/api/settings.md
-      - Dev Tools: en/api/dev.md
+      - Dev Tools:
+          - Overview: en/api/dev/index.md
+          - Check Runner: en/api/dev/check_runner.md
+          - Project Tree: en/api/dev/project_tree.md
+          - Static Compiler: en/api/dev/static_compiler.md
   - Changelog: changelog.md
+  - Roadmap: evolution/roadmap.md