# AGENTS.md

## Repository Purpose

This repository contains a Python reference implementation for the Autopoiesis service-genome fabric.

## Architecture

- `genome.py`: genome schema, canonical hashing, Ed25519 signing, signed artifact verification.
- `policy.py`: policy templates, deterministic smoke-test evaluation, safety attestation.
- `ledger.py`: append-only provenance ledger, Merkle root computation, replay trace models.
- `replicator.py`: deterministic replication planner and lightweight ReplicaWeave intent model.

## Tech Stack

- Python 3.11+
- `pydantic` for strict data models
- `cryptography` for Ed25519 signing and verification
- `pytest` for tests
- `build` for packaging verification

## Rules

- Keep changes deterministic and canonical where hashes or signatures are involved.
- Preserve frozen model semantics unless there is a concrete reason to relax them.
- Prefer the smallest correct change that improves safety, verification, or reproducibility.
- Update tests whenever schema, policy, or hashing behavior changes.
- Keep public APIs importable from `idea187_autopoiesis_verifiable_service.__init__`.

## Test Commands

- `bash test.sh`
- `python3 -m build`
- `python3 -m pytest`