# /usercards_rescan — Reconcile & refresh all cards

One-shot maintenance pass that makes the server’s user cards match reality.

## Access

- Moderator-only — requires the Discord permission Manage Server.
- Must be used in a server channel (not DMs). The result is sent ephemerally.

## What it fixes

1. Rules / RoE agreement
   <liReads reactions from your configured Rules and RoE messages.
2. Adds/removes the corresponding roles so roles match the reactions.
3. Nickname claim & reviews
   - If a member has an “accept” reaction on the Nickname message but has no pending/verified record and no open review, it opens a pending nickname review for them.
   - If a member removed their Nickname reaction, it clears any pending/verified state.
4. User cards
   - Updates (or recreates) the embed for each member in the configured “users list” channel.
   - Card color reflects: Rules, RoE, and Nickname status (✅ verified / ✔️ pending / ❌ not done).
   - Uses a stable footer marker (`UID:<id>`) to find/edit the right card; cleans up duplicates.

## Expected output

The command replies (ephemeral) with counts like:

    Reconciled from messages. Changes — Rules: 3, RoE: 2, Nickname (added): 1, Nickname (removed): 0. Refreshed cards for 154 members.

## Setup notes

- Relies on your configured IDs (ENV/INI): Rules/RoE/Nickname message IDs and their role IDs, the Full Access role, the user-cards channel, and the mod/modlog channels.
- Won’t ping anyone; all posts/edits are sent with no mentions.

## Tips

- Run after importing a server, restoring from backup, or after downtime.
- Large servers: this may take a moment while it walks members and edits cards. It’s safe to run again.