Text chat 36: fluxer-proto channel types: forums, media, links, announcements, thread admin #321

Closed
opened 2026-11-12 18:16:18 +00:00 by charles · 0 comments
Owner

Plan: docs/superpowers/plans/2026-11-12-textchat.md, section "Task 36". Spec: §18 of docs/superpowers/specs/2026-11-12-fluxer-native-textchat-design.md (channel types, added 2026-11-12 when Charles overruled #286 Q4).

Issue: (to be created)

Files:

  • Create: crates/fluxer-proto/src/models/forum.rs, crates/fluxer-proto/src/gateway/forum.rs, fixtures fixtures/rest/{channel_forum.json,channel_media.json,channel_link.json,channel_announcement.json,channel_personal_notes.json,thread_private.json,thread_announcement.json,forum_post_created.json,thread_search.json,thread_search_not_ready.json,post_data.json,archived_threads.json,followed_channel.json,crosspost_message.json,crosspost_source.json,purge_notes.json}, fixtures/gateway/{forum_unreads.json,thread_create_forum_post.json,thread_member_list_update.json,lazy_request_threads.json}
  • Modify: crates/fluxer-proto/src/models/{channel.rs,thread.rs,mod.rs}, crates/fluxer-proto/src/gateway/{member_list.rs,opcodes.rs,events.rs,mod.rs}, crates/fluxer-proto/src/{lib.rs,enums.rs}, crates/fluxer-proto/tests/spec_contract.rs, README
  • Test: crates/fluxer-proto/tests/channel_types.rs

Interfaces:

  • Produces: spec §18.3 exactly. Channel.{url: Option<String>, flags: u32, applied_tags: Vec<Snowflake>, member_ids_preview: Vec<Snowflake>, available_tags: Vec<ForumTag>, default_reaction_emoji: Option<DefaultReaction>, default_sort_order: Option<ForumSortOrder>, default_forum_layout: Option<ForumLayout>, default_tag_setting: Option<ForumTagSetting>, default_auto_archive_duration: Option<u32>, default_thread_rate_limit_per_user: Option<u32>} (all serde(default), lenient, skipped when empty so existing fixtures round-trip); ChannelFlags::{PINNED, REQUIRE_TAG, HIDE_MEDIA_DOWNLOAD_OPTIONS}; ForumTag { id, name, moderated, emoji_id, emoji_name } with emoji() -> Option<EmojiRef-like (id, name)>; DefaultReaction { emoji_id, emoji_name } with as_reaction_emoji() -> Option<ReactionEmoji>; ForumSortOrder::{LatestActivity, CreationTime}, ForumLayout::{Default, List, Grid} (wire_enum_u16, Unknown kept), ForumTagSetting::{MatchSome, MatchAll} (string, unknown → MatchSome); StartForumPost, ForumPostMessage, ForumPostCreated; ThreadSearchQuery with to_query() -> Vec<(&'static str, String)> (repeated tag), ThreadSortBy, SortOrder, ThreadSearchResponse::{Results(ThreadSearchResults), NotReady { retry_after_s: f64 }}; PostDataRequest, PostData, PostDataEntry; ArchivedThreadsQuery { before: Option<Timestamp>, limit: u8 }, ArchivedThreads; EditThreadRequest (only set fields serialised); ThreadMemberSettingsPatch; FollowChannelRequest, FollowedChannel; CrosspostSource (shape of S/message/CrosspostSourceSchemas.ts); PurgeResult (shape of api/channel/controllers/MessageController.ts:414-427); GuildSubscription.{threads: Option<bool>, thread_member_lists: Option<Vec<Snowflake>>} (skipped when None; today's frames byte-identical); Opcode::RequestForumUnreads = 28, RequestForumUnreads { guild_id, channel_id, threads: Vec<ForumUnreadRequest> } with into_envelope(); GatewayEvent::{ForumUnreads(ForumUnreads), ThreadMemberListUpdate(ThreadMemberListUpdate)}; ThreadCreate keeps Channel and exposes newly_created through a new Channel.newly_created: bool (serde(default), never serialised); TYPED_DISPATCH_NAMES += FORUM_UNREADS, THREAD_MEMBER_LIST_UPDATE; limit constants `forum::{MAX_TAGS_PER_CHANNEL = 20, MAX_APPLIED_TAGS = 5, TAG_NAME_MAX = 50, FORUM_TOPIC_MAX = 4096, THREAD_SEARCH_LIMIT_MAX = 25, THREAD_SEARCH_OFFSET_MAX = 9975, POST_D

🤖 Generated with Claude Code

Plan: `docs/superpowers/plans/2026-11-12-textchat.md`, section "Task 36". Spec: §18 of `docs/superpowers/specs/2026-11-12-fluxer-native-textchat-design.md` (channel types, added 2026-11-12 when Charles overruled #286 Q4). ### Task 36: `fluxer-proto` channel types: forums, media, links, announcements, thread admin **Issue:** (to be created) **Files:** - Create: `crates/fluxer-proto/src/models/forum.rs`, `crates/fluxer-proto/src/gateway/forum.rs`, fixtures `fixtures/rest/{channel_forum.json,channel_media.json,channel_link.json,channel_announcement.json,channel_personal_notes.json,thread_private.json,thread_announcement.json,forum_post_created.json,thread_search.json,thread_search_not_ready.json,post_data.json,archived_threads.json,followed_channel.json,crosspost_message.json,crosspost_source.json,purge_notes.json}`, `fixtures/gateway/{forum_unreads.json,thread_create_forum_post.json,thread_member_list_update.json,lazy_request_threads.json}` - Modify: `crates/fluxer-proto/src/models/{channel.rs,thread.rs,mod.rs}`, `crates/fluxer-proto/src/gateway/{member_list.rs,opcodes.rs,events.rs,mod.rs}`, `crates/fluxer-proto/src/{lib.rs,enums.rs}`, `crates/fluxer-proto/tests/spec_contract.rs`, README - Test: `crates/fluxer-proto/tests/channel_types.rs` **Interfaces:** - Produces: spec §18.3 exactly. `Channel.{url: Option<String>, flags: u32, applied_tags: Vec<Snowflake>, member_ids_preview: Vec<Snowflake>, available_tags: Vec<ForumTag>, default_reaction_emoji: Option<DefaultReaction>, default_sort_order: Option<ForumSortOrder>, default_forum_layout: Option<ForumLayout>, default_tag_setting: Option<ForumTagSetting>, default_auto_archive_duration: Option<u32>, default_thread_rate_limit_per_user: Option<u32>}` (all `serde(default)`, lenient, skipped when empty so existing fixtures round-trip); `ChannelFlags::{PINNED, REQUIRE_TAG, HIDE_MEDIA_DOWNLOAD_OPTIONS}`; `ForumTag { id, name, moderated, emoji_id, emoji_name }` with `emoji() -> Option<EmojiRef-like (id, name)>`; `DefaultReaction { emoji_id, emoji_name }` with `as_reaction_emoji() -> Option<ReactionEmoji>`; `ForumSortOrder::{LatestActivity, CreationTime}`, `ForumLayout::{Default, List, Grid}` (`wire_enum_u16`, `Unknown` kept), `ForumTagSetting::{MatchSome, MatchAll}` (string, unknown → `MatchSome`); `StartForumPost`, `ForumPostMessage`, `ForumPostCreated`; `ThreadSearchQuery` with `to_query() -> Vec<(&'static str, String)>` (repeated `tag`), `ThreadSortBy`, `SortOrder`, `ThreadSearchResponse::{Results(ThreadSearchResults), NotReady { retry_after_s: f64 }}`; `PostDataRequest`, `PostData`, `PostDataEntry`; `ArchivedThreadsQuery { before: Option<Timestamp>, limit: u8 }`, `ArchivedThreads`; `EditThreadRequest` (only set fields serialised); `ThreadMemberSettingsPatch`; `FollowChannelRequest`, `FollowedChannel`; `CrosspostSource` (shape of `S/message/CrosspostSourceSchemas.ts`); `PurgeResult` (shape of `api/channel/controllers/MessageController.ts:414-427`); `GuildSubscription.{threads: Option<bool>, thread_member_lists: Option<Vec<Snowflake>>}` (skipped when `None`; today's frames byte-identical); `Opcode::RequestForumUnreads = 28`, `RequestForumUnreads { guild_id, channel_id, threads: Vec<ForumUnreadRequest> }` with `into_envelope()`; `GatewayEvent::{ForumUnreads(ForumUnreads), ThreadMemberListUpdate(ThreadMemberListUpdate)}`; `ThreadCreate` keeps `Channel` and exposes `newly_created` through a new `Channel.newly_created: bool` (`serde(default)`, never serialised); `TYPED_DISPATCH_NAMES` += `FORUM_UNREADS`, `THREAD_MEMBER_LIST_UPDATE`; limit constants `forum::{MAX_TAGS_PER_CHANNEL = 20, MAX_APPLIED_TAGS = 5, TAG_NAME_MAX = 50, FORUM_TOPIC_MAX = 4096, THREAD_SEARCH_LIMIT_MAX = 25, THREAD_SEARCH_OFFSET_MAX = 9975, POST_D 🤖 Generated with [Claude Code](https://claude.com/claude-code)
charles added this to the Text chat milestone 2026-11-12 18:16:18 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
charles/fluxer-native#321
No description provided.