community
/
idea194-attractorforge-verified-attractor
34
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
idea194-attractorforge-veri.../AGENTS.md

1.1 KiB
Raw Blame History

Repository Guide

Architecture

  • src/idea194_attractorforge_verified_attractor/models.py defines the DSL and artifact objects.
  • src/idea194_attractorforge_verified_attractor/adapters.py contains deterministic toy dynamics for orbital and bioreactor simulations.
  • src/idea194_attractorforge_verified_attractor/compiler.py turns specs into controllers, PlanCerts, BasinSketches, and Merkle-logged PlanDeltas.
  • src/idea194_attractorforge_verified_attractor/runtime.py provides deterministic execution and replay verification.
  • src/idea194_attractorforge_verified_attractor/cli.py exposes a small CLI for manual inspection.

Tech Stack

  • Python 3.11+
  • Standard library only for runtime logic
  • pytest for tests
  • setuptools build backend via pyproject.toml

Rules

  • Keep controller behavior deterministic.
  • Preserve bounded control outputs in the compiler and runtime.
  • Prefer small, explicit data models over implicit dictionaries.
  • Update tests whenever compiler or runtime behavior changes.
  • Keep artifact hashes stable by using canonical JSON formatting.

Testing

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