Metadata-Version: 2.4
Name: hexaswarm-core
Version: 0.1.1
Summary: Universal primitives for Claude-native multi-agent software delivery — orchestrator, cost tracker, safety, stack adapters, and the `hexa` CLI.
Project-URL: Homepage, https://github.com/pna03100/hexa-swarm-template
Project-URL: Issues, https://github.com/pna03100/hexa-swarm-template/issues
Author-email: PNA Company <taemin@pnamarketing.co.kr>
License: MIT
Keywords: agentic,anthropic,claude,claude-code,enterprise-ai,hexa-swarm,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: pydantic<3,>=2.9
Requires-Dist: pyyaml<7,>=6.0
Requires-Dist: structlog<26,>=24.4
Requires-Dist: typer<0.20,>=0.12
Provides-Extra: dev
Requires-Dist: mypy<2,>=1.12; extra == 'dev'
Requires-Dist: pytest-cov<7,>=5; extra == 'dev'
Requires-Dist: pytest<9,>=8.3; extra == 'dev'
Requires-Dist: ruff<0.12,>=0.8; extra == 'dev'
Requires-Dist: types-pyyaml<7,>=6.0; extra == 'dev'
Provides-Extra: mcp
Requires-Dist: mcp<2,>=1.0; extra == 'mcp'
Description-Content-Type: text/markdown

# hexa-swarm-core

Universal primitives for Claude-native multi-agent software delivery.
Provides the `hexa` CLI plus a Python library used by `hexa-swarm-template` and any project adopted via `hexa adopt .`.

## What lives here

- **`hexa` CLI** — `hexa adopt`, `hexa quality-gate`, `hexa lock`, `hexa session`, `hexa cost-track`
- **StackAdapter protocol** — pluggable language/framework support (py-fastapi, node-next, go-chi, …)
- **Orchestrator primitives** — atomic file locks, session UUID, heartbeat, contract writer queue
- **Telemetry** — JSONL cost tracker, structured logging, trace IDs
- **Safety** — KillSwitch, CostCeiling, CircuitBreaker, stochastic delay
- **Exceptions** — `SafetyViolationError(invariant=...)` hierarchy
- **Config** — Pydantic nested settings

## Install

```bash
pipx install hexa-swarm-core
hexa --help
```

## Adopt an existing repo (non-destructive)

```bash
cd my-existing-project
hexa adopt . --dry-run   # show what would change
hexa adopt .             # install Tier A only
```

See the parent repo's [README](../README.md) and [ARCHITECTURE.md](../ARCHITECTURE.md) for the full picture.
