From b45cdc514f52176a554c7efcca8e08f1700ad599 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Wed, 15 Jul 2026 12:47:50 +0000
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9C=20Scribe:=20Updated=20Technical=20?=
 =?UTF-8?q?ARCHITECTURE.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Added rows to 'Where Key Behaviors Live' to reflect the Season Pair Tracker logic and the Discord.js handler data boundary.
---
 ARCHITECTURE.md              | 2 ++
 packages/shared/src/index.ts | 1 +
 2 files changed, 3 insertions(+)

diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index a4ed7344..8cd6d6de 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -300,6 +300,8 @@ sequenceDiagram
 | Voice → lobby sync | `packages/bot/src/commands/groups.ts` (`onVoiceStateUpdate`) → `SessionService.updateChannelPlayers` |
 | Channel/guild doc create/listen/update | `SessionService` + `FirebaseService` |
 | Group algorithm | `packages/shared/src/parallelGroupCreator.ts` |
+| Season Pair Tracker (Validation & Logic) | `packages/shared/src/seasonPairs.ts` (`parseSeasonPairs`) |
+| Discord.js → Handler Data Boundary | `packages/bot/src/core/discordAdapters.ts` (`adaptGuild`, `buildVoiceChannelsSnapshot`) |
 | “Spin” handling | Frontend: `activity/src/services/firestoreService.ts` (`requestSpin`) — runs the algorithm client-side and writes `spinning`+`groups` |
 | Activity UI and wheel | `activity/src/main.tsx`, `activity/src/views/WheelsView.tsx` |
 | Channel doc cleanup | `packages/bot/src/main.ts` (startup), `SessionService.cleanupChannel` |
diff --git a/packages/shared/src/index.ts b/packages/shared/src/index.ts
index 9937707b..5fe0c325 100644
--- a/packages/shared/src/index.ts
+++ b/packages/shared/src/index.ts
@@ -27,6 +27,7 @@ export {
   topAffinityFor,
   shortestPath,
   parseSeasonPairs,
+  type SeasonPairs,
 } from './seasonPairs.js';
 
 export { generateInviteCommand } from './inviteCommand.js';