feat(Concentration): v1.0.0 Refactor Concentration internals and docs.

[steverobertsuk]

[1.0.0] - 2026-05-23

Added

• Dedicated legacy and Beacon spell-detection paths.
• Support Mode for debug output with two levels:
  • Basic: short support-friendly diagnostics.
  • Detailed: structured diagnostics for troubleshooting.
• Pending roll ID flow for Roll and Advantage buttons.
• Pending roll cleanup for expired entries.
• Guarded CON save modifier lookup helper.
• Documentation set for compatibility and testing:
  • docs/beacon-compatibility.md
  • docs/troubleshooting.md
  • docs/testing-checklist.md

Changed

• Updated script and package versioning to 1.0.0.
• Hardened Beacon matching heuristics for concentration spell cards.
• Improved character resolution using character ID first, then exact-name fallback.
• Preferred represented tokens on the caster's current page before global fallback.
• Refreshed README and metadata for current Roll20/Beacon behavior.
• Refactored API input handling into dedicated parse/dispatch helpers.
• Refactored HP-loss concentration flow into focused reminder/button/tracking helpers.
• Added JSDoc typedefs and function docs for core detection, command, roll, and config flows.

Fixed

• Fixed selected-token manual toggle whisper targeting for character mode.
• Prevented brittle regex indexing assumptions on unmatched spell content.
• Improved marker-change loop protection using tracking keys.
• Added safer marker removal behavior for represented and unlinked tokens.
• Improved handling of missing or expired pending roll IDs.

Security

• Validates API command and config input values before applying state changes.
• Escapes dynamic chat-rendered values to reduce markup injection risk.

Signed-off-by: Steve Roberts steve@shadowcomputers.co.uk