idea199-replicasurety-economic-surety/AGENTS.md

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