ADRs record consequential decisions that should remain understandable after the implementation context has changed.
No decisions are currently proposed.
| ADR | Status | Summary |
|---|---|---|
| 0001: Project boundaries | Accepted | One open-source workspace with a durable core library and thin CLI/MCP adapters; commercial applications remain separate. |
| 0002: RPG Maker MZ version floor | Accepted | Maintainer-led compatibility work targets RPG Maker MZ 1.10.0 and newer; older-version contributions remain welcome. |
| 0003: Stock authoring-data parity | Accepted | Tilewright pursues version-scoped, independently tested parity for stock MZ authoring data while preserving unknown and plugin-defined content. |
| 0004: Lossless JSON representation | Accepted | Adopt a Concrete Syntax Tree (CST) architectural direction to retain source bytes, project typed views, and apply operation-specific edit envelopes. |
| 0005: Filesystem sandboxing | Accepted | Tilewright will use capability-based filesystem APIs (cap-std) to confine project operations beneath an already-authorized directory handle. Initial root acquisition remains unresolved, and the current experimental discovery API uses std::fs as a temporary exception. |
| 0006: Snapshot loading contract | Accepted | Adopt an experimental, capability-relative, bounded, read-only raw snapshot loader with deterministic partial diagnostics. |
| 0007: Experimental map catalog projection | Accepted | Adopt a read-only, owned typed projection for map identity, display order, hierarchy, and contextual findings over a raw project snapshot. |
| 0008: Experimental selected-map summary | Accepted | Adopt a read-only owned summary for one catalog-selected map's basic metadata, dimensions, tileset scalar, and opaque event count. |
| 0009: Experimental system summary | Accepted | Add a read-only owned summary for selected System.json metadata and map-position scalars. |
| 0010: Experimental player-start validation | Accepted | Compose the bounded system, catalog, and selected-map projections into deterministic player-start findings without implying general project validity. |
| 0011: Experimental selected-map event catalog | Accepted | Add a read-only owned projection of map-scoped event IDs, names, positions, and opaque page counts for one catalog-selected map. |
| 0012: Experimental tileset catalog | Accepted | Add a read-only owned projection of catalog-scoped tileset IDs and editor-facing names while leaving modes, images, flags, and notes opaque. |
| 0013: Experimental map-tileset reference validation | Accepted | Compose map summaries and the tileset catalog into deterministic missing-reference findings without implying general validity. |
| 0014: Signed player-start coordinates | Accepted | Correct the experimental system and player-start projections to retain observed signed coordinates and report their map relationship contextually. |
An ADR should state its status, context, decision, rationale, consequences, and important alternatives. Link evidence or experiments where they matter. Do not mark a proposal accepted without maintainer agreement.
Prefer a new superseding ADR when reversing an accepted decision so that the reasoning history remains visible. Update the architecture and user-facing docs in the same change.