Document the 0.11.0 release: atlas diff --json-tests, atlas stage
Both features close out the differential-CI toolkit StratumParity's field
usage asked for: --json-tests lets a differential pipeline read per-test
outcome, duration and stdout straight from the diff JSON instead of a
hand-rolled TRX parser, and atlas stage pre-stages the engine assembly
explicitly so a one-shot cross-install script boots green on the first
try instead of needing auto-staging's fail-then-rerun cycle.
Document the 0.10.0 release: atlas diff, EntitySimulationTicks, engine-assembly auto-staging
Home: version blurb moves to v0.10.0, leading with the three headline
features (differential atlas diff, the entity-simulation tick counter, and
build-newest-run-older auto-staging) and the two EngineCompat fixes; the 0.9.0
material folds into the earlier-releases summary. The documentation table gains
atlas diff (CLI) and multi-install auto-staging (Compatibility).
CLI: new atlas diff section covering the command, the name-keyed matching
(theory rows and rerun merges), the six change categories, the CI-gating exit
codes and the versioned --json shape, framed around the differential-CI use
case. Intro, command list and option summary updated for the third command.
Compatibility: new Multi-install runs section documenting the trap, the
launch-time auto-staging mechanism, the supported build-newest-run-older
pattern and the honest reverse-direction refusal. The Below the floor caveat is
rewritten: the prebuilt-cross-install path is now proven by a per-push CI lane,
no longer "designed for but no CI lane yet".
Writing Scenarios: EntitySimulationTicks added to the world API table and the
time model, plus a tick contract subsection pinning that Vintage Story has no
fixed simulation step, what await World.Ticks(n) does and does not guarantee,
and the anchor-probes-to-player.Entity.Pos-not-world-spawn guidance.
Document the 0.9.0 release: [AtlasTheory], Playing-state test players, widened isolation summaries, engine-crash fail-fast
Writing-Scenarios gets an [AtlasTheory] attribute-reference section
(credited to Seggr, the first external contribution) because that page
is where scenario authoring lives; the test-players section documents
the new Playing-state default and its observable side effects (chat
join announcement, natural spawning, valid interaction targets), since
that is what mod authors will notice first; the isolation-summary
section adopts the new wording (explicit capture line item,
FreshWorld-only summaries) so the documented lines match what 0.9.0
actually prints. Troubleshooting and Architecture gain the
engine-initiated-shutdown fail-fast note pointing at server-main.log,
because a crash that used to look like a hang needs a documented
diagnosis path. Home moves to the 0.9.0 blurb, floor change included.
Document the 0.8.0 release: universal rollback, the mod-cooperation hooks, isolation cost totals
Writing-Scenarios: the RollbackWorld section covers players and
mini-dimensions (what a rollback restores, the remaining honest boundaries:
un-hooked mod in-memory state, in-memory map chunk state), the degrade
reasons drop the no-longer-produced players-joined and mini-dimension cases,
and the isolation summary gains the cost totals plus the restart-cost note
(also surfaced per scenario and aggregated by atlas run --parallel). New
section: Cooperating with rollback (mods), the hook contract with a
reconciliation handler modeled on Manifold's real one (drop via the mod's
own teardown path, keep matching records, re-seed missing ones), when a mod
needs the hook and when lifecycle events suffice, failure semantics, and the
real-consumer validation. Home blurb to 0.8.0.
Document the 0.7.0 release: isolation trilogy, atlas fixture, PlaceSchematic
Writing-Scenarios: the isolation section becomes the trilogy (FreshWorld,
RollbackWorld, RestartWorld) with RestartWorld semantics (players guard,
SaveFile composition), rollback degrade visibility, StrictIsolation, the
per-class isolation summary, the lazy-capture ordering callout and the
mini-dimensions-on-demand lesson; PlaceSchematic gets its own section next to
the fixtures story. CLI: atlas fixture reference with the builder-scenario
contract, --version, per-test output under atlas run. Home: version blurb to
0.7.0. Getting-Started: package pin to 0.7.0.
Document 0.6.0: world rollback, the CLI page, parallel execution
- Writing-Scenarios: RollbackWorld in the attribute reference plus a Rollback vs
FreshWorld section (lazy capture, fail-closed fallback, stage 1 boundaries).
- New CLI page: atlas run, --filter, --list, worker mode (JSONL protocol pointer),
--parallel with the default worker count rationale, --worker-timeout, --trx.
- CI-Recipes: parallel execution note (atlas run --parallel with --trx as an
alternative to dotnet test, CPU tradeoff on small runners).
- Home: version blurb to 0.6.0, CLI row in the documentation table.
- Sidebar: CLI entry.
- Getting-Started: stale 0.4.0 package pin bumped to 0.6.0, CLI pointer.
Document 0.5.0: data file seeding, world fixtures, IsConnected, shutdown NRE instrumentation
docs: update the wiki for 0.4.0 (command results, concurrent players)
wiki: initial full documentation