30 lines
985 B
Markdown
30 lines
985 B
Markdown
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
|