# đŚ Epoch Forge (`epoch_forge`)
> **A Rustâpowered CLI for managing fantasy organisations across time.**
> *Think of it as a living, breathing worldâstate engine that lets you ârewindâ, âfastâforwardâ, and **alter** the history of guilds, towns, wars, and characters.*
> đ *Fast, typeâsafe, and fully testable.*
## ⨠Quick start
```bash
# clone the repo
git clone https://github.com/yourname/epoch_forge.git
cd epoch_forge
# install the binary
cargo install --path .
# initialise an empty world (epoch 0)
efo epoch --init
# add a guild
efo org add --name "The Iron Horde" --leader "Gorun"
# add a town
efo town add --name "Durn" --population 350
# create an alliance
efo link add --type alliance --org "Iron Horde" --town "Durn"
# advance the timeline
efo epoch --advance 3
# inspect the world
cat world.json
```
## đ Project Highlights
| Feature | What it gives you | Where it lives |
|---------|------------------|----------------|
| **Epoch management** | Switch, advance, or rewind the timeline | `core::epoch` |
| **Event handling** | Add/remove worldâshaping events (storms, festivals, wars) | `core::event` |
| **Organisation CRUD** | Guilds, factions, corporations | `core::org` |
| **Character CRUD** | Heroes, villains, NPCs | `core::character` |
| **Town CRUD** | Villages, cities, trade hubs | `core::town` |
| **Link network** | Alliances, wars, roads, trade routes | `core::link` |
| **Persistence** | JSON/YAML stores, pluggable backâends | `core::storage` |
| **CLI** | `efo` binary with subâcommands | `efo` crate |
| **Tests** | Unit & integration coverage | `tests/` |
### đ Quick reference table
| Subâcommand | Usage | What it changes |
|-------------|-------|-----------------|
| `epoch` | `efo epoch --init`
`efo epoch --advance N`
`efo epoch --target ID` | Creates a world; moves time forward or back. |
| `event` | `efo event add ...`
`efo event remove ...` | Adds or removes an event. |
| `org` | `efo org add ...`
`efo org remove ...` | Manages guilds/factions. |
| `chr` | `efo chr add ...`
`efo chr remove ...` | Handles characters. |
| `town` | `efo town add ...`
`efo town remove ...` | Town CRUD. |
| `link` | `efo link add ...`
`efo link remove ...` | Relations: alliances, wars, roads, trade. |
Happy forging! đ¨â¨