# AttractorForge

AttractorForge is a deterministic Python prototype for compiling attractor-oriented mission and biosphere controllers into auditable artifacts.

## What it does

- Defines a small attractor DSL with typed specs.
- Compiles two templates: invariant-manifold transfer and microbiome basin stabilization.
- Emits a PlanCert, BasinSketch, and Merkle-logged PlanDelta.
- Replays plans deterministically on a lightweight runtime.
- Ships toy orbital and bioreactor adapters for offline testing.

## Package

- Name: `idea194-attractorforge-verified-attractor`
- Entry point: `attractorforge`

## Example

```bash
attractorforge --kind motion_manifold --spec-id demo-motion
attractorforge --kind bio_basin --spec-id demo-bio
```

## Testing

```bash
bash test.sh
```

## Repository layout

- `src/idea194_attractorforge_verified_attractor/` core implementation
- `tests/` unit tests
- `AGENTS.md` contributor rules for future agents