codex-platform 0.5.1__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.1 → 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.1 → codex_platform-0.6.0}/CHANGELOG.md

@@ -5,6 +5,29 @@ 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
+- Added the framework-agnostic `codex_platform.messaging` package with notification delivery, campaign, threading, renderer, and SMTP primitives.
+
+### Deprecated
+- Deprecated `codex_platform.notifications` modules in favor of `codex_platform.messaging` compatibility re-exports.
+
+### Fixed
+- Reduced Redis Streams consumer latency by using configurable blocking `XREADGROUP` reads instead of relying on the processor polling interval for normal wakeups.
+
 ## [0.5.1] - 2026-04-30
 
 ### Fixed

{codex_platform-0.5.1 → 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.1
+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.1 → 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.1 → codex_platform-0.6.0}/docs/en/api/index.md

@@ -6,7 +6,8 @@ Auto-generated from source docstrings (Google style). If code behavior contradic
 
 | Module | Description |
 | :--- | :--- |
-| [notifications](notifications/index.md) | Multi-channel notification engine |
+| [messaging](messaging/index.md) | Framework-agnostic messaging engine |
+| [notifications](notifications/index.md) | Deprecated compatibility path for messaging |
 | [redis_service](redis_service/index.md) | Async Redis abstraction with typed operations |
 | [streams](streams/index.md) | Redis Streams producer/consumer event bus |
 | [workers.arq](workers/arq/index.md) | ARQ background worker base infrastructure |

codex_platform-0.6.0/docs/en/api/messaging/audience.md

@@ -0,0 +1,5 @@
+<!-- type: REFERENCE -->
+
+# messaging.audience
+
+::: codex_platform.messaging.audience

codex_platform-0.6.0/docs/en/api/messaging/campaigns/dto.md

@@ -0,0 +1,5 @@
+<!-- type: REFERENCE -->
+
+# messaging.campaigns.dto
+
+::: codex_platform.messaging.campaigns.dto

codex_platform-0.6.0/docs/en/api/messaging/campaigns/index.md

@@ -0,0 +1,5 @@
+<!-- type: REFERENCE -->
+
+# messaging.campaigns
+
+::: codex_platform.messaging.campaigns

codex_platform-0.6.0/docs/en/api/messaging/campaigns/protocols.md

@@ -0,0 +1,5 @@
+<!-- type: REFERENCE -->
+
+# messaging.campaigns.protocols
+
+::: codex_platform.messaging.campaigns.protocols

codex_platform-0.6.0/docs/en/api/messaging/channels.md

@@ -0,0 +1,5 @@
+<!-- type: REFERENCE -->
+
+# messaging.channels
+
+::: codex_platform.messaging.channels

codex_platform-0.6.0/docs/en/api/messaging/clients/smtp.md

@@ -0,0 +1,5 @@
+<!-- type: REFERENCE -->
+
+# messaging.clients.smtp
+
+::: codex_platform.messaging.clients.smtp

codex_platform-0.6.0/docs/en/api/messaging/delivery/arq.md

@@ -0,0 +1,5 @@
+<!-- type: REFERENCE -->
+
+# messaging.delivery.arq
+
+::: codex_platform.messaging.delivery.arq

codex_platform-0.6.0/docs/en/api/messaging/delivery/base.md

@@ -0,0 +1,5 @@
+<!-- type: REFERENCE -->
+
+# messaging.delivery.base
+
+::: codex_platform.messaging.delivery.base

codex_platform-0.6.0/docs/en/api/messaging/delivery/direct.md

@@ -0,0 +1,5 @@
+<!-- type: REFERENCE -->
+
+# messaging.delivery.direct
+
+::: codex_platform.messaging.delivery.direct

codex_platform-0.6.0/docs/en/api/messaging/dto.md

@@ -0,0 +1,5 @@
+<!-- type: REFERENCE -->
+
+# messaging.dto
+
+::: codex_platform.messaging.dto

codex_platform-0.6.0/docs/en/api/messaging/index.md

@@ -0,0 +1,8 @@
+<!-- type: REFERENCE -->
+
+# messaging
+
+Framework-agnostic messaging primitives. This package is the primary import
+path for the former `codex_platform.notifications` API.
+
+::: codex_platform.messaging

codex_platform-0.6.0/docs/en/api/messaging/orchestrator.md

@@ -0,0 +1,5 @@
+<!-- type: REFERENCE -->
+
+# messaging.orchestrator
+
+::: codex_platform.messaging.orchestrator

codex_platform-0.6.0/docs/en/api/messaging/registry.md

@@ -0,0 +1,5 @@
+<!-- type: REFERENCE -->
+
+# messaging.registry
+
+::: codex_platform.messaging.registry

codex_platform-0.6.0/docs/en/api/messaging/renderer.md

@@ -0,0 +1,5 @@
+<!-- type: REFERENCE -->
+
+# messaging.renderer
+
+::: codex_platform.messaging.renderer

codex_platform-0.6.0/docs/en/api/messaging/threading.md

@@ -0,0 +1,5 @@
+<!-- type: REFERENCE -->
+
+# messaging.threading
+
+::: codex_platform.messaging.threading

codex_platform-0.6.0/docs/en/api/messaging/workers_contract.md

@@ -0,0 +1,5 @@
+<!-- type: REFERENCE -->
+
+# messaging.workers_contract
+
+::: codex_platform.messaging.workers_contract

codex_platform-0.6.0/docs/en/api/notifications/index.md

@@ -0,0 +1,8 @@
+<!-- type: REFERENCE -->
+
+# notifications
+
+Deprecated compatibility path. New code should import from
+`codex_platform.messaging`.
+
+::: codex_platform.notifications

{codex_platform-0.5.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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.1 → 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)