Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

Unreleased

Initial public release of AgentForge
Core Simulation Framework
- defineScenario() for declarative scenario configuration
- BaseAgent class with memory, cooldowns, and parameter support
- SimulationEngine for orchestrating simulation lifecycle
- Deterministic seeded RNG for reproducible results
Scheduling Strategies
- Round-robin execution
- Random (shuffled) execution
- Priority-based execution
Metrics and Analytics
- Time-series metric collection
- CSV export for analysis
- JSON summary generation
- Action logging (NDJSON format)
Assertions System
- Post-simulation validation
- Comparison operators: gt, gte, lt, lte, eq
- CI-friendly exit codes on assertion failure
CLI Tool (agentforge / forge-sim)
- init - Initialize simulation folder structure
- run - Execute scenario files
- doctor - Check environment dependencies
- types - Generate TypeScript types from Foundry artifacts
Adapters
- Anvil adapter for local EVM simulation
- Viem client integration
- Foundry artifact parsing
Toy Simulation Pack
- ToyPack for development and testing
- RandomTraderAgent - Random buy/sell decisions
- MomentumAgent - Trend-following behavior
- MarketMakerAgent - Spread-based market making
Developer Experience
- Full TypeScript support with type inference
- ESM module format
- Comprehensive JSDoc documentation on core APIs
- Example scenarios in examples/ directory