AGENTS.md
========

Repository purpose
- Provide a minimal, well-tested foundation for ReplicaSurety: PoeticCert schema, ReplayBundle format, a tiny off-chain surety ledger and deterministic replay verifier.

Architecture & Tech Stack
- Language: Python 3.9+
- Web API: FastAPI
- Data models: Pydantic
- Packaging: setuptools/pyproject.toml
- Tests: pytest

How to run tests
- From repository root:
  - bash test.sh
  - This runs pytest and then builds the package with `python3 -m build` to validate packaging metadata.

Contribution Rules for Agents
- Make small, focused edits. Prefer minimal changes that are correct.
- Use apply_patch for edits. Do not run destructive git commands.
- If adding dependencies, update pyproject.toml accordingly.
- Keep one task in progress at a time.

Important files
- pyproject.toml: packaging metadata (package name must match idea199-replicasurety-economic-surety)
- src/: main package
- tests/: unit tests
- README.md: user-facing description