Atrinik content

This repository owns Atrinik's authored archetypes, maps, editor material, and the collection tools that turn those sources into server runtime input. See docs/ARCHITECTURE.md for the ownership boundaries and source-to-runtime validation flow.

The content has heterogeneous licensing. arch/COPYING, maps/COPYING, and the nearest LICENSE file for an asset are authoritative; the repository does not apply one blanket license to every file. Releases preserve those notices and include a machine-readable digest manifest.

The clean-room replacement boundary is recorded under provenance/m1. It inventories every Python behavior at the immutable main/1.x fork, assigns one non-Python replacement owner and acceptance scenario, and provides exact reusable-material package allowlists. It does not relicense the corpus or authorize copying implementation from the historical Python sources.

main and maintained classic branch 1.x have distinct ownership and release contracts. Main uses release line 2.0; classic maintenance uses the bounded 1.x channel. See docs/RELEASE_LINES.md for target selection, linked backport/forward-port policy, compatibility metadata, and the bounded maintenance channel.

Build and validate a runtime tree without modifying authored sources:

python3 tools/build_runtime.py --output build/runtime
python3 tools/validate.py

The result contains collected files under lib/, compiled map interfaces and authored maps under maps/, attribution files under attribution/, and manifest.json with the SHA-256 of every packaged file.

The typed content catalog defines stable identities and validates authored cross-references before collection. See docs/CONTENT_IDENTITIES.md for its commands, source-of-truth table, and rename/removal policy.

The authoritative field schema closes and types the authored field surface and generates loader/compiler, editor, documentation, and parser-neutral logical metadata. See docs/CONTENT_SCHEMA.md for the logical model, generated outputs, custom namespace policy, and migration rules. Validate the checked-in projections and the entire legacy corpus with:

python3 -m tools.content_schema validate --root .

Versioned legacy ADS grammar contracts, consumer ownership, interchange schemas, and the lossless parity corpus live under contracts/content-v1/. See docs/CONTENT_GRAMMAR_CONTRACTS.md for the authoritative server sources, compatibility rules, fixture coverage, and read-only inspection command.

tools/content_core is the production byte-lossless legacy ADS core. Its versioned tools/atrinik-content CLI provides bounded inspection, validation, semantic comparison, catalog search, and dry-run-first primitive transactions. See docs/CONTENT_CORE.md for the JSON contracts, preconditions, safety boundary, exit codes, and examples.

The accepted future authored surface is a strict, bounded JSONC dialect. See docs/AUTHORED_SYNTAX_DECISION.md for the decision, parser limits, cross-language implementation constraints, raw measurements, and reproduction workflow. Evaluate the locked parity corpus without changing authored sources:

python3 -m tools.syntax_evaluation --root . --json

For read-only exploratory inventories of quests, regions, artifacts, maps, named objects, and archetype locations, run:

python3 tools/world_content_audit.py all > build/world-content-audit.json

Pass quests, regions, artifacts, or world for a focused report. The audit emits deterministic JSON and never modifies authored content. It is a review aid, not a replacement for tools/validate.py or the typed catalog.