Document the Admin and Mod staff levels
Document custom alert messages (#42)
Streamer Alerts and Instagram Alerts gain a "Custom message" section:
the message and clear-message subcommands, the {name}, {title}, {url},
{platform} and {role} placeholders, where the ping goes, and that only
the ping role ever notifies anyone. Commands lists the new subcommands,
Server Configuration mentions them, and the Permissions page's admin
row includes them (no permission changed).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Document Instagram post alerts (#37)
Add an Instagram Alerts page covering the whole host setup: the
professional account and Page link, the Meta app and its permissions,
the business portfolio and System User, generating a token that never
needs renewing, finding the Instagram account ID, and checking it all
works. It records the steps that failed without them during setup
(linking from the Page side, assigning assets before generating the
token, the PowerShell blank-line trap) and why a System User token is
used instead of a Page token.
Also add /instagram to Commands, Server Configuration, Configuration
and Troubleshooting, link it from Home and Streamer Alerts, and note
that /instagram also uses Mention Everyone for unmentionable roles.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Document the YouTube /live page check (#29, PR #31)
Long-running and 24/7 YouTube streams are now found through each
channel's /live page every 15 minutes, so they're no longer a known gap.
- Streamer-Alerts: the timing table notes up to ~15 minutes for streams
found this way; the quota section explains the check (free to read,
~150-200 KB per channel, confirmed through the API with 1 unit, and
only once); Known gaps replaces "long-running streams are missed" with
the remaining caveats: the page isn't an official API, and a 24/7
stream is announced once
- Troubleshooting item 6: give such streams 15 minutes, and they're only
announced the first time they're seen
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Document Twitch and YouTube streamer alerts (#17)
New Streamer-Alerts page covering the whole feature from PR #28:
- host credentials: registering a Confidential Twitch app; creating a
YouTube Data API v3 key restricted to that API (console or gcloud)
- hom.env values, and that a restart is needed for them to take effect
- server setup: the alert channel and ping role, self-linking through
the streamer role, and admins adding channels directly
- what gets announced and what doesn't (back catalogue, scheduled
streams, finished-stream recordings, lost streamer role)
- managing the list, and how self-links and admin adds interact
- API limits and cost: Twitch effectively unlimited; the YouTube
10,000-unit daily quota with rough usage by channel count
- known gaps: long-running YouTube streams can be missed, Shorts are
announced, and live and upload alerts share one channel
- testing with high-volume news channels and a public stream on your own
channel
Also:
- Home: description and page table
- Configuration: the three new variables, and the note that hom.env is
only read at startup
- Commands: now 12 commands, the /streamers reference, and
streamer-role's new purpose
- Server-Configuration: a new step 7 for streamer alerts, and
/streamers list in the verification checklist
- Troubleshooting: "Stream or upload alerts don't post", most common
cause first
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>