Prepare deck_neo for public launch

[mgc26]

Summary

• rebuild the README around installation, compatibility, behavior, and limitations
• add representative product stills and public contribution, security, issue, and pull-request guidance
• add macOS CI for supported Node releases plus monthly dependency updates
• remove two order/timing races from the paging tests
• align the documented Node floor with the installed native image dependency

Why

The repository began as a functional code release, but it lacked the documentation, support boundaries, automation, and community files expected of a public project. Two existing paging tests also depended on timing or ordering that was not part of the product contract.

User impact

Visitors now get a clear explanation of what the Stream Deck integration does, what hardware and software it supports, how to install it, and where current Claude Code and Codex behavior differs. Contributors receive reproducible setup and reporting guidance. CI protects the supported Node 22 and 24 lines.

Validation

• 381/381 tests passed five consecutive times on the final branch state
• fresh-clone install, 381/381 tests, TypeScript build, dependency tree, and audit passed on Node 22.18.0
• fresh-clone install, 381/381 tests, TypeScript build, and audit passed on Node 24.18.1
• actionlint, YAML, plist, shell, and Node syntax checks passed
• gitleaks found no secrets in the seven-commit branch history
• relative documentation links and both 1080×1182 JPEG assets were verified

Notes

The CI badge will begin resolving after GitHub registers the new workflow on the default branch.