36 lines
1.3 KiB
Markdown
36 lines
1.3 KiB
Markdown
# 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.
|
|
- `admission.py`: signed capability tokens and deterministic admission decisions.
|
|
- `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`
|