git:20260912.5c5321c to git:20260913.c7e3fa2

26 added, 5 removed. Audit A to A.

---

name: minimap-pins

- description: Generic minimap. Pins belong to the player. No quest-arrow carpet.

+ description: Use when a minimap needs to present authorized player/system pins, fog, radar or compass information with stable IDs and lifecycle rules. It consumes world/quest/perception truth; it does not author that truth.

---

# Minimap pins

- Ask: off | player-pins | fog-disk | radar-blip.

- Compass and map follow world-map. The system may mark the active quest-graph hook only.

- Radar blips are stealth-info or enemy-ai tells, not a wallhack.

+ Ask: `off | player-pins | fog-disk | radar-blip`.

- Accept: turning the minimap off still leaves world landmarks readable.

+ ## Ownership

+ `world-map`, quests and perception systems decide what information exists and may be revealed. `minimap-pins` owns minimap selection, deduplication, layout and presentation of that authorized information.

+ Each presented item records:

+ - stable `pin_id`

+ - `source_owner` and source entity/quest ID

+ - pin type

+ - visibility predicate/revision

+ - optional expiry/removal reason

+ Player pins, quest pins and threat/radar blips may coexist when the project permits them. There is no universal rule that only one active quest hook may be shown.

+ ## Runtime rules

+ 1. Duplicate updates for the same pin/revision are idempotent.

+ 2. A source becoming invalid removes or hides the pin without mutating source state.

+ 3. Occlusion/fog/stealth policies come from their owner and are not bypassed to create extra information.

+ 4. Localization changes labels, not pin identity.

+ 5. Turning the minimap off removes presentation only.

+ ## Acceptance

+ The same authorized source state yields the same canonical pin set. Stale or unknown source IDs do not become persistent markers, and toggling/minimap layout changes cannot complete quests, reveal source state, or modify travel state.