Metadata-Version: 2.4
Name: relaypy
Version: 0.1.0
Summary: CLI share system - command deduplication, task queue, smart merge
Author-email: Koosha Pari <kooshapari@kooshapari.com>
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: pydantic>=2.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: watchfiles>=0.21.0
Provides-Extra: dev
Requires-Dist: bandit>=1.7.0; extra == 'dev'
Requires-Dist: mypy>=1.5.0; extra == 'dev'
Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# thegent-cli-share

CLI share system for multi-agent orchestration - command deduplication, task queue, smart merge, and coordination.

## Architecture

This crate follows **Hexagonal Architecture** (Ports & Adapters) with **Clean Architecture** layers.

## xDD Methodologies Applied

- **TDD**: Tests written first
- **DDD**: Bounded contexts for command cache, task queue, smart merge
- **SOLID**: Single responsibility per module
- **CQRS**: Separate command and query interfaces
- **EDA**: Domain events for state changes

## Domain Services

### Command Deduplication
Prevents duplicate command execution across agents using SHM-based locks.

### Task Queue
Maildir-style queue for distributed task processing.

### Smart Merge
Mergiraf-style AST-aware merging for conflict resolution.

### Coordination
HLC-based distributed coordination.

## Installation

```bash
pip install thegent-cli-share
```

## CLI Usage

```bash
# Command deduplication
thegent-cli-share lock-acquire <cmd_hash>
thegent-cli-share lock-release <cmd_hash> --pid <pid>
thegent-cli-share lock-list

# Task queue
thegent-cli-share queue-enqueue <command> --priority high
thegent-cli-share queue-list
```

## Python API

```python
from thegent_cli_share.adapters.dedup import InMemoryLockAdapter

adapter = InMemoryLockAdapter()
lock = adapter.acquire("cmd_hash", pid=1234)
```

## License

MIT
