discord-php/DiscordPHP-NHA

async-test-and-doc-sync

Maintain test and documentation alignment — PHPUnit 9 unit tests, opt-in Discord integration tests, async wait helpers, PHPDoc, README, and environment examples. Use when changing public behavior or tests.

helpers-and-infra-keeper

Work with DiscordPHP-NHA infrastructure — HelperTrait, NHA HTTP transport, Endpoint binding, Request URLs, StateStore JSON persistence, ReactPHP promises, and discord-php/http contracts.

repository-cache-keeper

Maintain DiscordPHP-NHA observation caching and JSON state persistence. Use when changing NHA::observe(), cached agent observations, StateStore, or deciding whether a new persistence boundary is warranted.

builder-payload-smith

Maintain DiscordPHP builder usage in DiscordPHP-NHA — message responses, Components V2 observations, application command definitions, validation, and shared payload construction. Use when changing outbound Discord data.

gateway-cache-sync-keeper

Maintain DiscordPHP-NHA's Discord message relay, periodic NHA observation polling, and observation-cache coherence. Use when changing bot.php gateway listeners, relay behavior, or NHA::observe().

interaction-flow-keeper

Maintain DiscordPHP-NHA interaction flow — slash command registration, readiness gates, option dispatch, deferred responses, and component updates. Use when touching slash commands or interaction callbacks.

legacy-command-client-keeper

Maintain the prefix-command layer built on MessageCommandClient — NHA subcommands, aliases, parsing adapters, help metadata, and shared command dispatch. Use when touching message-based command handling.

part-model-maintainer

Maintain the AgentObservation model — read-only NHA payload access, fallback fields, serialization, and Components V2 rendering. Use when changing src/NHA/Parts, while preserving that it is not a Discord Part.

runtime-bootstrap-keeper

Maintain DiscordPHP-NHA runtime bootstrapping, NHA client wiring, startup readiness, observation polling, relay behavior, and process lifecycle. Use when touching NHA.php, bot.php startup, loop wiring, or NHA HTTP setup.

type-map-keeper

Guard polymorphic NHA payload dispatch. DiscordPHP-NHA has no local subtype map today; use when adding discriminator-based payload families or reviewing code that might be mistaken for a type map.

voice-subsystem-keeper

Guard DiscordPHP-NHA's voice dependency boundary. Discord voice transport, encryption, packets, and audio streaming belong to team-reflex/discord-php; use when voice work is proposed or NHA-specific voice behavior is introduced.