This is the fresh MIT Rust authoring application for Atrinik. It is independent
of Gridarta, atrinik/classic, the connected client, protocol, and server.
The editor is part of Atrinik's agentic next-generation reimplementation. Its fresh MIT-licensed Rust code is developed primarily through OpenAI Codex workflows under maintainer direction and review, with evidence-gated provenance controls, tests, and repository validation. This describes the project's current primary development workflow, not every line, commit, or contributor; direct human-written code contributions are welcome.
The current foundation was independently implemented rather than mechanically translated or source-ported. Future exact historical reuse is evidence-gated by the local provenance record and canonical grant registry: admitted destination material may be consulted and MIT-relicensed, while every uncovered portion remains excluded and the Classic repository remains GPL-distributed. Follow the replacement roadmap and the canonical project authorship statement for the wider project boundaries.
The editor operates on human-authored maps, quests, lore, archetypes, pixel art, and other creative game content with its own exact creator or upstream provenance and licenses. That content is distinct from the editor's MIT-licensed code, and the editor must not add a generative-content feature that conflicts with the owning content repository's policy.
The editor pins the immutable v1.0.0 source revisions of
atrinik/content-toolkit and
atrinik/renderer. Toolkit documents and
transactions remain authoritative; renderer scenes and GPU resources remain
renderer-owned. Wrapper profiles are the only supported local override
mechanism.
released content toolkit -> document adapter -> semantic commands/history
| |
project/path policy ------------------+------> UI model ----+-> app
released renderer -------> scene/preview adapter ----------+
The seven workspace crates own application composition, project/tab and safe path state, document adaptation, commands/history, UI panels/tools, preview integration, and deterministic test fakes. None owns a parser, serializer, filesystem writer, renderer, network service, or server lifecycle.
Rust 1.97.1 and SDL 3.4.14 are pinned. Linux builds need the native SDL headers
installed by tools/install-linux-native-deps.sh. The Atrinik devcontainer
release that includes the editor toolchain also provides them.
cargo build --locked --workspace
cargo test --locked --workspace --all-targets
cargo run --locked --package atrinik-editor -- version
cargo run --locked --package atrinik-editor -- headless
SDL_VIDEO_DRIVER=dummy cargo run --locked --package atrinik-editor -- window
tools/validate.shtools/validate.sh checks formatting, Clippy-as-errors, all tests/docs,
dependency architecture/licenses/advisories, provenance/assets, path/inventory
contracts, the shared-renderer empty viewport, SDL lifecycle, Linux release
dry-run/SBOM/reproducibility, and diff hygiene. GitHub also builds/tests/packages
on Windows and exposes one required aggregate check named Editor validation.
The root wrapper does not yet expose replacement editor build/run commands;
that handoff belongs to atrinik/atrinik#266. It must use profile-local Cargo
overrides rather than editing these manifests. The editor never launches a
server; future playtests use wrapper-owned profile/topology/state lifecycle.
ADR 0001, the threat model, and mutable path table define authority. The machine-readable behavior inventory assigns every observed classic authoring workflow to one owner/issue/milestone and requires fixture evidence before parity claims.
Every squash merge uses a Conventional Commit PR title and semantic-release. Linux and Windows packages include checksums, CycloneDX SBOMs, provenance, license, and third-party notices; no content, server/client, classic code, Gridarta, recovery data, or mutable project state is bundled.