feat: prepare v0.1.0 release

- Complete documentation rewrite with professional formatting
- Add brand assets (logos for light/dark mode)
- Add TypeDoc API documentation
- Enhance adapters (anvil, foundry, viem)
- Add TypeScript scenario loading via tsx
- Add changesets for version management
- Add testing helpers and statistics utilities
- Configure for NPM publication

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: wkyleg

.changeset/README.md

@@ -0,0 +1,29 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)
+
+## Adding a changeset
+
+When you make changes that should be released, run:
+
+```bash
+pnpm changeset
+```
+
+This will prompt you to:
+1. Select the type of change (major, minor, patch)
+2. Write a summary of the changes
+
+The changeset file will be committed with your PR.
+
+## Releasing
+
+When changesets are merged to main, a GitHub Action will:
+1. Create a "Version Packages" PR with version bumps and CHANGELOG updates
+2. When that PR is merged, it creates a git tag
+3. The tag triggers the release workflow to publish to npm

.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

.github/workflows/changesets.yml

@@ -0,0 +1,52 @@
+name: Changesets
+
+on:
+  push:
+    branches:
+      - main
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Create Release Pull Request or Tag
+        id: changesets
+        uses: changesets/action@v1
+        with:
+          version: pnpm changeset version
+          publish: pnpm run release:tag
+          title: 'chore: version packages'
+          commit: 'chore: version packages'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Push tags
+        if: steps.changesets.outputs.hasChangesets == 'false'
+        run: git push --follow-tags

CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-01-27
+
+### Added
+
+- 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
+
+### Documentation
+
+- README with installation, quick start, and API reference
+- CONTRIBUTING.md with development guidelines
+- Example scenarios demonstrating key features
+
+[Unreleased]: https://github.com/wkyleg/agentforge/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/wkyleg/agentforge/releases/tag/v0.1.0