idea187-autopoiesis-verifia.../AGENTS.md

1.3 KiB

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