codex-platform 0.5.2__tar.gz → 0.6.0__tar.gz

codex_platform-0.6.0/.agents/skills/codex-platform-maintainer/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: codex-platform-maintainer
+description: Use for maintaining this repository's Redis, Streams, ARQ, messaging, packaging, or release integration.
+---
+
+# codex-platform maintenance
+
+This repository publishes the `codex-platform` library. Keep framework-independent infrastructure in `src/codex_platform/`; application policy and business rules belong to consumers. The public API is exposed by each component's `__init__.py`. Inspect those exports and the corresponding unit tests before changing a contract.
+
+Components are independent optional surfaces: `redis_service` needs Redis, `streams` uses Redis Streams, `workers.arq` needs ARQ, and `messaging` handles notification primitives. `notifications` is deprecated compatibility code; new behavior belongs in `messaging` and compatibility changes need explicit tests.
+
+The canonical consumer skill lives in `src/codex_platform/agent_skills/resources/`. Treat its installed copies in other projects as managed output. When changing installer behavior, exercise install, update, delete, and status in a temporary consumer directory and inspect wheel and sdist payloads. Run focused tests and configured lint/types for affected code. The root `AGENTS.md` requires refreshing the shared graph after code changes.

{codex_platform-0.5.2 → codex_platform-0.6.0}/AGENTS.md

@@ -7,3 +7,7 @@ Rules:
 - If `../graphify-out/wiki/index.md` exists, navigate it instead of reading raw files.
 - For cross-module questions, prefer `graphify query`, `graphify path`, or `graphify explain` (run from root or via MCP) over grep.
 - After modifying code files in this session, run `graphify update .` from the **workspace root** to keep the global graph current.
+
+## Project maintenance
+
+For maintenance of this library, use [codex-platform-maintainer](.agents/skills/codex-platform-maintainer/SKILL.md). The distributable consumer guidance is maintained separately in `src/codex_platform/agent_skills/resources/`.

{codex_platform-0.5.2 → codex_platform-0.6.0}/CHANGELOG.md

@@ -5,6 +5,18 @@ Grouped by `Added` · `Changed` · `Deprecated` · `Removed` · `Fixed`.
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-10-09
+
+### Added
+- Added an optional offline installer for the `codex-platform` consumer agent skill, with versioned ownership and safe install, update, status, and delete operations.
+
+### Changed
+- Raised the `codex-core` baseline to the published `0.5.0` release.
+- Raised the minimum supported `aiosmtplib`, `mkdocs-material`, and development `pip` versions to patched releases and refreshed the lockfile for vulnerable transitive dependencies.
+
+### Fixed
+- Corrected architecture-guide links and refreshed installation examples for the `0.6.x` release line.
+
 ## [0.5.2] - 2026-05-07
 
 ### Added

