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.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.