Module epoch 

epoch sub-command

The epoch sub‑command is the single entry point for all epoch‑related operations in efo.
An epoch represents a point in the simulated world’s history.
The command lets you inspect, advance, modify and sanity‑check the epoch timeline.

Usage

# Show log of epochs (last 20 by default)
efo epoch log --limit 20

# Switch to an existing epoch
efo epoch switch 5

# Create the next epoch if none exist in the future
efo epoch next

# Delete all future epochs, returning to the present
efo epoch reset

# Add a unique tag to the current epoch
efo epoch tag milestone1

# Replace the current epoch’s summary
efo epoch summary "Reached the new frontier"

# (Future) Check consistency
efo epoch fsck

Summary

Sub‑command	Usage	What it changes
log	efo epoch log [--limit N]	Prints the chronological list of epochs up to the current one.
switch	efo epoch switch <id>	Sets the current epoch to the specified <id> (must already exist).
next	efo epoch next	Generates the next scheduled epoch and inserts it.
reset	efo epoch reset	Deletes all epochs with an identifier greater than the current one.
diff	efo epoch diff <id1> <id2>	Unimplemented – placeholder for future diffing logic.
tag	efo epoch tag <TAG>	Adds a unique tag to the current epoch, updating the global tag map.
fsck	efo epoch fsck	Unimplemented – intended to run a consistency check.
summary	efo epoch summary <text>	Replaces the summary field of the current epoch with <text>.

Modules

cli_epoch

epoch CLI module

Functions

handle_cmd

Public entry point used by efo::main - dispatches to the real handler that lives in crate::world::EpochManager.

handle_diff 🔒

Show a diff between two epochs.

handle_fsck 🔒

Perform a filesystem consistency check on the epoch data.

handle_log 🔒

Show a log of all epochs up to the current one.

handle_next 🔒

Handle the next sub-command.

handle_reset 🔒

Handle the reset sub-command.

handle_summary 🔒

Edits the summary for the current epoch.

handle_switch 🔒

Switches the current epoch to the one specified by the user.

handle_taging 🔒

Handle the tag sub-command.