mapkeeper-cell-schema

name	mapkeeper-cell-schema
description	JSON Schema and profile JSON for mapkeeper hex cells — cell_id format, V0 fields, validation posture. Use when editing schemas/, profile examples, or discussing cell profile fields (roadmap 3.2).
paths	schemas/**, **/profiles/**

Cell profile schema (mapkeeper V0)

Product invariants: README.md#invariants · decided scope: D-12 (maintainer decisions log).

cell_id (canonical)

{world_id}.hex.q{q}.r{r}

Example file: profiles/{world_id}.hex.q3.r-1.json

V0 field guidance (Shape may refine via /idea)

Field	Role
cell_id	canonical key — matches filename stem
display_name	human label for author/GM
slug	optional short id for agents — not primary key
notes	free text stub for V0

Keep schema minimal — writer/GM persona; no dev jargon in author-facing descriptions.

Validation posture (D-23, final for V0)

Save never blocks — neither web UI nor CLI. Empty display_name is a valid state ("painted, unnamed yet"), not a warning. Malformed cell_id stays a defensive Error in CellProfile::validate() (for future hand-edited files / import) but is unreachable via real entry points today — that is expected, not a bug. No format rules for slug/notes. CI schema tests against this file — still open, Later, tracked separately (roadmap 1.2 V0-done criterion), not part of this decision.

Files

• Schema: schemas/ in this repo (layout fixed — D-20 Cargo workspace).
• Rust model: crates/core/src/profile.rs (CellProfile) — schema here is the source of truth; keep the Rust struct in sync.
• World instances: author world repo profiles/ — not in product repo.

Gate

Maintainer edits here only under approved build scope (/real with backing D-* / todo).