Metadata-Version: 2.4
Name: conhugo-agents-flow
Version: 0.1.1
Summary: Open source development-process tooling for human and agent coordination across Git repositories
License-Expression: MIT
Project-URL: Homepage, https://github.com/cervantesh/conhugo-agents-flow
Project-URL: Repository, https://github.com/cervantesh/conhugo-agents-flow
Project-URL: Issues, https://github.com/cervantesh/conhugo-agents-flow/issues
Keywords: agents,git,workflow,coordination,developer-tools,ai-agents
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Version Control :: Git
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# ConHugo Agents Flow

Open source tooling for coordinating humans and agents while they work inside Git repositories.

`ConHugo Agents Flow` is not product runtime code. It is development-process tooling: durable handoffs, shared working memory, anti-drift checks, and upgradeable repo-local coordination artifacts.

## What It Does

- publishes durable machine-readable events between agents
- keeps repo-local coordination state under `.agents/` and `docs/coordination/`
- blocks commits when action-required updates are unread
- installs and upgrades managed repo artifacts
- validates installation health and version drift with `doctor`

## What It Is Not

- not business logic
- not application runtime
- not deployment runtime
- not customer-facing functionality
- not product telemetry

## Installation

```bash
pip install conhugo-agents-flow
```

## Basic Usage

Bootstrap a target repository:

```bash
conhugo-agents-flow install --repo-root /path/to/repo
```

Upgrade a target repository to the current version:

```bash
conhugo-agents-flow install --repo-root /path/to/repo --upgrade
conhugo-agents-flow doctor --repo-root /path/to/repo
```

Core commands:

```bash
conhugo-agents-flow publish --repo-root /path/to/repo --from codex-a --to codex-b --issue 12 --branch feat/12-x --summary "Ready for review" --action-required
conhugo-agents-flow check --repo-root /path/to/repo --agent codex-b
conhugo-agents-flow ack --repo-root /path/to/repo --agent codex-b
conhugo-agents-flow doctor --repo-root /path/to/repo
```

The legacy alias `agent-bus` is also exposed as a CLI entrypoint.

## Repo Footprint

A target repository may contain a local coordination instance with:

- `.agents/`
- `docs/coordination/`
- `agent-bus.json`
- `AGENT_BUS.md`
- `.githooks/`
- a thin wrapper script

That footprint is process infrastructure only. It is not shipped product code.

## Versioning and Upgrades

- package version comes from `src/agent_bus/__init__.py`
- installed repos record the current package version in `agent-bus.json`
- `doctor` detects version drift and missing managed files
- `install --upgrade` refreshes only managed static files and preserves live repo state like event streams and active handoffs

## Current Hardening

- atomic writes for registry, acks, manifest, and generated docs
- lock files for mutating operations and ops-log writes
- managed static file inventory in the manifest
- installation health checks through `doctor`
- unit tests for bootstrap, publish/check/ack, upgrade behavior, doctor, and lock contention

## Development

Run tests:

```bash
python -m unittest discover -s tests -v
```

Build artifacts:

```bash
python -m pip install build
python -m build
```

## Release

- update `src/agent_bus/__init__.py`
- update `CHANGELOG.md`
- push a tag like `v0.1.1`
- GitHub automatically creates a GitHub Release with generated notes for every `v*` tag
- GitHub Actions will build and validate artifacts on version tags
- manual dispatch of the publish workflow can be used for TestPyPI or PyPI when publishing is configured

See [CONTRIBUTING.md](C:/dev/conhugo-agents-flow/CONTRIBUTING.md) for the development and release flow.

## License

MIT