{codex_platform-0.5.2 → codex_platform-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: codex-platform
-Version: 0.5.2
+Version: 0.6.0
 Summary: Modular async infrastructure (Redis, Streams, ARQ, Notifications) built for Codex, designed for independent use.
 Project-URL: Homepage, https://github.com/codexdlc/codex-platform
 Project-URL: Documentation, https://codexdlc.github.io/codex-platform/
@@ -15,17 +15,17 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.12
-Requires-Dist: codex-core<0.10.0,>=0.3.0
+Requires-Dist: codex-core<0.10.0,>=0.5.0
 Requires-Dist: pydantic<3.0,>=2.0
 Provides-Extra: all
-Requires-Dist: aiosmtplib>=3.0; extra == 'all'
+Requires-Dist: aiosmtplib>=5.1.2; extra == 'all'
 Requires-Dist: arq>=0.25; extra == 'all'
 Requires-Dist: jinja2>=3.1; extra == 'all'
 Requires-Dist: redis>=5.0; extra == 'all'
 Provides-Extra: arq
 Requires-Dist: arq>=0.25; extra == 'arq'
 Provides-Extra: dev
-Requires-Dist: aiosmtplib>=3.0; extra == 'dev'
+Requires-Dist: aiosmtplib>=5.1.2; extra == 'dev'
 Requires-Dist: arq>=0.25; extra == 'dev'
 Requires-Dist: bandit>=1.7; extra == 'dev'
 Requires-Dist: detect-secrets>=1.5; extra == 'dev'
@@ -34,7 +34,7 @@ Requires-Dist: jinja2>=3.1; extra == 'dev'
 Requires-Dist: lupa>2.6; extra == 'dev'
 Requires-Dist: mypy>=1.10; extra == 'dev'
 Requires-Dist: pip-audit>=2.7; extra == 'dev'
-Requires-Dist: pip>=26.1; extra == 'dev'
+Requires-Dist: pip>=26.2.1; extra == 'dev'
 Requires-Dist: pre-commit>=3.0; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
 Requires-Dist: pytest-cov; extra == 'dev'
@@ -44,11 +44,11 @@ Requires-Dist: ruff>=0.4; extra == 'dev'
 Provides-Extra: docs
 Requires-Dist: mike>=2.0; extra == 'docs'
 Requires-Dist: mkdocs-include-markdown-plugin; extra == 'docs'
-Requires-Dist: mkdocs-material>=9.0; extra == 'docs'
+Requires-Dist: mkdocs-material>=9.7.7; extra == 'docs'
 Requires-Dist: mkdocs<2.0,>=1.5; extra == 'docs'
 Requires-Dist: mkdocstrings[python]>=0.24; extra == 'docs'
 Provides-Extra: notifications
-Requires-Dist: aiosmtplib>=3.0; extra == 'notifications'
+Requires-Dist: aiosmtplib>=5.1.2; extra == 'notifications'
 Requires-Dist: jinja2>=3.1; extra == 'notifications'
 Provides-Extra: redis
 Requires-Dist: redis>=5.0; extra == 'redis'
@@ -61,7 +61,7 @@ Description-Content-Type: text/markdown
 [![PyPI version](https://img.shields.io/pypi/v/codex-platform.svg)](https://pypi.org/project/codex-platform/)
 [![Python](https://img.shields.io/pypi/pyversions/codex-platform.svg)](https://pypi.org/project/codex-platform/)
 [![CI](https://github.com/codexdlc/codex-platform/actions/workflows/ci.yml/badge.svg)](https://github.com/codexdlc/codex-platform/actions/workflows/ci.yml)
-[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
 
 `codex-platform` is a modular, async infrastructure library. Originally built as the foundation for the Codex ecosystem, it is designed from the ground up to be completely independent. You can use it in any Python project to get a typed Redis abstraction, a Redis Streams event bus, structured ARQ background workers, or a multi-channel notification engine. Every component is completely independent and can be installed as a separate extra.
 
@@ -70,27 +70,27 @@ Description-Content-Type: text/markdown
 ## Install
 
 ```bash
-# codex-platform 0.3.x
-pip install "codex-platform>=0.3.0,<0.4.0"
+# codex-platform 0.6.x
+pip install "codex-platform>=0.6.0,<0.7.0"
 
 # With Redis support
-pip install "codex-platform[redis]>=0.3.0,<0.4.0"
+pip install "codex-platform[redis]>=0.6.0,<0.7.0"
 
 # With ARQ background workers
-pip install "codex-platform[arq]>=0.3.0,<0.4.0"
+pip install "codex-platform[arq]>=0.6.0,<0.7.0"
 
 # With async SMTP notifications
-pip install "codex-platform[notifications]>=0.3.0,<0.4.0"
+pip install "codex-platform[notifications]>=0.6.0,<0.7.0"
 
 # Redis Streams
-pip install "codex-platform[streams]>=0.3.0,<0.4.0"
+pip install "codex-platform[streams]>=0.6.0,<0.7.0"
 
 # Everything
-pip install "codex-platform[all]>=0.3.0,<0.4.0"
+pip install "codex-platform[all]>=0.6.0,<0.7.0"
 ```
 
 Requires Python 3.12 or newer.
-Installs `codex-core>=0.3.0,<0.10.0` automatically as a dependency.
+Installs `codex-core>=0.5.0,<0.10.0` automatically as a dependency.
 
 ## Development
 
@@ -122,7 +122,20 @@ data = await service.hash.get_json("user:42", "profile")
 | `redis_service` | `[redis]` | Typed async Redis abstraction — Hash, String, List, Set, ZSet, JSON, Pipeline |
 | `streams` | `[streams]` | Redis Streams producer/consumer with consumer groups, retry, and DLQ |
 | `workers.arq` | `[arq]` | ARQ worker base infrastructure — health probes, DLQ retry, CORE_FUNCTIONS |
-| `notifications` | `[notifications]` | Multi-channel notification engine — SMTP, ARQ/Direct delivery, Jinja2 renderer |
+| `messaging` | `[notifications]` | Multi-channel notification primitives — SMTP, ARQ/direct delivery, Jinja2 renderer; `notifications` remains a deprecated compatibility import |
+
+## Optional agent skill (starting in 0.6.0)
+
+Starting with `codex-platform` 0.6.0, the package includes an offline coding-agent skill for its Redis, Streams, ARQ, and messaging APIs. Installing the Python package does not change a project. To copy the skill into an existing project, run these commands from the Python environment where `codex-platform` is installed:
+
+```bash
+python -m codex_platform.agent_skills install --project /path/to/project
+python -m codex_platform.agent_skills status --project /path/to/project
+python -m codex_platform.agent_skills update --project /path/to/project
+python -m codex_platform.agent_skills delete --project /path/to/project
+```
+
+The installer manages `.agents/skills/codex-platform/` and a bounded reference block in the project's root `AGENTS.md`. It preserves unrelated project guidance, tracks package version and file hashes, and refuses to overwrite locally edited managed files. See the [agent skill guide](docs/en/guides/agent-skills.md) for lifecycle and recovery details.
 
 ## Documentation
 
@@ -135,7 +148,7 @@ Full docs with architecture, API reference, and data flow diagrams:
 | Package | Role |
 | :--- | :--- |
 | [codex-core](https://github.com/codexdlc/codex-core) | Foundation — immutable DTOs, PII masking, env settings |
-| **codex-platform** | Infrastructure — Redis, Streams, ARQ workers, Notifications |
+| **codex-platform** | Infrastructure — Redis, Streams, ARQ workers, messaging |
 | [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 |
 

{codex_platform-0.5.2 → codex_platform-0.6.0}/README.md

@@ -3,7 +3,7 @@
 [![PyPI version](https://img.shields.io/pypi/v/codex-platform.svg)](https://pypi.org/project/codex-platform/)
 [![Python](https://img.shields.io/pypi/pyversions/codex-platform.svg)](https://pypi.org/project/codex-platform/)
 [![CI](https://github.com/codexdlc/codex-platform/actions/workflows/ci.yml/badge.svg)](https://github.com/codexdlc/codex-platform/actions/workflows/ci.yml)
-[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
 
 `codex-platform` is a modular, async infrastructure library. Originally built as the foundation for the Codex ecosystem, it is designed from the ground up to be completely independent. You can use it in any Python project to get a typed Redis abstraction, a Redis Streams event bus, structured ARQ background workers, or a multi-channel notification engine. Every component is completely independent and can be installed as a separate extra.
 
@@ -12,27 +12,27 @@
 ## Install
 
 ```bash
-# codex-platform 0.3.x
-pip install "codex-platform>=0.3.0,<0.4.0"
+# codex-platform 0.6.x
+pip install "codex-platform>=0.6.0,<0.7.0"
 
 # With Redis support
-pip install "codex-platform[redis]>=0.3.0,<0.4.0"
+pip install "codex-platform[redis]>=0.6.0,<0.7.0"
 
 # With ARQ background workers
-pip install "codex-platform[arq]>=0.3.0,<0.4.0"
+pip install "codex-platform[arq]>=0.6.0,<0.7.0"
 
 # With async SMTP notifications
-pip install "codex-platform[notifications]>=0.3.0,<0.4.0"
+pip install "codex-platform[notifications]>=0.6.0,<0.7.0"
 
 # Redis Streams
-pip install "codex-platform[streams]>=0.3.0,<0.4.0"
+pip install "codex-platform[streams]>=0.6.0,<0.7.0"
 
 # Everything
-pip install "codex-platform[all]>=0.3.0,<0.4.0"
+pip install "codex-platform[all]>=0.6.0,<0.7.0"
 ```
 
 Requires Python 3.12 or newer.
-Installs `codex-core>=0.3.0,<0.10.0` automatically as a dependency.
+Installs `codex-core>=0.5.0,<0.10.0` automatically as a dependency.
 
 ## Development
 
@@ -64,7 +64,20 @@ data = await service.hash.get_json("user:42", "profile")
 | `redis_service` | `[redis]` | Typed async Redis abstraction — Hash, String, List, Set, ZSet, JSON, Pipeline |
 | `streams` | `[streams]` | Redis Streams producer/consumer with consumer groups, retry, and DLQ |
 | `workers.arq` | `[arq]` | ARQ worker base infrastructure — health probes, DLQ retry, CORE_FUNCTIONS |
-| `notifications` | `[notifications]` | Multi-channel notification engine — SMTP, ARQ/Direct delivery, Jinja2 renderer |
+| `messaging` | `[notifications]` | Multi-channel notification primitives — SMTP, ARQ/direct delivery, Jinja2 renderer; `notifications` remains a deprecated compatibility import |
+
+## Optional agent skill (starting in 0.6.0)
+
+Starting with `codex-platform` 0.6.0, the package includes an offline coding-agent skill for its Redis, Streams, ARQ, and messaging APIs. Installing the Python package does not change a project. To copy the skill into an existing project, run these commands from the Python environment where `codex-platform` is installed:
+
+```bash
+python -m codex_platform.agent_skills install --project /path/to/project
+python -m codex_platform.agent_skills status --project /path/to/project
+python -m codex_platform.agent_skills update --project /path/to/project
+python -m codex_platform.agent_skills delete --project /path/to/project
+```
+
+The installer manages `.agents/skills/codex-platform/` and a bounded reference block in the project's root `AGENTS.md`. It preserves unrelated project guidance, tracks package version and file hashes, and refuses to overwrite locally edited managed files. See the [agent skill guide](docs/en/guides/agent-skills.md) for lifecycle and recovery details.
 
 ## Documentation
 
@@ -77,7 +90,7 @@ Full docs with architecture, API reference, and data flow diagrams:
 | Package | Role |
 | :--- | :--- |
 | [codex-core](https://github.com/codexdlc/codex-core) | Foundation — immutable DTOs, PII masking, env settings |
-| **codex-platform** | Infrastructure — Redis, Streams, ARQ workers, Notifications |
+| **codex-platform** | Infrastructure — Redis, Streams, ARQ workers, messaging |
 | [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 |
 

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/en/architecture/notifications/README.md

@@ -63,4 +63,4 @@ NotificationEngine.send(payload_dto)
 ## See Also
 
 - [Data Flow →](data_flow.md)
-- [API Reference →](../../../api/notifications/index.md)
+- [API Reference →](../../api/notifications/index.md)

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/en/architecture/notifications/data_flow.md

@@ -1,6 +1,6 @@
 <!-- type: CONCEPT -->
 
-[← Notifications](README.md) | [Home](../../index.md)
+[← Notifications](README.md) | [Home](../../../index.md)
 
 # Data Flow: Notifications
 

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/en/architecture/redis_service/README.md

@@ -59,4 +59,4 @@ Selective composition: use Operations classes directly if you don't need all typ
 ## See Also
 
 - [Data Flow →](data_flow.md)
-- [API Reference →](../../../api/redis_service/index.md)
+- [API Reference →](../../api/redis_service/index.md)

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/en/architecture/redis_service/data_flow.md

@@ -1,6 +1,6 @@
 <!-- type: CONCEPT -->
 
-[← Redis Service](README.md) | [Home](../../index.md)
+[← Redis Service](README.md) | [Home](../../../index.md)
 
 # Data Flow: Redis Service
 

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/en/architecture/streams/README.md

@@ -69,4 +69,4 @@ App → StreamProducer              StreamConsumer (XREADGROUP)
 ## See Also
 
 - [Data Flow →](data_flow.md)
-- [API Reference →](../../../api/streams/index.md)
+- [API Reference →](../../api/streams/index.md)

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/en/architecture/streams/data_flow.md

@@ -1,6 +1,6 @@
 <!-- type: CONCEPT -->
 
-[← Streams](README.md) | [Home](../../index.md)
+[← Streams](README.md) | [Home](../../../index.md)
 
 # Data Flow: Streams
 

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/en/architecture/workers/README.md

@@ -59,4 +59,4 @@ BaseArqService  (enqueue from application code / other workers)
 
 - [Data Flow →](data_flow.md)
 - [Streams retry integration →](../streams/README.md)
-- [API Reference →](../../../api/workers/arq/index.md)
+- [API Reference →](../../api/workers/arq/index.md)

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/en/architecture/workers/data_flow.md

@@ -1,6 +1,6 @@
 <!-- type: CONCEPT -->
 
-[← Workers](README.md) | [Home](../../index.md)
+[← Workers](README.md) | [Home](../../../index.md)
 
 # Data Flow: Workers (ARQ)
 

codex_platform-0.6.0/docs/en/guides/agent-skills.md

@@ -0,0 +1,27 @@
+# Agent skill installer
+
+Starting in version 0.6.0, `codex-platform` includes an optional offline consumer skill. The package owns its source in `codex_platform.agent_skills.resources`; installation copies it into an existing project at `.agents/skills/codex-platform/` and adds a bounded reference block to that project's root `AGENTS.md`. Runtime use of the library does not require installing the skill.
+
+Use the Python environment containing `codex-platform`:
+
+```bash
+python -m codex_platform.agent_skills install --project /path/to/project
+python -m codex_platform.agent_skills status --project /path/to/project
+python -m codex_platform.agent_skills update --project /path/to/project
+python -m codex_platform.agent_skills delete --project /path/to/project
+```
+
+`--project` must name an existing directory. `install` is idempotent for a current installation. After a package upgrade, `status` reports that the copy needs an update; run `update` to refresh it. `status` exits with code 0 only when the installed version, payload hashes, and `AGENTS.md` block are current. Absence, edits, or corruption return code 1.
+
+The installer tracks owned file hashes and the package version in `.agents/skills/codex-platform/.manifest.json`. It preserves unrelated `AGENTS.md` text and unowned files under the skill directory. `update` and `delete` refuse to change locally edited or missing managed files. If that happens, back up the changed files, move custom guidance into a separate project skill, and restore the original managed bytes from the same installed package version before retrying. For a damaged marker, back up `AGENTS.md` and repair the bounded block from the installer documentation before retrying. Do not edit the manifest hashes to accept changes. Unowned path collisions, malformed manifests or markers, symlinks, and Windows reparse points also stop the operation. Writes are staged with best-effort rollback for ordinary errors; this is not a crash-safe multi-file transaction or a concurrency lock.
+
+The managed block is exactly the following four lines (with the project's line endings); the separator value is `0` when the block did not need a leading newline and `1` when it did:
+
+```markdown
+<!-- codex-platform:skill:start -->
+<!-- codex-platform:skill:separator=0 -->
+Use [codex-platform](.agents/skills/codex-platform/SKILL.md) for codex_platform work.
+<!-- codex-platform:skill:end -->
+```
+
+The installed skill guides use of the public Redis, Streams, ARQ, and messaging APIs. It does not own a consumer's business rules, data keys, service adapters, or runtime configuration.

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/index.md

@@ -2,34 +2,34 @@
 
 # codex-platform
 
-Infrastructure library for the Codex WaaS toolkit. Provides background task workers (ARQ), Redis service abstraction, Redis Streams event bus, and a multi-channel notification engine.
+Infrastructure library for the Codex WaaS toolkit. Provides background task workers (ARQ), Redis service abstraction, Redis Streams event bus, and framework-independent messaging primitives.
 
 Built to be dropped into any Python 3.12+ service as a set of composable, independently installable extras.
 
 ## Install
 
 ```bash
-# codex-platform 0.3.x
-pip install "codex-platform>=0.3.0,<0.4.0"
+# codex-platform 0.6.x
+pip install "codex-platform>=0.6.0,<0.7.0"
 
 # With Redis support
-pip install "codex-platform[redis]>=0.3.0,<0.4.0"
+pip install "codex-platform[redis]>=0.6.0,<0.7.0"
 
 # With ARQ worker support
-pip install "codex-platform[arq]>=0.3.0,<0.4.0"
+pip install "codex-platform[arq]>=0.6.0,<0.7.0"
 
 # With async SMTP notifications
-pip install "codex-platform[notifications]>=0.3.0,<0.4.0"
+pip install "codex-platform[notifications]>=0.6.0,<0.7.0"
 
 # Redis Streams
-pip install "codex-platform[streams]>=0.3.0,<0.4.0"
+pip install "codex-platform[streams]>=0.6.0,<0.7.0"
 
 # Everything
-pip install "codex-platform[all]>=0.3.0,<0.4.0"
+pip install "codex-platform[all]>=0.6.0,<0.7.0"
 ```
 
 Requires Python 3.12 or newer.
-Installs `codex-core>=0.3.0,<0.10.0` automatically as a dependency.
+Installs `codex-core>=0.5.0,<0.10.0` automatically as a dependency.
 
 ## Quick Start
 
@@ -48,6 +48,8 @@ data = await service.hash.get_json("user:42", "profile")
 
 ## Navigation
 
+The optional offline [agent skill](en/guides/agent-skills.md) is available starting in 0.6.0. Its installer manages a library-owned skill and a bounded `AGENTS.md` link in an existing project.
+
 | Section | Description |
 | :--- | :--- |
 | [Guide (EN)](en/architecture/notifications/README.md) | Architecture overviews and data-flow pages in English |

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/ru/architecture/notifications/README.md

@@ -63,4 +63,4 @@ NotificationEngine.send(payload_dto)
 ## Смотрите также
 
 - [Data Flow →](data_flow.md)
-- [API Reference →](../../../api/notifications/index.md)
+- [API Reference →](../../../en/api/notifications/index.md)

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/ru/architecture/notifications/data_flow.md

@@ -1,6 +1,6 @@
 <!-- type: CONCEPT -->
 
-[← Notifications](README.md) | [Главная](../../index.md)
+[← Notifications](README.md) | [Главная](../../../index.md)
 
 # Data Flow: Notifications
 

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/ru/architecture/redis_service/README.md

@@ -59,4 +59,4 @@ RedisService (корень композиции)
 ## Смотрите также
 
 - [Data Flow →](data_flow.md)
-- [API Reference →](../../../api/redis_service/index.md)
+- [API Reference →](../../../en/api/redis_service/index.md)

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/ru/architecture/redis_service/data_flow.md

@@ -1,6 +1,6 @@
 <!-- type: CONCEPT -->
 
-[← Redis Service](README.md) | [Главная](../../index.md)
+[← Redis Service](README.md) | [Главная](../../../index.md)
 
 # Data Flow: Redis Service
 

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/ru/architecture/streams/README.md

@@ -69,4 +69,4 @@ App → StreamProducer               StreamConsumer (XREADGROUP)
 ## Смотрите также
 
 - [Data Flow →](data_flow.md)
-- [API Reference →](../../../api/streams/index.md)
+- [API Reference →](../../../en/api/streams/index.md)

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/ru/architecture/streams/data_flow.md

@@ -1,6 +1,6 @@
 <!-- type: CONCEPT -->
 
-[← Streams](README.md) | [Главная](../../index.md)
+[← Streams](README.md) | [Главная](../../../index.md)
 
 # Data Flow: Streams
 

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/ru/architecture/workers/README.md

@@ -59,4 +59,4 @@ BaseArqService  (постановка задач из кода приложен
 
 - [Data Flow →](data_flow.md)
 - [Интеграция с повторами Streams →](../streams/README.md)
-- [API Reference →](../../../api/workers/arq/index.md)
+- [API Reference →](../../../en/api/workers/arq/index.md)

{codex_platform-0.5.2 → codex_platform-0.6.0}/docs/ru/architecture/workers/data_flow.md

@@ -1,6 +1,6 @@
 <!-- type: CONCEPT -->
 
-[← Workers](README.md) | [Главная](../../index.md)
+[← Workers](README.md) | [Главная](../../../index.md)
 
 # Data Flow: Workers (ARQ)
 

codex_platform-0.6.0/docs/ru/guides/agent-skills.md

@@ -0,0 +1,25 @@
+# Установка навыка для агента
+
+Начиная с версии 0.6.0, `codex-platform` содержит необязательный автономный установщик навыка. Исходный текст навыка принадлежит библиотеке и находится в `codex_platform.agent_skills.resources`. Установщик копирует его в существующий проект по пути `.agents/skills/codex-platform/` и добавляет ограниченный блок со ссылкой в корневой `AGENTS.md`. Для обычного использования библиотеки навык устанавливать не нужно.
+
+Запускайте команды в окружении Python, где установлен `codex-platform`:
+
+```bash
+python -m codex_platform.agent_skills install --project /path/to/project
+python -m codex_platform.agent_skills status --project /path/to/project
+python -m codex_platform.agent_skills update --project /path/to/project
+python -m codex_platform.agent_skills delete --project /path/to/project
+```
+
+Параметр `--project` должен указывать на существующий каталог. После обновления пакета запустите `update`, чтобы обновить установленный навык. `status` возвращает код 0 только для актуальной установки с совпадающими версиями, хешами файлов и блоком `AGENTS.md`; отсутствие навыка или повреждение дают код 1.
+
+Установщик хранит список управляемых файлов и их SHA-256 в `.agents/skills/codex-platform/.manifest.json`. Посторонний текст в `AGENTS.md` и чужие файлы в каталоге навыка сохраняются. При локальных правках или удалении управляемых файлов команды `update` и `delete` останавливаются, чтобы не уничтожить изменения. Сохраните копию изменённых файлов, перенесите свои правила в отдельный навык и восстановите исходные байты управляемых файлов из той же версии пакета перед повторной командой. Если повреждён маркер, сохраните копию `AGENTS.md` и восстановите ограниченный блок по документации установщика. Не меняйте хеши в манифесте ради принятия локальных правок. Коллизии путей, повреждённые маркеры и манифест, символические ссылки и точки повторной обработки Windows также приводят к отказу. При обычной ошибке записи установщик пытается откатить изменения; гарантий атомарности при сбое питания или одновременном запуске нет.
+
+Управляемый блок состоит ровно из четырёх строк (с окончаниями строк проекта). Значение `separator` равно `0`, если перед блоком не понадобился дополнительный перевод строки, и `1`, если он понадобился:
+
+```markdown
+<!-- codex-platform:skill:start -->
+<!-- codex-platform:skill:separator=0 -->
+Use [codex-platform](.agents/skills/codex-platform/SKILL.md) for codex_platform work.
+<!-- codex-platform:skill:end -->
+```

{codex_platform-0.5.2 → codex_platform-0.6.0}/mkdocs.yml

@@ -71,6 +71,7 @@ plugins:
 nav:
   - Home: index.md
   - Guide (EN):
+      - Agent Skill: en/guides/agent-skills.md
       - Architecture:
           - Notifications:
               - Overview: en/architecture/notifications/README.md
@@ -85,6 +86,7 @@ nav:
               - Overview: en/architecture/workers/README.md
               - Data Flow: en/architecture/workers/data_flow.md
   - Руководство (RU):
+      - Навык для агента: ru/guides/agent-skills.md
       - Архитектура:
           - Уведомления:
               - Обзор: ru/architecture/notifications/README.md

{codex_platform-0.5.2 → codex_platform-0.6.0}/pyproject.toml

@@ -20,7 +20,7 @@ classifiers = [
 ]
 dependencies = [
     "pydantic>=2.0,<3.0",
-    "codex-core>=0.3.0,<0.10.0",
+    "codex-core>=0.5.0,<0.10.0",
 ]
 
 [project.urls]
@@ -32,7 +32,7 @@ Issues = "https://github.com/codexdlc/codex-platform/issues"
 [project.optional-dependencies]
 redis = ["redis>=5.0"]
 arq = ["arq>=0.25"]
-notifications = ["aiosmtplib>=3.0", "jinja2>=3.1"]
+notifications = ["aiosmtplib>=5.1.2", "jinja2>=3.1"]
 streams = ["codex-platform[redis]"]
 all = [
     "codex-platform[redis,arq,notifications]",
@@ -49,12 +49,12 @@ dev = [
     "pre-commit>=3.0",
     "bandit>=1.7",
     "pip-audit>=2.7",
-    "pip>=26.1",
+    "pip>=26.2.1",
     "detect-secrets>=1.5",
 ]
 docs = [
     "mkdocs>=1.5,<2.0",
-    "mkdocs-material>=9.0",
+    "mkdocs-material>=9.7.7",
     "mkdocstrings[python]>=0.24",
     "mkdocs-include-markdown-plugin",
     "mike>=2.0",

codex_platform-0.6.0/src/codex_platform/agent_skills/__init__.py

@@ -0,0 +1 @@
+# empty module

codex_platform-0.6.0/src/codex_platform/agent_skills/__main__.py

@@ -0,0 +1,4 @@
+from codex_platform.agent_skills.cli import main
+
+if __name__ == "__main__":
+    main()

codex_platform-0.6.0/src/codex_platform/agent_skills/cli.py

@@ -0,0 +1,39 @@
+import argparse
+import sys
+from collections.abc import Sequence
+from pathlib import Path
+
+from codex_platform.agent_skills.fs_transaction import FSError
+from codex_platform.agent_skills.orchestrator import OrchestratorError, check_status, perform_delete, perform_install
+
+
+def main(args: Sequence[str] | None = None) -> None:
+    parser = argparse.ArgumentParser(prog="python -m codex_platform.agent_skills")
+    parser.add_argument("action", choices=["install", "update", "delete", "status"])
+    parser.add_argument("--project", required=True, help="Path to project root")
+
+    parsed = parser.parse_args(args)
+
+    project_dir = Path(parsed.project).absolute()
+    if not project_dir.is_dir():
+        print(f"Error: Project directory does not exist or is not a directory: {project_dir}", file=sys.stderr)
+        sys.exit(1)
+
+    try:
+        if parsed.action == "install":
+            perform_install(project_dir, update=False)
+            print("Installed successfully.")
+        elif parsed.action == "update":
+            perform_install(project_dir, update=True)
+            print("Updated successfully.")
+        elif parsed.action == "delete":
+            perform_delete(project_dir)
+            print("Deleted successfully.")
+        elif parsed.action == "status":
+            is_valid, msg = check_status(project_dir)
+            print(msg)
+            if not is_valid:
+                sys.exit(1)
+    except (OrchestratorError, FSError) as e:
+        print(f"Error: {e}", file=sys.stderr)
+        sys.exit(1)