Metadata-Version: 2.4
Name: agentmesh-core
Version: 0.4.0
Summary: Local-first multi-agent coordination and provenance for coding workflows
Project-URL: Homepage, https://github.com/Haserjian/agentmesh
Project-URL: Repository, https://github.com/Haserjian/agentmesh
Project-URL: Issues, https://github.com/Haserjian/agentmesh/issues
Project-URL: CI Action, https://github.com/Haserjian/agentmesh-action
Author-email: Timmy Bhaserjian <timmy@haserjian.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agents,ai,coordination,git,lineage,multi-agent,provenance
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Version Control :: Git
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: pydantic>=2.0
Requires-Dist: rich>=13.0
Requires-Dist: typer>=0.9
Provides-Extra: dev
Requires-Dist: pytest-tmp-files>=0.0.2; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Description-Content-Type: text/markdown

# AgentMesh

Local-first multi-agent coordination and provenance for coding workflows.

AgentMesh adds deterministic coordination (claims, waits, steals), commit-linked lineage (`AgentMesh-Episode` trailers + weave events), and portable handoff bundles (`.meshpack`) on top of normal git workflows.

## Install

```bash
pip install agentmesh-core
```

## Quick Start

```bash
# in your repo
agentmesh init --install-hooks

agentmesh task start --title "Fix login timeout" \
  --claim src/auth.py --claim tests/test_auth.py

# edit + stage as normal
git add src/auth.py tests/test_auth.py

agentmesh task finish --message "Fix login timeout handling" \
  --run-tests "pytest -q tests/test_auth.py"
```

## CI Integration

This repo uses [`Haserjian/agentmesh-action@v1`](https://github.com/Haserjian/agentmesh-action) for PR lineage coverage.

```yaml
name: Lineage Check

on:
  pull_request:
    types: [opened, synchronize, reopened, ready_for_review]

permissions:
  contents: read
  pull-requests: write

jobs:
  lineage:
    runs-on: ubuntu-latest
    steps:
      - uses: Haserjian/agentmesh-action@v1
        with:
          require-trailers: "false"  # set to "true" to enforce 100% coverage
```

The check reads commit trailers in the PR range and reports lineage coverage in both the Action summary and a sticky PR comment.
