💎 Showcase: [Refinement]

.jules/showcase.md

@@ -4,6 +4,7 @@
 - **[2024-05-22]** Initial audit revealed `README.md` was functional but lacked "Curb Appeal". It missed critical link arrays, visual hooks, and a clear documentation map. Refactoring to follow the "Golden Template".
 - **[2024-05-24]** Standardized "Quick Start" on `npm ci` rather than `npm install` for the TS monorepo. This prevents unintended local `package-lock.json` mutations, reducing onboarding friction and unexpected local state issues.
 - **[2026-04-09]** Added `DISCORD_APPLICATION_ID` to Quick Start instructions. Users were encountering a startup crash when trying to run the bot with just `BOT_TOKEN` due to missing required application ID context, causing immediate abandonment.
+- **[2026-07-09]** Updated the README to use `./setup.sh` instead of `npm ci` for installation to avoid missing dependencies like `ffmpeg`, and explicitly direct `.env` creation to `packages/bot/.env` to avoid dotenv loading errors, resolving a common UX onboarding friction.
 
 ## Showcase's Philosophy
 - The README is not documentation; it is a Landing Page.

README.md

@@ -31,16 +31,16 @@ Get up and running in less than 5 minutes.
     ```
 
 2.  **Install Dependencies**
-    This project uses `npm` workspaces.
+    This project uses `npm` workspaces and requires system dependencies.
     ```bash
-    npm ci
+    ./setup.sh
     ```
 
 3.  **Configure Environment**
-    Create a `.env` file in the `packages/bot` directory (or the root directory):
+    Create a `.env` file in the `packages/bot` directory:
     ```bash
-    echo "BOT_TOKEN=your_token_here" > .env
-    echo "DISCORD_APPLICATION_ID=your_app_id" >> .env
+    echo "BOT_TOKEN=your_token_here" > packages/bot/.env
+    echo "DISCORD_APPLICATION_ID=your_app_id" >> packages/bot/.env
     ```
 
 4.  **Run the Bot**

package.json

@@ -9,7 +9,7 @@
     "eslint": "^9.28.0",
     "jiti": "^2.6.1",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.35.0"
+    "typescript-eslint": "^8.63.0"
   },
   "scripts": {
     "lint": "eslint packages/ --max-warnings 0",

packages/shared/src/index.ts

@@ -49,6 +49,8 @@ export type {
   WoWGroupDict,
 } from './types.js';
 
+export type { SeasonPairs } from './seasonPairs.js';
+
 export { CHARACTER_CLASSES, toCharacterClass, toRole, toUtility } from './types.js';
 
 export { todayPST } from './dateHelpers.js';